Shopify ストアの llms.txt に何を書くか

30 秒で分かる結論：Shopify が llms.txt を配信するので、書くのは店固有の部分だけ

2026 年 9 月時点で、Shopify ストアの /llms.txt は /agents.md の写しです。/agents.md は Shopify が全ストアに対して生成・管理しているファイルで、AI エージェントに向けて Universal Commerce Protocol（UCP）の 発見エンドポイント、検索からカート作成、決済までの手順、 認証なしで読める URL のパターンを説明しています。公開済みの ポリシーページへのリンクがあり、最後は Shopify 自身の紹介で 終わります。

書かれていないのは、店の説明です。何を誰に売っているか、 主要なコレクションはどれか、送料はいくらか、返品は何日以内か。 これらは買う前に人が AI アシスタントに尋ねる質問そのもので、 今はアシスタントがたまたま辿り着いた商品ページを読んで 答えています。

直し方はテンプレート 1 枚です。templates/llms.txt.liquid を作り、プロトコルの部分は Shopify が Liquid 変数として 渡してくれる値で残しつつ、店の短い説明を足します。 位置づけを 1 段落、コレクションへのリンクを 5〜15 本（1 本ずつ 一言添える）、送料と返品の要点を文章で、サイズ表とサポート ページへのリンク。それだけです。

デフォルトの中身（2026 年 9 月時点）

下の表は 2026 年 9 月 25 日に稼働中のストアで実際に配信されて いたファイルをもとにしています。自分の店のものも、ドメインが 置き換わった同じ構成になっているはずです。

デフォルトは「購入エージェントに安全に取引させる」という役割は よく果たしています。Shopify のドキュメントも、ほとんどの店では 管理ファイルで十分だと書いています。取引という意味では そのとおりで、店を正しく説明してもらうという意味では 足りません。

カスタマイズの仕組みを 5 点で

1. テンプレートは 3 つ、フォールバックは 1 本。 templates/agents.md.liquid は /agents.md を担当し、他 2 つのパスの フォールバックにもなります。templates/llms.txt.liquid は /llms.txt だけ、templates/llms-full.txt.liquid は /llms-full.txt だけを担当します。テンプレートの ないパスは agents.md.liquid、それもなければ Shopify 生成のデフォルトに落ちます。
2. プレーンテキストか Markdown、Liquid 可。 JSON テンプレートにはできません。書いた内容は text/markdown として配信されます。
3. Liquid は制限付き。使えるのは request と agents だけです。agents からは store_name、store_url、ucp_discovery_url、mcp_endpoint_url、ucp_versions、currency、sitemap_url が取れます。collections や pages はループできません。 キャッシュしやすく、手で書く前提のファイルです。
4. 追記ではなく置き換え。llms.txt.liquid を置いた時点で、そのパスの デフォルト内容は消えます。エージェントにプロトコルの エンドポイントを見つけさせ続けたいなら、上の変数で書き戻します。
5. サイズとキャッシュ。Liquid ファイルの上限は 256 KB です。また Shopify は「このファイルは広くキャッシュされ あらゆるエージェントに配られる」ので個人の連絡先を書かない よう注意しています。良いファイルは数 KB に収まります。

足す価値のある 6 項目

1. 何の店かを 1 段落で

H1 直下の引用ブロック、つまり llms.txt の仕様が要約のために 確保している位置に書きます。何を、誰に、どこから、どの通貨と 言語で売っているか。「京都で作る手作りの陶器の食器。日本から 全世界へ発送、価格は日本円」という一文で、アシスタントが 推測するしかなかった 4 つの疑問が消えます。

2. 主要コレクションを一言添えて

/collections/<handle> へのリンクを 5〜15 本、 人に店を説明するときの順番で並べます。1 本ごとに「何が入って いて、どんな買い手向けか」を一行。「新着」のような自動 コレクションは、実際にお客さんがそこから買っているのでなければ 省きます。個別の商品は載せません。コレクションページと サイトマップがすでに持っています。

3. 送料と返品を文章で

多くの店が間違えるところです。リンクで済ませてしまいます。 Shopify のデフォルト robots.txt はすべての User-Agent に対して /policies/ を Disallow しているので、robots.txt に 従うクローラーは返金ポリシーも配送ポリシーも読みに来ません。 配送地域、標準的な到着日数、送料無料の条件、返品期限、返送料の 負担を 2〜3 文でファイルの中に書き、全文は /pages/ 配下の通常ページに置いてリンクします。 特定商取引法に基づく表記も、ポリシーとして登録しているなら 同じ理由で要点を本文に書いておく価値があります。

4. 選び方：サイズ・互換性・お手入れ

どの店にも「注文前に読んでほしかった」ページがあります。 サイズ表、対応機種の一覧、素材やお手入れの説明。それらを 「どの質問に答えるページか」を添えてリンクします。「これは 合いますか」「うちの機種で使えますか」と聞かれたとき、 アシスタントが引用するのはこのページです。

5. サポートと FAQ

よくある質問、お問い合わせ、配送状況の確認、予約販売や定期 購入をやっているならその説明ページ。質問に答えるページに 絞ります。「私たちについて」は、買い手が知る必要のあることが 書いてある場合だけ入れます。

6. 残りは短い Optional に

ブログ、卸売や法人向けページ、メディア掲載、採用。## Optional の下に置き、読む余裕の少ない側が その手前で止まれるようにします。

完成例

架空の店の templates/llms.txt.liquid の全文です。 最初と最後のブロックは agents オブジェクトで デフォルトのプロトコル情報を残し、その間があなたにしか 書けない部分です。

# {{ agents.store_name }}

> 京都の工房で作る手作りの陶器の食器。日本から全世界へ発送し、価格は {{ agents.currency }} 表示です。このファイルは AI アシスタント向けの案内で、エージェント向けのプロトコル説明は {{ agents.store_url }}/agents.md にあります。

## コレクション

- [皿](/collections/plates): 18〜27 cm。食洗機対応。1 枚または 4 枚セット。
- [鉢・碗](/collections/bowls): 飯碗、麺鉢、盛鉢。初めての方に一番選ばれています。
- [茶器](/collections/tea): 急須、湯呑、揃いの盆。ギフト箱に対応。
- [アウトレット](/collections/seconds): 見た目に難のある品。30〜50% 引き、返品不可。

## 配送と返品

配送先は日本、米国、カナダ、EU、英国、オーストラリア、シンガポールです。ご注文から 3 営業日以内に発送し、海外は国際宅配便で 5〜10 日で届きます。送料は国内 8,000 円以上、海外 25,000 円以上で無料です。未使用品は到着後 30 日以内に返品でき、返送料はお客様負担です（破損・誤配送は当店負担）。アウトレット品は返品不可です。

- [配送について](/pages/shipping): 地域別の送料、関税、追跡。
- [返品と破損](/pages/returns): 割れて届いた場合の連絡方法。

## 選び方とお手入れ

- [サイズガイド](/pages/size-guide): 皿と碗の寸法。一般的な洋食器との比較写真つき。
- [お手入れ](/pages/care): 釉薬ごとの食洗機・電子レンジ・オーブンの可否。

## サポート

- [よくある質問](/pages/faq): ギフト包装、別注の納期、卸売の最低数量。
- [お問い合わせ](/pages/contact): 対応時間と返信の目安。

## コマースエージェント向け

- UCP discovery: {{ agents.ucp_discovery_url }}
- MCP endpoint: {{ agents.mcp_endpoint_url }}
- Sitemap: {{ agents.sitemap_url }}
- Product JSON: {{ agents.store_url }}/products/{handle}.json

## Optional

- [工房日誌](/blogs/journal): 制作の記録と釉薬の試作。
- [卸売](/pages/wholesale): 店舗・飲食店の方へ。

2 点だけ補足します。配送の段落がリンクではなく文章なのは、/policies/shipping-policy へのリンクだと大半の クローラーに読まれないからです。コレクションの一覧が短く 偏っているのは意図的で、「傷ものの安い品はありますか」は 実際にある質問なのでアウトレットを載せ、自動生成の「新着」は 載せていません。

デフォルトより悪くする 2 つのやり方

プロトコルの部分を消す。テンプレートに店の 説明しか書かないと、デフォルトを頼りに UCP の発見 URL と MCP エンドポイントを見つけていたエージェントがそれを失います。 「コマースエージェント向け」のブロックを残すか、店の説明を agents.md.liquid のほうに書いて 3 つのパスすべてに 両方を載せるかのどちらかにします。

カタログを貼り付ける。全商品の名前と価格と 在庫を llms.txt に書き出すアプリがあります。それはフィードで あって、価格が変わった瞬間に古くなりますが、ファイルのほうは キャッシュされて長く配られます。価格と在庫は商品 JSON と Shopify Catalog に任せ、llms.txt にはカテゴリとルールを書きます。

確認の仕方

テンプレートを保存したら、ブラウザではなく素の HTTP クライアントで取得して、クローラーが見るものをそのまま見ます。

curl -sL https://自分のストア/llms.txt | head -20
curl -sI https://自分のストア/llms.txt | grep -i content-type
curl -s https://自分のストア/robots.txt | grep -i policies

1 つ目で H1 と引用ブロックが出ること、2 つ目で text/markdown が返ること、3 つ目で Disallow: /policies/ の行が見えること（送料を本文に 書いた理由です）を確認します。そのあとバリデータに通して、 H1 の欠落、絶対 URL のつもりで相対パスになっているリンク、 うっかり H1 になっている見出しを拾います。

よくある質問