BLOG / what-is-sku-md.mdx
SKU.mdとは?エージェント向けに販売者がホストする商品知識
SKU.mdの文書群、Readable・Queryable・Executable Webの役割と、越えてはならない権限の境界を解説します。
SKU.mdは、商品発見と、安定した出典付き商品知識を自動利用者が扱いやすくするために販売者自身がホストする仕組みです。永続的な説明をライブのコマース情報源につなぎますが、それらの情報源を置き換えません。
SKU.md は、販売者が自らホストする商品発見と安定した商品知識のレイヤーです。Agent が商品を見つけ、出典のある事実を理解し、リアルタイムの商取引情報をどこで再確認すべきか把握できるようにします。新しい Checkout プロトコルではありません。
商品知識は複数の場所に分断されている
1つの商品でも、HTML、Product JSON-LD、フィード、説明書、ポリシーページ、サイズ表、ライブCatalog、Checkoutに情報が分かれます。商品名と現在価格だけでは、素材の主張が検査済みか、どのVariantを対象とするか、根拠がいつ見直されたかは分かりません。長い販促ページも、今日の在庫をどの情報源が決定するかは示しません。
SKU.mdは識別、知識、根拠、制約、ライブ検証の入口を小さな文書グラフで示し、すべてを1つの偽の正解に混ぜないようにします。
読み取り・照会・操作は別の層
| 層 | 得意な役割 | 権限の境界 |
|---|---|---|
| 読み取り可能な層 | 安定した説明、根拠、開示、発見 | SKU.mdが参加できる層 |
| 照会可能な層 | 現在のCatalog、価格、在庫、配送見積り | ライブCatalog、API、MCPが回答を所有 |
| 操作可能な層 | Cart、決済、注文、ページ操作 | Checkout、注文システム、UCP、審査済みWebMCP操作が実行を所有 |
商品を発見し、出典付き知識を読み、現在条件を照会し、影響の大きい操作の前に利用者の確認を得る、という循環です。静的知識はこの循環を安全にするもので、ライブ確認を省くものではありません。
v0.10の文書群
v0.10仕様は、ルートCatalog Manifest、任意のPartition Index、Product Documentを定義します。manifest-basicの入口は、ライブ機能を主張せずに識別情報とCatalogリンクを公開できます。Product Documentは知識を安定したProduct・Variantの識別情報に結び付け、オファーがなくても有効です。
任意のoffer_snapshotは過去の観測を記録し、任意のlive_offerは別途宣言したライブ照会先を示します。どちらもMarkdownを拘束力のある見積りには変えません。canonicalとparentリンクは文書間の関係を検査可能にし、公開リソースの検査は意味ではなく配信を証明します。
公開者・実装者・利用者
公開者は商品情報源を審査できる販売者または権限を持つ運用者です。実装者はジェネレーター、バリデーター、プラットフォーム経路、安全な利用者を構築します。利用者には、出典付き商品コンテキストを必要とするエージェント、検索・Catalogツール、アクセシビリティツール、社内システムが含まれます。
| 役割 | 責任ある選択 | 危険な近道 |
|---|---|---|
| 公開者 | 識別、情報源、日付、制約を確認 | 未審査の文章を事実に昇格 |
| 実装者 | 曖昧なら停止し、公開配信を検証 | ローカルでのSchema検証成功を公開完了とみなす |
| 利用者 | 出典を示し、変動情報を再確認 | 古い観測記録を今日の価格として使う |
SKU.mdが与えられないもの
権限の付与、認証、決済承認、履行保証はできず、解析できるだけで主張が真実になることもありません。モデルがクロール、引用、推奨、ランキング、コンバージョンを行う保証もありません。
役割は限定的ですが、実用性があります。販売者は再審査できる安定した商品説明を公開し、残る不確実性をどこで確認すべきか利用者に示せます。
関連資料
隣接形式はllms.txt・agents.md・SKU.mdの比較で、配信手順は最初のSKU.mdを公開するで確認できます。