LLMs.txt in Apidog: APIドキュメントをAIフレンドリーにする方法

中村 拓也

中村 拓也

17 4月 2025

LLMs.txt in Apidog: APIドキュメントをAIフレンドリーにする方法

今日のAI主導の開発環境において、LLMが容易に処理できるドキュメントを持つことが必須です。このニーズを認識し、Apidogは現在、LLMs.txtをサポートしており、共有または公開されたAPIドキュメントをAIフレンドリーな形式に変換します。この強力な機能により、AIツールは通常AIシステムを混乱させるHTMLやJavaScriptの雑音なしに、クリーンで構造化されたドキュメントコンテンツにアクセスできます。

これがあなたの開発ワークフローにとって何を意味するのか、そしてどのようにしてすぐに活用できるのかを探っていきましょう。

LLMs.txtとは何か、そしてなぜApidogはLLMs.txtをサポートするのか

AIアシスタントがオンラインWebコンテンツを処理する際、重要な情報をフィルタリングするのに苦労することがよくあります。今日のほとんどのウェブページは、人間には便利ですが、機械には気を散らすスタイル、スクリプト、インタラクティブな要素で膨れ上がっています。これらの無駄なスクリプトはトークンを浪費し、応答速度を低下させ、AIワークフローにおいてコストを増加させます。

LLMs.txtは、2024年に提案された新しい標準であり、これを解決するために設計されています。検索エンジンのためのsitemap.xmlのように、llms.txtはLLMのためのロードマップです。それはあなたのドキュメントページのすべてのMarkdown(.md)バージョンへのリンクを含んでおり、AIが不要なコンテンツをスキップし、重要な部分に焦点を当てることを可能にします。

なぜApidogのLLMs.txtサポートが重要なのか

Apidogは、次の操作を自動的に実行することで一歩先を行っています。

これにより、あなたのドキュメントはすぐにAIに使用可能になり、追加の設定は不要です

AIフレンドリーなAPIドキュメントのためのApidogのLLMs.txtの主な機能

ApidogのLLMs.txtの主な機能

ApidogのLLMs.txtのサポートは、あなたのAPIドキュメントがAIシステムとどのように相互作用するかの根本的な改善を表しています:

シームレスなMarkdownアクセス

すべての共有/公開されたドキュメントページには、専用の.mdバージョンがあります:

サイトレベルのLLMs.txt生成

Apidogが公開したAPIドキュメントには、/llms.txtファイルが埋め込まれます。

設定不要

SEOおよびAI標準に準拠

機能 LLMs.txt Sitemap.xml Robots.txt
AIによる可読性 ✅ はい ❌ いいえ ❌ いいえ
SEO最適化 ✅ はい ✅ はい ✅ はい
自動生成 ✅ Apidogによる ✅ Apidogによる ✅ Apidogによる

このスタックは、あなたのドキュメントサイトをAIツールと従来の検索エンジンの両方に最適化します。


ApidogのLLMs.txt機能の使い方

ChatGPT、Claude、Cursor、または任意のカスタムLLMインターフェースで作業している場合でも、ApidogドキュメントをAIワークフローに組み込むことが以前よりも簡単になりました。

方法1: Markdown URLを直接共有する

WebブラウジングをサポートしているAIの場合:

https://apidogsite.com/api-doc.md

方法2: MarkdownをAIにコピー&ペーストする

Webブラウジング機能のないAIツールの場合:


[ここにMarkdownコンテンツを貼り付け]
💡
プロのヒント: AI統合を強化したいですか?Apidog MCPサーバーとLLMs.txtを組み合わせてください!

LLMs.txtにより、あなたのAPIドキュメントはAIツールにとって読みやすくなりますが、Apidog MCPサーバーはさらに一歩進んで、AIアシスタントにあなたのAPI仕様への直接アクセスを提供します。その結果、彼らはあなたのAPIの完全な構造を理解し、正確なコードを生成し、より賢く支援することができます。

ドキュメントを手動でコピー&ペーストする必要はありません。これは、よりスマートでAI駆動の開発ワークフローを構築するためのシームレスな方法です。
button

ApidogのLLMs.txtサポートに関するFAQ

Q1: LLMs.txt機能を無効にするにはどうすればよいですか?

この機能を無効にしたい場合は、プロジェクトに入り、Docsを共有 -> Docsサイトを公開 -> LLMフレンドリー機能をクリックして関連操作を行うことができます。

Q2: LLMs.txtを有効にするとドキュメントのセキュリティに影響を与えますか?

いいえ、LLMs.txtはプライベートまたは未公開の情報を公開することはありません。
これは、すでに公開されたAPIドキュメントからのコンテンツのみを含みます。LLMs.txt機能は、既存のHTMLページのMarkdownバージョンを提供するだけであり、表示される内容には変更はありません。

公開されたドキュメントが保護されている場合(例えば、パスワード、IPホワイトリスト、またはメールホワイトリストによって)、誰かが.mdバージョンやLLMs.txtファイルにアクセスしようとする際には、同様の認証要件が適用されます。

Q3: 私のオンラインドキュメントがパスワード、IPホワイトリスト、またはメールホワイトリストで保護されている場合、LLMs.txt機能を使用できますか?

はい、依然として使用できます。

ただし、LLMs.txtファイルとドキュメントのMarkdown(.md)バージョンは同じアクセス制御に従うため、認証が必要です。これにより、AIアシスタントはアクセス権がない限り、URL経由で直接.mdファイルを取得することができません。

この問題を回避するために、あなた(またはアクセス権を持つユーザー)は、「ページをコピー」機能を使用してMarkdownコンテンツを簡単にコピーし、選択したAIツールに貼り付けることができます。

Q4: なぜApidogアプリに「ページをコピー」や他のボタンが表示されないのですか?

ページをコピーボタンと関連機能は、共有または公開されたオンラインドキュメントでのみ利用可能です。

これらの機能にアクセスするには、まずドキュメントを公開し、次にウェブブラウザで表示する必要があります—Apidogデスクトップアプリ内ではありません。

Q5: AIアシスタントの「検索」機能を有効にしましたが、なぜ直接URLからウェブページのコンテンツを読むことができないのですか?

「検索」機能は「Webブラウジング」とは異なります。

Q6: AIがURLを介してMarkdownファイルにアクセスできない場合はどうすればよいですか?

AIが.mdファイルをURLから直接読み取れない場合は、オンラインドキュメント上の「ページをコピー」ボタンを使用してください。これにより、Markdownコンテンツを手動でコピーし、AIアシスタントに貼り付けてさらに使用できます。

Q7: LLMs.txtを有効にした後、他に何かする必要がありますか?

追加の作業は必要ありません。LLMs.txt機能を有効にすると、システムは各ドキュメントページのLLMs.txtファイルと対応するMarkdown (.md) バージョンを自動的に生成します。あなたは元のドキュメントを通常通りに更新および維持し続けるだけで済みます。

Q8: LLMs.txtが正しく動作しているかどうかを確認するにはどうすればよいですか?

これは、公開されたドキュメントサイトのルートで/llms.txtパスにアクセスすることで確認できます。ページにドキュメントリンクの構造化リストが表示されていれば、その機能は正常に有効化され、期待通りに動作しています。

Q9: LLMs.txtは複雑または深くネストされたスキーマ参照をどのように処理しますか?

Apidogはインテリジェントな再帰的降下解析を使用してこれを処理します。これにより、スキーマ内の多階層のネストされた参照を自動的に拡張しながら、ドキュメントをAIにとって読みやすく、構造化された状態で保ちます。これにより、複雑なスキーマであっても、明確に提示され、AIツールおよび人間にとってアクセスしやすくなります。

結論: AIの時代のためのAPIドキュメントの変革

ApidogによるLLMs.txtの実装は、APIドキュメントを真にAIREADYにするための重要な進展を代表します。クリーンなMarkdownエクスポートと包括的なインデックスを自動的に提供することで、Apidogは人間が読みやすいドキュメントと機械最適化されたコンテンツの間のギャップを埋めます。

これは単なる技術的な改善ではなく、開発チームが彼らのワークフロー全体でAIを活用する方法の変革です:

ApidogのLLMs.txtサポートにより、あなたのAPIドキュメントは人間の開発者とAIアシスタントの両方にとって強力な資産となります—より良いソフトウェアをより迅速に構築するために一緒に働きます。

今日からこれらの機能を使用し始めましょう: AIツールとMarkdownリンクを共有し、ドキュメントコンテンツをAI会話に直接コピーし、開発プロセスの新しいレベルの効率を体験してください。

button

ApidogでAPIデザイン中心のアプローチを取る

APIの開発と利用をよりシンプルなことにする方法を発見できる