ドメイン向けllms.txt：どのAIエージェントでも読めるAPI

APIを備えたすべてのレジストラには、どこかにドキュメントがあります。ドキュメントサイトやリファレンスページ、場合によってはログインの向こうにあるOpenAPI仕様です。これで二十年間は十分でした。読者は人間の開発者であり、画面をたどり、ナビゲーション部分を読み飛ばして、必要な一段落を見つけられたからです。しかし、推論時に同じサイトを読むAIエージェントには、そんな余裕はありません。コンテキストの予算は限られ、JavaScriptで描画されるドキュメントポータルを待つこともできず、APIの機能を一度で理解できなければ、諦めるか、存在しないエンドポイントを作り出してしまいます。

llms.txtはこの問題を解決する仕組みで、Namefiはnamefi.io/llms.txtで公開しています。この記事では、この規約とは何か、なぜ存在するのか、Namefiのファイルに何が含まれるのかをセクションごとに説明し、意図的に対象外としている範囲と、Model Context Protocol（MCP）と競合するのではなく共存する方法を解説します。また設計どおり、説明対象そのものの実例にもなっています。公開APIの提供者が、自社の機械可読ディスカバリーファイルを平易な文章で説明する記事です。

エージェントがドキュメントサイトをそのままクロールできない理由

llms.txtの根拠は憶測ではなく、提案書に直接記されています。Jeremy Howardによる最初の解説は、提案のきっかけとなった制約から始まります。「大規模言語モデルはウェブサイトの情報にますます依存していますが、重大な制約があります。コンテキストウィンドウが小さすぎて、ほとんどのウェブサイトを全体として扱えません。ナビゲーション、広告、JavaScriptを含む複雑なHTMLページをLLM向けのプレーンテキストに変換することは、困難であるうえに不正確です。」

これは二つの問題が重なっています。実際のドキュメントサイトには、ナビゲーション、変更履歴、マーケティング文、Cookieバナーがあり、エージェントが一つの作業に必要とする数段落に比べれば、その大半はノイズです。しかも、その多くはヘッドレスな取得処理では実行されないJavaScriptの背後にあるため、エージェントのHTTPクライアントが見る内容は、人間が見るページとさえ一致しません。llms.txtはその両方を回避します。クロールして削るのではなく、全体を読むために作られた単一のプレーンテキストMarkdownファイルです。

robots.txtとの類似点と、異なる点

ウェブ基盤に詳しい人にとって、robots.txtとの比較はllms.txtを理解する最も速い方法であり、一定の範囲では妥当です。robots.txtはウェブクローラーに指示を与えるために存在します。サイト自身の説明では、「ウェブサイトの所有者は、サイトについてウェブロボットに指示を与えるために/robots.txtファイルを使います。これはRobots Exclusion Protocolと呼ばれます。」どちらのファイルも予測可能なルートパスに置かれ、プレーンテキストで、人間ではなく自動化された読み手を対象とします。

類似点が途切れるのは目的です。robots.txtはほぼ全面的に否定的な指示であり、Disallow: /some-pathはクローラーに触れてはならない場所を伝えます。llms.txtは肯定的です。このサイトが何であり、読む価値のある部分がどこにあるかを示します。本全体を流し読みできない読者にとって、柵というより目次です。二つは補完関係にあり、Namefiのサイトでは両方を運用しています。

仕様が実際に求めているもの

llms.txtは自由形式ではありません。提案では、特定のMarkdown構造が順番どおりに定義されています。省略可能なバイトオーダーマーク、サイト名を含む必須のH1、概要の引用ブロック、見出しのない詳細セクションをゼロ個以上、そして[name](url): notes形式のリンクを並べるH2区切りの「ファイル一覧」セクションをゼロ個以上です。一つのH2見出しには特別な意味があります。Optionalという名前のセクションは、「より短いコンテキストが必要なら、ここにあるURLは省略できる」ことを示します。Namefiのファイルはその見出しを正確に使用し、仕様どおりの役割を持たせています。

namefi.io/llms.txtを順に見る

以下では公開中のファイルをセクションごとに注釈付きで紹介します。実際に何が書かれ、なぜ初めて読むエージェントに適した形になっているのかを説明します。

ファイルの末尾にはnamefi.io/llms-full.txtへの案内があります。これは同じ内容を一つのドキュメントにインライン展開したもので、ルートファイルではリンクのみのWeb3決済フローとアウトバウンドガイドも含みます。この分割は、仕様自体の二層構造を反映しています。入口はコンテキストに無理なく収まる短さに保ち、さらに必要なエージェントは一つのリンクをたどります。

関連ファイル：Web3とMCPディスカバリー

ルートファイルは、汎用の入口に含める必要がないAPI部分を関連ファイルへ分けています。namefi.io/web3/llms.txtでは、APIキーの代わりにウォレットを持つエージェントが必要とする決済経路を説明します。GET /x402/domain/{domainName}が、価格情報を含む402 Payment Requiredを返し、署名済みX-PAYMENTヘッダーを付けて支払うx402フロー、mppx CLIで署名するMPP（Machine Payable Protocol）のチャレンジ・レスポンス方式、スマートコントラクトウォレットにも対応する手動EIP-712署名経路です。ファイルには、x402での登録について明確にこう書かれています。「NamefiアカウントもEIP-712署名も不要です。購入者のウォレットがEIP-3009のtransferWithAuthorizationに署名します。」APIキーだけが必要なエージェントは、これらを読み込む必要がありません。

MCP側にはllms.txtとは完全に別のディスカバリーファイルがあります。namefi.io/.well-known/mcp/servers.jsonです。Markdownではなく、小さなJSONディスクリプターになっています。

{
  "servers": [
    {
      "name": "namefi-api",
      "transport": "streamable-http",
      "url": "https://api.namefi.io/mcp",
      "authentication": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      },
      "documentation": "https://namefi.io/llms.txt"
    }
  ]
}

このディスクリプターは.well-known/以下に置かれます。機械が発見できるメタデータに/.well-known/security.txtが使用するのと同じ規約です。llms.txtのMarkdown文章方式に対する、用途が限定されたJSON型の関連ファイルです。最後のフィールドはllms.txtを参照しているため、先にMCPサーバーを見つけたエージェントにも、そのツールの機能を説明するプレーンテキストへの経路があります。

含まれるもの、含まれないもの、その理由

いくつかの選択は意図的に見えます。ほぼすべての操作が、リクエストスキーマを説明する段落ではなく、実行可能なcurl呼び出しになっています。要約を書くものではなく、コードを実行するもののために書かれたファイルだからです。ルートファイルはすべてを含めず外部にリンクし、llms-full.txtは参照先の内容をインライン展開します。仕様自体のサイズ管理パターンを文字どおり適用したものです。## OptionalセクションはMarkdownと並べて完全なOpenAPI 3仕様にリンクしているため、厳密に型付けされたスキーマを必要とするツールにも、主要な読解経路を煩雑にせず提供できます。また、ウォレットベースの決済であるx402、MPP、EIP-712は独自のファイルに置かれ、APIキー認証と登録手順がすべてのエージェントの最初の読み物になるようにしています。

llms.txtとMCP：発見と接続

それぞれの役割を正確に区別することが重要です。llms.txtはドキュメントです。エージェントは一度取得すると、APIが何であり、詳しいリソースがどこにあるかを理解します。誰かが記載内容に基づいて行動するまでは、静的なテキストです。MCPは、プロトコル自身の説明によれば、「AIアプリケーションを外部システムに接続するためのオープンソース標準」です。クライアントがサーバーとの間に開く実際のセッションであり、呼び出し可能なツールを一覧にして実行できます。

Namefiのファイルは両者の関係を直接示しています。llms.txtは、MCPサーバーがapi.namefi.io/mcpに存在するとエージェントに伝え、接続用のclaude mcp addコマンドを示します。ファイルを読み、実際のツールインターフェースがあることを知り、接続し、実行するという流れです。最初からMCPを使うエージェントも.well-known/mcp/servers.jsonでサーバーを見つけられます。ただし、そのディスクリプターのdocumentationフィールドはllms.txtを参照するため、両者が完全に独立して動作することはほとんどありません。

ほかのAPI提供者への指針

実用的なllms.txtを公開するために、ドキュメントを作り直す必要はありません。

1. H1、概要、最速の接続方法を冒頭に置く — コンテキストの小さいエージェントは、最初の数行より先を読まない可能性があります。
2. スキーマの説明文ではなく、実行可能なリクエストを示す。 実際のフィールド名を含むcurlコマンドは、JSON本文を説明する段落より役に立ちます。
3. チーム構成ではなく、サイズで分割する。 短いルートファイルと詳細版を用意し、決済など個別の関心事を別ファイルにすると、一般的な経路を短く保てます。
4. ステータスコードだけでなく、実際の失敗原因を記載する — 401と403のどちらを返すかという数字より、なぜ返るのかが重要です。
5. 省略可能な内容には、仕様の規約どおり## Optional見出しを使う。
6. MCPサーバーを運用しているなら、llms.txtと一緒にMCPディスカバリーディスクリプターを公開する — 一方は「これは何か」に、もう一方は「どう接続するか」に答えます。

よくある質問

llms.txtとは何ですか？

正式なIETFまたはW3C標準ではなく、提案中の規約です。ウェブサイトのルートにプレーンテキストのMarkdownファイルを公開し、サイトやAPIが何であるか、詳しい情報がどこにあるかをAIエージェントに伝えます。H1タイトル、概要の引用ブロック、省略可能な詳細段落、H2区切りのリンク一覧という特定の順序が定義され、「Optional」見出しは省略可能な内容のために予約されています。

llms.txtはrobots.txtとどう違いますか？

robots.txtは、Robots Exclusion Protocolに基づいて、ウェブクローラーにインデックスしてはならないものを伝える否定的な指示です。llms.txtは、サイトが何であり、読む価値のあるものは何かを伝える肯定的な案内です。異なる自動化された読み手を対象とし、通常は同じサイトに共存します。

llms.txtはMCPに取って代わりますか？

いいえ。llms.txtはAPIの機能を理解するためにエージェントが一度読むドキュメントです。MCPは、実際にAPIの操作を呼び出すためにクライアントが開くライブなプロトコル接続です。Namefiは両方を公開しており、そもそもMCPサーバーが存在するとエージェントに伝えるのがllms.txtです。

Namefiのllms.txtファイルには何が含まれていますか？

ベースURL、MCPサーバーへのポインター、APIキー認証セクション、実行可能なcurl例を使う三段階のドメイン登録フロー、DNSレコード管理エンドポイントの表、ドメイン設定エンドポイント、トラブルシューティングセクション、SDK、OpenAPI仕様、ウォレット決済およびアウトバウンドワークフローの関連ファイルへリンクする「Optional」セクションです。

AIエージェントなしで、自分でllms.txtを読めますか？

はい。プレーンなMarkdownなので、モデルだけでなく人間にも読めます。namefi.io/llms.txtは簡潔なAPIクイックリファレンスとして読めます。人間が流し読みしやすい明快さは、モデルが正確に解析するためにも役立ちます。

出典と参考資料

• llmstxt.org — /llms.txtファイル：背景、提案、形式仕様
• robotstxt.org — /robots.txtについて：「要するに」
• modelcontextprotocol.io — Model Context Protocol（MCP）とは？
• Namefi — namefi.io/llms.txt（この記事で注釈したすべての抜粋の一次資料）
• Namefi — namefi.io/web3/llms.txt（x402、MPP、EIP-712によるウォレット決済フロー）
• Namefi — namefi.io/.well-known/mcp/servers.json（MCPディスカバリーディスクリプター）
• Namefi — namefi.io/llms-full.txt（Web3およびアウトバウンドの関連ファイルをインライン展開した単一ファイル版）
• IETF — RFC 8615：Well-Known Uniform Resource Identifiers（.well-known/規約）

自分でファイルを読んでみる

llms.txtを理解する最も速い方法は、実例を開くことです。namefi.io/llms.txtは公開され、認証なしで利用でき、この記事を読むのにかかった時間で読み切れるほど短いファイルです。Namefiに接続するすべてのAIエージェントが最初に読むのも同じファイルです。その背後にあるMCPツールの実際の機能はNamefi MCPサーバー：AIエージェント向けドメインツールを、エディターから接続する方法はMCPクイックスタートを、エージェントが全体の流れを実行する様子はNamefiでAIエージェントを使ってドメインを登録する方法をご覧ください。