Growli
ブログ

llms.txt とは何か、そしてどう書くか

Zakaria Reziki

著者 Zakaria Reziki

最高経営責任者 — Growli · 2026年8月15日 · 9 分で読了

Zakaria Reziki が定めた編集基準のもと、AI の支援を受けて執筆し、自動での情報源確認と品質チェックを経て公開しています。

llms.txt は提案されている慣行です。ドメインのルート(example.com/llms.txt)に置く Markdown ファイルで、大規模言語モデルに対して、あなたの最も有用なページの短く精選された地図を、ナビゲーションやスクリプトや定型文をかき分けずに読める形で示します。2024 年 9 月に Answer.AI の Jeremy Howard が提唱し、llmstxt.org に文書化されています。

同時に二つのことが真であり、この話題の記事の多くは最初の一つしか伝えません。ドキュメント、API リファレンス、ナレッジベースを運営していて、エージェントがそれを読むよう頼まれるなら、このファイルは本当に役に立ちます。そしてこれは採用された標準ではありません。Google は検索で使っていないと述べており、llms.txt をページの発見、順位づけ、引用への入力として文書化したアシスタント事業者を、私たちは把握していません。

本ガイドでは、仕様を書かれているとおりに扱い、実例として自社のファイルを示し、robots.txt や構造化データとの関係でこのファイルがどこに位置するかを扱います。二十分ほどをかけ、何が得られるかを理解し、これを AI 可視性の戦略と取り違えないためです。

提案が実際に述べていること

llms.txt が解こうとした問題はクロールではなく文脈です。モデルやエージェントがあなたのサイトを使って問いに答えようとするとき、文脈の窓は限られており、入力は敵対的です。ナビゲーション、クッキーの同意バナー、サイドバー、広告、JavaScript で描画される内容に満ちた HTML ページです。大きなサイトをモデルが推論できるものに変換するのは、情報が落ちるうえに高くつきます。

llms.txt の仕様は、補い合う二つの処方を提案します。第一に、/llms.txt に置く一枚の Markdown ファイルで、精選された索引として働きます。このプロジェクトは何か、重要なページはどれか、優先順に並べたものです。第二に、個々のページのきれいな Markdown 版を予測できる URL で公開すること(/docs/setup のページを /docs/setup.md でも読めるようにする)。索引からリンクを選んだエージェントが、テンプレートではなくテキストを取得できるようにするためです。

何でないかにも注意してください。指示は含まず、許可や禁止の規則もなく、権限も与えません。あなたが差し出す読書リストであり、受け取る側はいつでも無視して構いません。仕様が JSON でも XML でもなく Markdown なのは、想定される受け手が言語モデルだからであり、人間が手で保守できる必要があるからです。

採用の実情はどうなっているのか

llms.txt がいまや順位の要因だと言う人には懐疑的でいてください。Google の John Mueller はこれを昔のキーワード meta タグになぞらえ、Google は検索で使っていないと公に述べています。その報道はSearch Engine Roundtable で読めます。Google 自身のクロールとインデックスのドキュメントにこのファイルへの言及はありません。クローラー制御のために文書化されているのは robots.txt です。

消費側について正直に言えば、主要なアシスタント事業者で、自社のクローラーや取得の層が何を取得し何を引用するかを決めるのに /llms.txt を使うと文書化したところはありません。このファイルが実際に使われているのは逆方向です。開発者が llms.txt の URL をチャットに貼るか、コーディングのエージェントにそれを指し示し、エージェントがリンクをたどるのです。これは実在する使い方で、仕様が想定していた使い方でもあります。

発行側の採用が最も見えやすいのは開発者向けドキュメントです。Mintlify のようなドキュメント基盤が、ホストするサイトのためにこのファイルを自動生成することも一因です。ドキュメントを出しているなら置く理由になりますし、エコシステムが標準化したと考える理由にはなりません。採用がほぼ無料な慣行は、それを消費しているものがあるかどうかをほとんど教えてくれません。

llms.txt の書き方:正確な書式

仕様は文書の順序を正確に定めており、その順序こそが要点です。受け手が推測ではなく単純な Markdown の読み取りで解析できるようにするためです。

唯一必須なのは、サイトまたはプロジェクトの名前を入れた H1 です。それ以降はすべて任意ですが、位置が制約されます。H1 の直後に任意の引用ブロックを置き、以降を理解するのに必要な要点をまとめた短い要約を入れます。次に、見出しを含まない散文や一覧の節を必要なだけ置いて詳細を補います。そのあとに、リンクの一覧を持つ H2 の節を必要なだけ置きます。

リンクの行は、ハイパーリンクとコロンのあとの任意の説明からなる Markdown の箇条書きです。名前、URL、そしていつ読むべきかを述べる一文。この説明は実際に働きます。十五本のリンクのうちどの二本に文脈を使うかをモデルが決める手がかりだからです。宣伝文句ではなく、案内の指示として書いてください。

一つの H2 には特別な意味があります。Optional と題した節です。その下に置いたリンクは、文脈を短くする必要があるときに飛ばして構いません。変更履歴、深い参照資料、なくても答えられるものに使ってください。ドキュメントの全文を連結して置く llms-full.txt という別の慣行はドキュメント基盤で人気ですが、中心の仕様の一部ではありません。おまけとして扱い、内容が現代の文脈の窓に本当に収まるときだけ公開してください。

  • ドメインのルートに /llms.txt として、text/plain か text/markdown で、HTTPS 経由で配信すること。
  • 短く保つこと。精選された十から三十のリンクは、サイトマップの丸写しに勝ります。全 URL が要るなら、すでに XML サイトマップがあります。
  • 区別のつく説明を書くこと。「Growli について詳しく」ではなく「料金プランと上限」。
  • 公開されていて安定したページだけをリンクすること。精選された索引の中の切れたリンクは、索引がないより悪いのです。
  • ドキュメントが毎週変わるなら、手作業ではなくビルドで再生成すること。

ファイル構造の順序

妥当な llms.txt を構成する四つの位置づけられたブロック

  1. H1 のプロジェクト名

    唯一必須の要素。サイトまたはプロジェクトの名前を、一つの H1 として。

  2. 引用ブロックの要約

    任意で、H1 の直後に。以下すべてを理解するのに必要な要点。

  3. 見出しのない詳細

    任意の散文や一覧で背景を補います。このブロックに見出しは置けません。

  4. H2 のリンク節

    各節に [名前](url): 説明 の形の箇条書きを置き、そのページをいつ読むべきかを述べます。

  5. Optional の節

    Optional と題した H2 は、文脈が短いときに受け手が飛ばしてよいリンクを示します。

実例:Growli 自身のファイル

私たちのものは意図して小さくしています。Growli は AI アシスタントが事業をどう言及し推薦するかを測るので、エージェントに必要なページは、製品が何をするか、計測がどう働くか、料金、そして用語を定義している調査記事です。それ以外に席はありません。

ファイルとして読めば、H1 が一つ、引用ブロックの要約が一つ、そして H2 の節が二つで、二つ目が Optional です。以下の各行が、そのファイルの各行です。

  • # Growli
  • > Growli は、ChatGPT、Gemini、Claude、Perplexity、Copilot、Grok といった AI アシスタントが事業をどう言及し、比較し、推薦するかを追跡し、その差分を優先順位づけされた打ち手に変えます。
  • ## Core
  • 仕組み:計測の方法。プロンプトセット、実行の頻度、言及と推薦の採点の仕方。
  • AI 可視性:指標の定義、それを動かすもの、動かさないもの。
  • ## Optional
  • ブログ:アシスタントのふるまい、引用の傾向、計測の方法論に関する調査記事。

robots.txt と構造化データの隣で、どこに位置するのか

この三つのファイルは三つの別々の問いに答えており、それを混同するのが監査で最もよく見る誤りです。

robots.txt は「取得してよいか」に答えます。クローラーのアクセス制御ファイルであり、長く使われてきた文書化された解析のふるまいを持ち、名前を指定した AI クローラーを許可または禁止する場所です。学習やクロールを制限したいなら、それはそこと利用規約で行うことで、llms.txt では決してありません。構造化データは「これは何か」に答えます。JSON-LD で書く Schema.org の語彙により、自分がこの名前の Organization で、これらの製品と価格とレビューを持つと曖昧さなく述べられます。要約されても生き残る種類の機械可読な事実です。llms.txt が答えるのは「まず何を読むべきか」だけであり、すでにあなたを読むと決めた受け手に向けたものです。

労力に対する見返りの順序は、地味ですが一貫しています。まずクロール可能性とサーバー側で描画される内容を直し、次にエンティティ単位の構造化データ、そのあとに llms.txt です。JavaScript なしでは空白になるページへのリンクを並べたファイルは、誰の役にも立ちません。

三つのファイル、三つの仕事

どのファイルがどの問いに答えるか

  • robots.txt — 取得してよいか

    クローラーのアクセス制御。名前を指定した AI クローラーの許可や禁止も含みます。Google Search Central が文書化しています。

  • Schema.org の JSON-LD — これは何か

    組織、製品、価格、レビューを、要約されても生き残る機械可読な事実として述べます。

  • llms.txt — まず何を読むべきか

    すでにあなたを読むと決めた受け手のための、精選された Markdown の索引。権限も指示もありません。

では、公開すべきでしょうか

ドキュメント、API、開発者向け製品、ナレッジベースがあるなら、はい。費用は数分で、人が読める形式ですし、誰かがエージェントに llms.txt の URL を渡すという使い方はすでによくあります。公開し、正確に保ち、次へ進んでください。

地域のサービス業、電子商取引のカタログ、十二ページの宣伝サイトなら、優先する価値はおそらくありません。アシスタントが自分を推薦するかどうかを変えるという証拠はなく、その労力は、アシスタントが実際に読むと分かっているものに使うほうが有益です。JavaScript なしで描画されるページ、明示的な比較と価格の内容、自社サイトと第三者掲載で一貫したエンティティの事実、そして「Y に最適な X」に答えるときモデルが寄りかかるレビューサイトやまとめ記事での露出です。

正直な判定は計測です。アシスタントがどのプロンプトでどれだけあなたの名前を挙げ、そのときどの情報源を引用するかを追ってください。それが私たちのAI 可視性追跡の目的であり、方法は仕組みのページで説明しています。llms.txt を公開してその数字が動くなら、あなたには見えます。動かないなら、二十分を使って本当のことを一つ学んだことになります。

AI がお客様の事業について何を伝えているかを確認

Growli は ChatGPT、Gemini、Claude、Perplexity における AI 回答でのシェアを測定し、あらゆるギャップを優先アクションに変えます。

はじめる

FAQ

いいえ。Google の John Mueller は、Google が検索で llms.txt を使っていないと公に述べ、これを昔のキーワード meta タグになぞらえています。またこのファイルは Google Search Central のクロールとインデックスのドキュメントのどこにも登場しません。Google がクローラーへの指示として文書化しているのは robots.txt です。

主要なアシスタント事業者で、自社のクローラーや取得の仕組みが /llms.txt を発見や順位づけの信号として使うと述べた公開文書はありません。確かに起きているのは手作業とエージェントによる利用です。利用者やコーディングのエージェントがその URL を指し示され、含まれるリンクをたどります。自動的な効果を当て込むのではなく、その用途のために公開してください。

robots.txt はアクセス制御のファイルで、クローラーの解析のふるまいが文書化されています。名前を指定したクローラーに、どのパスを取得してよいか、いけないかを伝えます。llms.txt には指示が一切なく、権限も与えません。どのページが最も有用かを示す、精選された Markdown の読書リストです。AI クローラーの遮断や許可は robots.txt の仕事であり、llms.txt にはできません。

llms-full.txt は、ドキュメント基盤が広めた慣行で、ドキュメントの全文を一つのファイルに連結し、エージェントが一度に読み込めるようにするものです。中心の llms.txt 仕様の一部ではありません。ドキュメントが本当に文脈の窓に収まるときだけ公開してください。そうでなければ、精選された索引ときれいな .md 版のページのほうが役に立ちます。

ドメインのルート、つまり example.com/llms.txt に、HTTPS で、text/plain か text/markdown として配信してください。llmstxt.org の仕様は Markdown を求めており、構造も重要です。サイト名を入れた H1 が一つ、その直下に任意の引用ブロックの要約、任意の見出しなしの散文、そしてリンク一覧を持つ H2 の節が続きます。

役立つという証拠はありませんし、これを AI 可視性の戦術として売る相手には用心すべきです。アシスタントが反応するのは、実際に取得できる内容と、ウェブ全体であなたがどう説明されているかです。サーバー側で描画されるページ、明快な価格と比較の内容、一貫したエンティティの事実、そして第三者による露出です。llms.txt は安価で、自分が招いたエージェントの役に立つから公開し、そのうえで何かが変わったかを計測してください。

週刊ニュースレター

AI 検索成長のための週刊ヒント

Google での発見や AI からの推薦につながる実践的なヒントを受け取っている事業者様にご参加ください。