BLOG / publish-your-first-sku-md.mdx
最初のSKU.mdを公開する:プラットフォーム非依存の正確な手順
情報源の準備、生成、ルートの/sku.mdへの公開、HTTP 200、Markdown MIME、正規URL、オンライン検査までを解説します。
最初のSKU.md公開が完了するのは、受理した文書が宣言済みHTTPS URLから直接配信され、オンライン配信検査にも合格したときです。ローカルで有効なファイルは、まだローカルファイルにすぎません。
SKU.md は、販売者が自らホストする商品発見と安定した商品知識のレイヤーです。Agent が商品を見つけ、出典のある事実を理解し、リアルタイムの商取引情報をどこで再確認すべきか把握できるようにします。新しい Checkout プロトコルではありません。
1. 最小限で正直な情報源を準備する
ストアフロントのオリジン、公開Catalog入口、既定言語と市場、安定した販売者識別、審査担当者が責任を持てる公開情報源を集めます。manifest-basicから始め、フィールドを埋めるためだけにMCPエンドポイント、ライブ照会、識別子、商品Factを作らないでください。
| 入力 | 採用 | 却下または保留 |
|---|---|---|
| 販売者識別 | 安定した公開名とオリジン | 推測した法人情報 |
| Catalog入口 | 既存の同一オリジンのURL | 非公開管理エンドポイント |
| Knowledge | 審査済み記述と情報源 | 販促文の自動昇格 |
| Offer | 時刻付き観測または宣言済み照会 | 期限のない価格約束 |
2. オフラインで生成・検証する
Basicジェネレーターまたはsku.md/0.10-draftを出力する実装を使います。canonical、コンテンツ言語、市場、文書種別を確認し、offline_documentで安全なYAML、Schema、意味の整合性、本文との一致を検査します。
オフライン成功が証明するのは、バイト列が受理可能な文書を形成することだけです。DNS、ルーティング、ステータス、メディア形式、キャッシュ、親文書リンク、公開到達性は証明しません。
3. 正確なルートURLへ公開する
公開者ガイドはルートマニフェストを正確なHTTPS /sku.mdへ置くよう求めます。
- リダイレクトを追わず
https://merchant.example/sku.mdを要求します。 - 301、302、206や汎用成功ページではなく、正確なHTTP 200を必須にします。
- 任意の有効なパラメーターを伴う
Content-Type: text/markdownを必須にします。 - フロントマターの
canonicalが要求URLと一致するか確認します。 - 応答本文を審査・受理済みのバイト列と比較します。
ホスト型HTML表示、CDNアセットのURL、テーマ上の代替表示、リダイレクトは互換表示には使えても、厳密なルート公開ではありません。
4. オンライン検査と文書グラフ検査を行う
各公開文書にpublished_resourceを実行し、ルートからdocument_graphを検査します。正規URL、親文書リンク、コンテンツ言語、リンク先リソースのステータス、メディア形式、解析可能性、深さ制限、失敗動作を確認します。不明な文書パスが200の汎用HTMLフォールバックを返してはいけません。
| 範囲 | 証明すること | 証明しないこと |
|---|---|---|
offline_document |
ローカル構造と意味 | 公開配信 |
published_resource |
1つの正確なオンラインリソース | グラフ全体 |
document_graph |
到達可能な親子契約 | 外部採用やランキング |
5. 発見経路と運用の循環を加える
適切な公開ページまたは文書化した発見面から/sku.mdへリンクします。Sitemap、Product JSON-LD、llms.txt、agents.mdは固有の役割を維持します。受理済みバイトのハッシュを監視し、経路、テーマ、CDN、ドメイン変更後にオンライン検査を再実行します。
Product Document追加時は安定した識別と情報源審査を保ちます。現在の価格、在庫、配送、税、決済、注文はライブCatalogまたはCheckoutへ戻って確認します。
関連資料
配信障害はSchemaは有効でも公開準備未完了で、フィールド分類は安定した知識とライブデータで確認できます。