Shopify と SKU.md：AI ショッピングにブランド自身の商品知識を加える

ウールのセーターを毎日着て、洗濯機で洗ってもよいか。買い物客からそう聞かれたとします。商品ページには繊維の混率、別のページには手洗いの方法が載っていて、サポート担当者は毛玉ができやすい着方を知っています。ブランドには答える材料がありますが、一つの質問に沿ってまとまってはいません。

買い物の会話では、商品名や価格から、暮らし方や気候、手持ちの道具との相性へと質問が広がります。ブランドが補えるのは、自分たちがよく知る設計の意図や使い方、そして使える範囲です。Shopify のストアで SKU.md を考えるときも、ここから始めると用途が見えてきます。

Shopify の AI 販売チャネルを土台にする

Shopify の Agentic Storefronts は、条件を満たした商品を対応する AI チャネルに届けます。利用できる機能は地域、ストアの資格、チャネルによって異なり、ある場所でできる購入体験が別の場所でも使えるとは限りません。Shopify Catalog の要件も、商品データを正確に整えるための確認先になります。

最初に見直したいのは、普段使っている商品情報です。曖昧な名前、記載のない素材、宣伝文句の中に埋もれた仕様は、どこに表示されても商品を理解しにくくします。別の文書を増やす前に、Shopify 内のデータと公開ページを直す意味があります。

Shopify は agents.md の情報も標準で管理します。その内容は原則として維持します。SKU.md はカタログの入口と出典付きの商品知識を公開する、独立した実験的提案 1.0.0-beta です。Shopify のチャネルや管理文書の存在は、SKU.md を採用したという意味ではありません。

ブランドが説明できるのは使い方の条件

仕様は「どんな商品か」を説明します。買い物客が知りたいのは「自分の使い方に合うか」であることも多いでしょう。ウールの割合だけでは洗濯方法はわからず、「毎日使える」という言葉では手入れの注意点を伝えきれません。商品知識は、その答えを裏付ける公開ページと結び付けられます。

手入れの説明から「敏感肌の人なら誰でも使える」「毛玉ができない」と広げることはできません。素材、耐久性、互換性の説明では、条件を落とすだけで出典が支えていない約束になってしまいます。

商品の担当者が事実を確かめ、編集担当者が読みやすくする。両者が同じ公開資料を参照できるようにします。任意で追加する商品知識文書では、事実や使用上の説明ごとに Source リンクが必要です。後から修正する際にも、読者が自分で確認する際にも役立ちます。

公開された出典は、サポート、販売店、コンテンツ制作の協力先が共通で確認できる場所にもなります。相手は自分の媒体に合わせて紹介を組み立て、手入れの条件を確かめるときに元のページへ戻れます。文書を利用するかどうかは、それぞれのチャネルの読み取り方法によります。

小さなカタログから資料を整理する

最初から全商品を対象にする必要はありません。現行仕様の最小カタログは、ブランド、サイト、商品一覧への入口を示します。公開資料が十分にそろった商品があれば、Product knowledge から任意の商品知識文書を一つ追加できます。

繰り返し質問を受け、商品ページや手入れの説明が比較的充実している商品を選びます。質問を一つずつ資料に照らし合わせ、二つのページが食い違っていれば、商品担当者に確認して公開ページから直します。ファイル形式が社内の事実確認を代行するわけではありません。

比較的変わりにくい仕様、用途、制限はこの整理に向いています。価格、在庫、配送、税、注文状況は Shopify の現在のシステムに残し、カートや決済も従来の流れを使います。商品知識は用途を説明できますが、作成した日の在庫を長期の供給約束に変えるものではありません。

接続方法は現在のストアで選ぶ

すでに Hydrogen や独自のストアフロントを使っているなら、ホスティング担当者に同じオリジンで /sku.md を配信できるか確認します。最小カタログを生成し、公開する担当者を決め、Markdown として配信して公開 URL 検証ツールで実際の応答を調べます。直接 200 を返す方法を勧めますが、仕様は検査済みの安全なリダイレクトを最大 3 回まで認めています。最終的なカタログ URL はルートの要件を満たす必要があります。

Shopify のホスト型テーマだけを使う場合は、まず標準の商品データや説明ページを改善できます。このファイルのためだけにストアを移行する必要はありません。agents.md.liquid は決められたテンプレートであり、任意のルートファイルを追加できる機能ではありません。App Proxy の接頭辞も a、apps、community、tools に限られます。

Shopify のプラットフォームガイドを担当チームとの確認に使えます。実験のために非対応のプロキシを前段へ置くことは勧めません。ドメインの公式説明では、Cloudflare Proxy と O2O はホスト型ストアのサポート対象外とされています。

商品の変更と一緒に知識も更新する

試した後は、出典を見つけやすくなったか、古い説明を直せたか、複数のページを探していた質問に答えられるかを確認します。素材や手入れ方法が変わったら、商品ページと知識文書を両方見直します。こうした編集作業を続けられるかが、ファイル数より有用な判断材料になります。

Google の AI 検索に関する説明では、特別な AI Markdown ファイルは Google の検索での表示や順位にプラスにもマイナスにもならないとされています。閲覧できる通常のページ、正確な内容、従来の SEO は引き続き重要です。SKU.md を公開したことだけで、モデルによる読み取りが確認されたことにはなりません。

別の運用環境については、WooCommerce の商品知識と BigCommerce のマルチチャネルの視点も参照できます。現在のストアに公開条件がそろっていれば、Shopify 用ジェネレーターを開き、ブランドのカタログから始めてください。