Docsbook
概要

2026年にChatGPTにドキュメントを引用してもらう方法

開発者がChatGPTに「製品Yで機能Xを使うにはどうすればよいですか」と尋ねると、2つのうちどちらかが起こります。ChatGPTがあなたのドキュメントを引用して正確に説明するか、実在しないAPI仕様を幻覚してしまうかです。どちらになるかは、あなたが行ってきた取り組みによって決まります。

これは、Docsbookで自社のドキュメントや顧客向けドキュメントに使用している実践的なチェックリストです。

TL;DR#

  1. ルートにクリーンな llms.txt を公開する
  2. JavaScriptなしでコンテンツが表示されるクリーンなHTMLを配信する
  3. マーケティングコピーではなく、事実に基づく断定的な文章を書く
  4. すべてのページの先頭にTL;DRまたは概要ブロックを追加する
  5. JSON-LDを使用する: TechArticleFAQPageSoftwareApplication
  6. ページの応答を1秒未満に保つ
  7. robots.txtで適切なAIクローラーが許可されていることを確認する

この投稿の残りでは、それぞれの理由と方法を説明します。

1. llms.txt は新しい robots.txt#

ChatGPT、Claude、Perplexity は現在、ドメインに初めてアクセスした際に /llms.txt を探します。適切に構成された llms.txt により、エージェントは URL を推測する代わりに、あなたが用意した候補リストを使用するため、ハルシネーションの発生率が大幅に低下します。

llms.txt 完全ガイドをご覧ください。Docsbook はワークスペースごとに自動的に生成します。

2. JavaScriptなしでコンテンツをレンダリングする#

AIクローラーは軽量なHTMLパーサーを使用します。ほとんどのクローラーはJavaScriptを実行しません。ドキュメントがDOMContentLoadedの後にコンテンツを取得する単一ページアプリケーションの場合、AIには空白のページとして表示されます。

次の3点を確認してください:

curl -s https://yourdomain.com/docs/page | grep -c "your unique phrase"

カウントが0の場合、AIからは認識されません。

  • サーバーサイドレンダリングまたは静的生成を使用する
  • 主要コンテンツでハイドレーションのみに依存するパターンを避ける
  • Chromeだけでなく、curllynxでテストする

3. マーケティングではなく、事実に基づく文章を書く#

AIモデルは、婉曲的なマーケティング表現よりも断定的な文を好みます。比較してみましょう。

「Docsbookは、チームのドキュメントワークフローに変革をもたらす、業界をリードするプラットフォームです。」

一方、こちらはどうでしょう。

「Docsbookは、GitHubリポジトリから5秒でドキュメントサイトを公開します。翻訳は15言語に対応しています。料金は段階制ではなく、AIの利用量に応じて計算されます。」

2つ目の文は引用できます。1つ目は単なる埋め草です。引用できる文は回答に使われますが、埋め草は使われません。

4. すべてのページ冒頭にTL;DR#

AIエージェントは情報抽出マシンです。明確な抽出対象を与えましょう。

有用なパターンは、## TL;DR見出しの後に、最も重要な事実を含む3~5個の箇条書きを続けることです。AIモデルは、これらをほぼそのまま回答に取り入れます。

Docsbookはすべてのブログ記事でこれを実践しています。適切に引用されたStripeのドキュメントページも同様です。

5. AIが実際に利用するJSON-LD#

ドキュメントでは、次の3種類が重要です。

  • TechArticle — ハウツーおよびチュートリアルページ用
  • FAQPage — Q&Aブロックがあるすべてのページ用
  • SoftwareApplication — 製品概要ページ(価格、OS、評価)用

Docsbookではこれらが自動的に追加されます。自分で構築したサイトを使用している場合は、実装方法についてドキュメントSEOガイドをご覧ください。

6. クローラーにとっても速度は重要#

AIクローラーはGooglebotよりも厳しいタイムアウト設定になっています。最初の1バイトの受信までに3秒かかるページは除外されます。

  • PageSpeed Insightsを実行し、90以上を目指す
  • head内で分析スクリプトをブロックしない
  • CDNで積極的にキャッシュする

Docsbookのページは、デフォルトでPageSpeed Insightsのスコアが95以上です。静的生成、最小限のJavaScript、Vercel Edgeを採用しています。

7. AIクローラー向けのRobots.txt#

2026年の主なAIクローラー:

クローラー ユーザーエージェント 使用元
GPTBot GPTBot ChatGPTのブラウジングとトレーニング
OAI-SearchBot OAI-SearchBot ChatGPT Search
ClaudeBot ClaudeBot Claude.aiとAnthropicの検索
PerplexityBot PerplexityBot Perplexity
Google-Extended Google-Extended Gemini、Google AI Overviews
CCBot CCBot Common Crawl(多くのモデルのトレーニングデータ)

ドキュメントでは、通常これらすべてを許可します。Docsbookが提供するデフォルトのrobots.txtでは許可されています。一部をブロックしている場合は、それが意図したものか確認してください。

8. ボーナス:正規の情報源として引用される#

ChatGPTは、他のサイトがすでにリンクしているURLを引用する傾向があります。あなたのドキュメントがホームページ、変更履歴、ブログ、GitHub READMEからリンクされていると、AIモデルはあなたが自社製品の正規の情報源であると確信しやすくなります。

内部リンクは過小評価されています。GitHubリポジトリのAboutリンクにdocs.yourcompany.comを設定することも同様です。

よくある間違い#

  • クローキング — ユーザーに表示する内容とクローラーに表示する内容を変えること。AI モデルはこれを検証するため、不一致があるとランキングを下げます。
  • ページ上部の過剰なマーケティングコピー — 最初の H2 より上にあるコンテンツは非常に重視されます。そこには事実を掲載してください。
  • 前提条件を隠す — 「X を設定済みである」ことを前提としながら、X へのリンクがないページは、AI を不完全な回答へと誘導します。
  • コードサンプルがない — 開発者向けのクエリは、コードに関するものが大半です。コードのないページは引用されにくくなります。

引用を測定する方法#

追跡する価値のある3つのシグナル:

  1. chat.openai.comperplexity.aiclaude.aiからの直接参照 — アナリティクスで確認できます
  2. AIへの質問ログ — ドキュメントのAIチャットを運用している場合、質問からユーザーが何を見つけられると期待しているかがわかります
  3. 言及のモニタリング — 逸話的な引用を確認するため、月に1回、プロダクト名 + 「ChatGPT」でGoogle検索します

DocsbookにはAI利用状況の分析機能(get_ai_questionsget_ai_unansweredget_failed_searches)が組み込まれているため、ユーザーが質問しているにもかかわらず、十分に回答できていない内容を確認できます。


Docsbookはllms.txt、JSON-LD、サーバーサイドレンダリング、AIクローラー向けのrobots.txtを自動的に処理します。ドキュメントを公開 →

Updated

このページは役に立ちましたか?