llms.txt

llms.txt は、ブラウザではなくモデル向けに書かれたサイトのプレーンテキスト形式のインデックスです。タイトル、1行の概要、読む価値のあるページへのリンク一覧で構成されます。Docsbook はすべてのワークスペースに対して llms.txt と llms-full.txt を自動的に生成します。設定も、ビルド手順も、手動で同期しておく必要もありません。

このページでは、Docsbook がこれらのファイルに正確に何を書き込むのかを説明し、さらに、このページが誠実な機械可読の主張を扱っているため、llms.txt の実際の根拠がどの程度強いのかも説明します。後半の要点を短く言えば、公開してかまいませんが、コストはゼロであり、いかなる成果もこれに帰属させないでください。

Docsbook はこれらのファイルをどこで提供しますか？#

ファイル	URL	内容
プラットフォームインデックス	`https://docsbook.io/llms.txt`	Docsbook 自体：この製品の概要、プラン、MCP サーバー、スキルカタログ
プラットフォーム全文	`https://docsbook.io/llms-full.txt`	Docsbook のドキュメントページ本文
ワークスペースインデックス	`https://<your-workspace>/llms.txt`	そのワークスペースで公開されているすべての Markdown ページへのリンク
ワークスペース全文	`https://<your-workspace>/llms-full.txt`	それらすべてのページの完全な Markdown

4 つすべてが text/plain; charset=utf-8 として提供され、認証は必要ありません。アペックスドメインのパス上で公開されているワークスペース（デモもワークスペースであるため、ショーケースデモも含む）には、そのパス上で同じ 2 つのファイルが提供されます。URL で指定された 1 つのプロジェクトだけを対象とするため、クローラーが 1 つの製品のインデックスを取得しても、別の製品のページが渡されることはありません。

すべてのページは、その正規 URL で一覧表示されます。ページの正規 URL がアペックスドメイン上にあるワークスペースは、ミラーサブドメインでは案内されません。そのホストはリダイレクトし、robots.txt 内で Disallow: / に応答するためです。取得しないよう指示されている URL の一覧をクローラーに渡すくらいなら、一覧を渡さないほうがましです。

ワークスペースの llms.txt には、実際には何が含まれますか？#

Markdown は次の順序で構成されます。ワークスペース名または製品名を記した H1、ドキュメントの内容と場所を要約する引用ブロック、接続されたリポジトリごとの H2、そして各 H2 の下に、公開済み Markdown ページごとの [page title](canonical URL) の箇条書きリストが続きます。その後にこのワークスペースについてセクションがあります。これはクローラーではなくエージェント向けに記述された部分です。

## About this workspace
 
- Hosted by: [Docsbook](https://docsbook.io) — AI-native documentation platform
- MCP server (manage this workspace via AI agent): https://docsbook.io/api/mcp/server
- Skills catalog (AI agent instructions for docs tasks): https://docsbook.io/skills
- Last generated: 2026-09-05T09:14:22.104Z
 
> To connect an AI agent to this workspace: `claude mcp add --transport http docsbook https://docsbook.io/api/mcp/server`

知っておく価値のある動作が 3 つあります。

H1 にはアカウントではなく製品名が記載されます。 1 つのリポジトリを対象とするファイルには、そのワークスペースの表示名がタイトルとして付けられます。アカウント全体を対象とするファイルの場合のみ、アカウントのログイン名がタイトルになります。製品とは何かを尋ねられたとき、アシスタントが最初に引用するのは H1 であり、通常、アカウントのログイン名は正しい答えではありません。
空のワークスペースでも有効なファイルが返されます。 H1、公開ドキュメントがまだインデックスされていないことを示す行、およびホームへのリンクが含まれます。空のインデックスは事実ですが、404 は謎です。
取得に失敗したページはスキップされ、致命的なエラーにはなりません。 llms-full.txt はページごとに組み立てられます。到達できないファイルが 1 つあってもエラーが記録され、そのページが除外されるだけで、リクエスト全体が失敗することはありません。

llms-full.txt では、各ページが独自の H2 の下に配置され、正規 URL を示す Source: 行が付加され、YAML フロントマターは除去されます。このソース行により、アシスタントはバンドルではなく、その文の出典となったページを引用できます。

llms.txt と llms-full.txt — エージェントが必要とするのはどちらか？#

llms.txt       — compact index: page titles and links, one line each
llms-full.txt  — the full Markdown body of every page, concatenated

エージェントが全体像を把握するための地図を必要とし、必要に応じてページを取得する場合はインデックスを使用します。1 回のリクエストでナレッジベース全体を取得し、そのためのコンテキストウィンドウがある場合は、完全なファイルを使用します。中間的なケースには、3 つ目の選択肢があります。単一のページは /api/md/<owner>/<repo>/<page path> で生の Markdown として利用でき、ページパスを付けずに同じルートへアクセスすると、リポジトリ内のすべての Markdown ファイルが連結されて返されます。これは、ページメニューの Markdown として表示 項目の背後にあるルートです。

llms.txt は sitemap.xml とどう違いますか？#

両者は異なる質問に答えるものであり、どちらも他方の代わりにはなりません。

	`sitemap.xml`	`llms.txt`
対象	検索エンジンのクローラー	サイトを初めて読み取るモデルやエージェント
形式	XML、URL とメタデータ	Markdown：H1、概要、タイトル付きリンクリスト
意味情報	いいえ — URL とタイムスタンプのみ	はい — プロジェクトの概要と各リンクのタイトル
標準化元	sitemaps.org、検索エンジンがサポート	llmstxt.org、提案仕様
本番環境で利用するもの	検索エンジン、実証済み	以下を参照

Docsbook は両方を生成し、audit_geo は両方をチェックします。

更新頻度はどのくらいですか？#

Docsbookは、リクエストに応じて公開済みページからファイルを再生成し、1時間（Cache-Control: public, s-maxage=3600, stale-while-revalidate=86400）キャッシュします。GitHubにプッシュしたページは、次回の取得から1時間以内に表示されます。ビルド手順も、コミットするファイルも、クォータもありません。エージェントは好きなだけ頻繁に取得できます。

エージェントに表示される内容について、何を変更できますか？#

変更できるのは、次の3つだけです。

ファイルには適切な名前を付けてください。 llms.txt のリンクテキストは、ページのフロントマター title ではなく、ファイルパスから取得されます。api-rate-limits.md は「Api Rate Limits」になります。リポジトリルートの README.md は「Overview」になり、page2.md は「Page2」になります。そのため、どのモデルもそれを選択しません。
ページを公開してください。 デフォルトブランチにコミットされたMarkdownのみが一覧表示されます。下書きとプッシュされていない編集内容は、どちらのファイルにも含まれません。
最初の段落を回答として書いてください。 llms-full.txt は本文をそのまま保持するため、ページの冒頭にある内容がアシスタントが最初に読む内容になります。

llms.txtのエビデンスはどの程度強いのか#

弱いです。Docsbookもそうでないふりはしません。ここでは賛成・反対の両面から、事実をすべて示します。

質問	実際に確認されていること	出典
仕様はありますか？	はい — Jeremy Howardによる提案で、2024年9月3日に公開され、その後改訂されています。現在、このページには「The /llms.txt file, v2」と記載され、2026年8月10日に変更されています。必須なのはH1だけです：「プロジェクトまたはサイト名を記載したH1。これが唯一の必須セクションです」	llmstxt.org
`llms-full.txt` はその仕様に含まれていますか？	いいえ。現在のページと照合しましたが、この文字列は一度も登場しません。これはコミュニティの慣習であり、エージェントから求められるためDocsbookは採用しています	llmstxt.org
Googleは利用していますか？	いいえ。John Muellerは2025年6月17日に「参考までに、現在llms.txtを利用しているAIシステムはありません」と述べています。Google独自のAI機能に関するドキュメントにも、「これらの機能に表示されるために、新しい機械可読ファイル、AIテキストファイル、またはマークアップを作成する必要はありません」とあります	Search Engine Roundtable、Google AI features
OpenAI、Anthropic、Perplexityは読み取っていますか？	どちらとも証明されていません。各社は独自のファイルを公開しています — developers.openai.com/llms.txt と docs.perplexity.ai/llms.txt はどちらも `200 text/plain` と回答します — しかし、ファイルを公開することと、それを読み取ることは別です。また、3社のいずれのクローラー向けドキュメントにも、あなたのファイルを取得することは記載されていません	OpenAI bots、Perplexity bots
実際にリクエストされていますか？	Ahrefsが137,000のドメインを調査した結果、28%が有効な `llms.txt` を公開しており、そのうち「2026年5月には97%が一度もリクエストを受けていませんでした」	Ahrefs、2026年6月15日更新
設置すると引用が増えますか？	増えることを示す、公開済みで再現された研究はありません	—

それでもこのファイルから得られるもの。 URLを渡したエージェント — プロンプト、MCPクライアント、サポートワークフローなどで — は、クロールする代わりに、1回の取得でドキュメント全体の最新の構成を把握できます。MCPサーバーとスキルカタログも、そこから発見できます。差分を確認できるため、実際に公開されているものの安価なインベントリになります。しかも、Docsbookが生成するため、費用はかかりません。

そこから得られないもの。 アシスタント経由のトラフィックに関するあらゆる主張です。アシスタントがドキュメントを読んでいるか知りたいなら、痕跡を残すものを測定してください。つまり、アシスタントのユーザーエージェントからのクローラーアクセスと、アシスタントのドメインからの参照トラフィックです。どちらもアナリティクスで確認できます。URL上にファイルがあること自体は、それだけでは何の証拠にもなりません。

制限と未解決の疑問#

リンクテキストはフロントマターの title を無視します。 フロントマターで「Rate limits and quotas」というタイトルのページは、ファイル名がそうなっている場合、「Api Rate Limits」として一覧表示されます。ファイル名を変更するか、生成されたタイトルを受け入れてください。
llms-full.txt にはサイズ上限がありません。 大規模なワークスペースでは、エージェントのコンテキストウィンドウを超える可能性のあるファイルが生成されます。ページネーションも切り捨てもありません。数十ページを超える場合は、llms.txt とページごとの取得を優先してください。
Docsbook は仕様で定められた .md ページのバリエーションを提供しません。 提案では、「元のページと同じ URL に、.md を付加した、それらのページのクリーンな Markdown 版」を要求しています。代わりに Docsbook は /api/md/… で生の Markdown を提供します。これは別のアドレスにある同じコンテンツであり、仕様に準拠するクライアントが確認するものではありません。
1時間のキャッシュは設定できず、ファイルの内容も設定できません。これは意図的なものです — 同期がずれてしまう可能性のある、ドキュメントの2つ目の機械可読コピーは存在しません — しかしそのため、エージェントに表示される内容を編集することはできません。
疑問点：これらの情報は、本当に重要なアシスタントによって読み取られているのでしょうか？ ベンダーのボットに関するドキュメントでは、ページを取得するクローラーについて説明されていますが、llms.txt を取得することについては何も説明されていません。ベンダーが利用方法を文書化するか、上記の Ahrefs の測定結果と矛盾するサーバーログの証拠が公開されるまでは、このファイルをチャネルではなく、無料で行える衛生管理とみなしてください。

GEO — ページレベルのシグナル：TL;DRブロック、表示日付、著者表記。
引用シグナル — 取得した文章が引用されるかどうかを決める執筆ルール。
SEO — サイトマップ、正規URL、noindex。
MCPサーバー — 読み取りだけでなく、書き込みも行うエージェント向けのマシンサーフェス。
信頼できる唯一の情報源 — リポジトリがディスク上にあるエージェント向けのローカルドキュメントグラフ。