本文へ移動
SKU.md
メニュー
日本語

BIGCOMMERCE · SKU-MD v1.0.0-beta

最小ルートを先に公開し、必要な場合だけ出典付き知識を追加する

公開ストアフロントまたはカタログ、あるいは 1 つの公開商品ページを入力します。最小ルート文書を先に生成し、その後に任意の Source 付き商品ナレッジ文書を追加できます。

BigCommerceジェネレーターを開く

認証情報なし · 非公開 API なし · 一括クロールなし · 自動公開なし

BigCommerceはライブコマースを実行します。 SKU-MDにはレビュー済みの知識が含まれています

この統合により、動的なトランザクションと永続的な製品知識が、実際にサポートできるシステムに保持されます。

BIGCOMMERCE

ライブコマースの正規情報源

現在の製品、バリエーション、チャネル価格設定、在庫、買い物客、カート、注文、チェックアウト動作を所有します。

SKU-MD

最小公開文書の契約

/sku.md に v1 ルートを公開し、必要な場合だけ任意の Source 付き商品ナレッジ文書を 1 つ追加します。

現在のジェネレータは公的証拠のみを使用します

このフローは公開入力とローカルで生成したファイルだけを使用します。

  1. 01

    公開 URL を入力する

    公開ストアフロントまたはカタログ、あるいは 1 つの公開商品ページを指定します。

  2. 02

    最小ルートを生成する

    任意文書を追加する前に v1 ルートを作成して検証します。

  3. 03

    出典がある知識だけを追加する

    明示的に入力した商品ページから、任意の Source 付き商品ナレッジ文書を 1 つ作成できます。

  4. 04

    公開して検証する

    /sku.md を公開し、document、published、graph の各スコープを検証します。

BigCommerce機能はライフサイクルのさまざまな部分を解決します

これらは文書化されたBigCommerceサーフェスです。それらをリストしても、現在のパブリック ジェネレーターがそれらを呼び出すわけではありません。

パブリック

ストアフロント、カタログ、商品ページ

現在のジェネレーターは入力された公開 URL だけを読み取り、他の商品を推測せず、カタログをクロールしません。

ストアフロント

GraphQL Storefront API

表示されている製品、バリエーション、価格、店頭メタフィールド、ルート、コンテンツをクエリします。リクエストには適切なベアラーtokenが必要です。現在のジェネレーターは何も受け入れません。

管理

REST Management API

承認されたAPIアカウントは、範囲指定された資格情報を使用してカタログを管理し、データを保存できます。これは将来のサーバー側同期入力であり、パブリック ブラウザー ソースではありません。

認証

APIアカウントとOAuth

ストアレベルおよびアプリレベルのアカウントは、tokenおよびOAuthスコープへのアクセスを保持します。シークレットはサーバー側に残り、最小限の権限が必要です。

イベント

Webhooks

HTTPS、Pub/Sub、またはEventBridge配信により、増分更新をトリガーできます。受信者は依然として認証、冪等性、再試行処理、および調整を必要とします。

ストアフロントUI

Scripts API

承認されたアプリは、チャネル対応のストアフロント スクリプトを追加できます。スクリプトは検出リンクをアナウンスできますが、クライアント側のコードは要求されたMarkdown応答ではありません。

配達

Stencilおよびheadlessのストアフロント

Stencilカスタム テンプレートは、既存のページ タイプに割り当てられます。販売者が制御するheadlessまたはエッジ層は、正確なsame-originドキュメント ルートを実装できます。

レビューされた公式ソースには、BigCommerceのSKU-MDの採用について文書化されていません。プラットフォーム機能、互換性のある検出、厳密な適合性、およびライブ権限は、依然として別個の主張のままです。

証明できる回答で配送を選択してください

生成されるマークダウンはどのモードでも同じです。デプロイされたルートのみが、パブリケーションに互換性があるか厳密であるかを決定します。

発見

Stencilのストアフロント

テーマ、既存のコンテンツ ページ、またはアプリ管理のスクリプトを通じて、表示されるリンクまたはマシンで検出可能なリンクを追加します。

Stencilテンプレートは、既存のストアフロント ページ タイプをレンダリングします。 Scripts APIはスクリプトをインストールします。どちらも単独ではルートパスtext/markdown応答を証明しません。

厳しい候補者

販売者が制御するheadlessルート

canonicalおよびparentリンクを同じオリジンに維持しながら、ストアフロント アプリケーションから不変の事前検証済みファイルを提供します。

正確なHTTP 200、Content-Type: text/markdown、バイトID、有効なドキュメント グラフ、予測可能なキャッシュ置換、および正確な不明ファイル404が必要です。

厳しい候補者

同一起点エッジルート

リクエストがホストされているストアフロントに到達する前に、/sku.mdに保存されているドキュメントと製品ドキュメントのパスを提供します。

ルーティング ルールは証拠ではありません。パブリケーションを変更するたびに、実際の応答を検証します。

モード何ができるのか証拠の境界線
Stencilテーマ、カスタム ページ、またはScripts API統合を使用して、検出ガイダンスを公開します。互換性のある検出のみ。文書化されたサーフェスは、任意のルートパスのマークダウン応答を確立しません。
headlessストアオリジン上の販売者が制御する店頭アプリケーションから承認されたファイルを提供します。正確なルート、メディア タイプ、バイト、グラフ、キャッシュ置換、および404動作が通過した後でのみ厳密です。
エッジホストされているストアフロントの前のsame-originドキュメント パスをインターセプトし、格納されている受け入れられたバイトを返します。公開応答が構成とは別に検証された後にのみ厳格になります。

v1 文書ファミリーを最小に保つ

専用ジェネレーターは汎用フローと同じ v1 ビルダーと検証器を使用します。

最小ルートを優先

公開ストアの識別情報とカタログ入口を使って v1 ルートを作成します。

任意の商品文書は 1 つ

ユーザーが明示的に入力した 1 つの公開商品ページにだけ商品知識を追加します。

Source 付きファクト

各ファクトは公開 Source にリンクし、graph 検証器が文書関係を確認します。

保守的な範囲

使用できる出典付き商品知識がない場合は、有効なルートを残し、任意文書を作成しません。

すべての公開スコープを検証する

作成と公開は別の手順なので、スコープごとに証拠が必要です。

  1. document

    生成バイトを検証する

    公開前に現在の v1 文書検証器を実行します。

  2. published

    公開応答を検証する

    実際の /sku.md の状態、MIME タイプ、バイトを確認します。

  3. graph

    関係を検証する

    参照されるすべての文書と Source の関係を確認します。

  4. 再実行

    変更後に再検証する

    公開ファイルが変わるたびに全スコープを再実行します。

現在のフローは BigCommerce アカウントに接続せず、ファイルを自動公開しません。

現在のリリースの権限と制限

パブリック ワークフローは依然として狭く、検査可能で、販売者によって制御されます。

  • BigCommerceログイン、APIアカウント、OAuthフロー、アクセスtoken、ストアフロントtoken、またはプライベートtokenはありません。
  • REST Management APIまたはGraphQL Storefront APIリクエストやカタログ クロールはありません。
  • 注文、顧客、カート、チェックアウト、支払い、またはプライベートな製品へのアクセスはありません。
  • Webhookサブスクリプション、バックグラウンド同期、テーマ編集、スクリプトのインストール、自動更新はありません。
  • DNS、プロキシ、エッジ、キャッシュ、実稼働パブリケーションの変更はありません。
  • BigCommerceの承認、パートナーシップ、公式SKU-MDサポート、または採用特典については主張しません。

ブランドの視点から

SKU.md がプラットフォームに補えることと、一つの商品から試す方法を紹介します。

BigCommerce と SKU.md の連携

2026-08-07でレビューされた公式ソース

BigCommerce機能ステートメントはdocs.bigcommerce.comから取得されます。 SKU-MD配信要件は、独立した検証ルールとして個別にラベル付けされます。

BigCommerce統合に関するよくある質問

ジェネレーターはBigCommerceアカウントに接続しますか？

いいえ。パブリックHTMLと1つの明示的なsame-origin製品ページを読み取ります。ログイン、token、OAuthフロー、またはBigCommerce API接続はありません。

GraphQL Storefront APIを直接呼び出してみてはいかがでしょうか？

BigCommerceには、適切なベアラーtokenが必要です。パブリック ジェネレーターは意図的に資格情報を受け入れず、プライベートtokenをプロキシしません。

Stencilは /sku.mdを直接公開できますか？

レビューされたカスタム テンプレートのドキュメントでは、既存のブランド、カテゴリ、製品、ページ タイプがカバーされています。任意のルートパスのマークダウン応答は確立されません。

Scripts APIはファイルを公開できますか？

Scripts APIは、クライアント側のストアフロント スクリプトをインストールします。スクリプトは検出リンクをアナウンスできますが、それは要求されたHTTP 200 text/markdownドキュメント応答ではありません。

headlessストアフロントでは何ができますか？

マーチャント制御のheadlessアプリケーションはルートを実装できますが、厳密な配信は、実際のsame-origin応答がステータス、MIME、バイト、グラフ、キャッシュ、および404チェックを通過した後にのみ存在します。

ジェネレーターは最初に何を作成しますか？

常に最小 v1 ルートを先に作成します。Source 付き商品ナレッジ文書は任意です。

商品ナレッジ文書はライブカタログを置き換えますか？

いいえ。明示的な Source 付きファクトだけを含み、ライブ価格や在庫状態は持ちません。カート、チェックアウト、支払い、注文は BigCommerce が管理します。

BigCommerceはSKU-MDを正式にサポートしていますか？

レビュー済みの公式情報源はそのように述べていません。この独立したガイドは、文書化されたBigCommerce機能を販売者が制御するワークフローにマッピングします。 SKU-MDのBigCommerceの正式な採用については文書化されていません。

公的証拠から始めて、検証できるものだけを公開する

認証情報なしでレビュー可能なドラフトを作成します。検出にはStencilを使用し、検証可能なマークダウン配信にはマーチャント制御のheadlessまたはエッジ ルートを使用します。

BigCommerceジェネレーターを開く