ChatGPT、Perplexity、Google AI Overviews などのAI搭載の回答エンジンと、従来型の検索エンジンの双方に対してドキュメントを最適化しましょう。 Generative Engine Optimization(GEO)は、包括的なコンテンツと構造化情報によってAIシステムからの引用獲得に重点を置くのに対し、従来のSEOは検索結果での順位向上を目的とします。

GEO クイックスタート

初期設定

  1. docs.json の設定でドキュメントがインデックス対象になっていることを確認する
  2. 既存のページを監査し、説明やタイトルの不足がないか確認する

コンテンツの改善

  1. 適切なページに比較表を追加する
  2. 見出しを見直し、よくある質問に答えているか確認する
  3. 関連トピック間の内部リンクを強化する
  4. AI ツールでテストして正確性を検証する

GEO のベストプラクティス

一般に、よく書かれ適切に構造化されたドキュメントは、GEO に強くなります。まずはユーザーのために書くことを優先し、コンテンツがユーザーのニーズを満たしていれば、AI ツール向けの最適化にも自然と近づけます。単なる「最適化のための最適化」ではなく、本当に役立つコンテンツを作成することが、従来型と AI の両方の検索エンジンに評価されます。 次に注力しましょう:
  • キーワード一致ではなく、ユーザーのニーズに沿ったコンテンツ
  • 構造化され、スキャンしやすい情報
  • 質問への端的な回答

明確さのための書式

次の書式の実践は、AI ツールがコンテンツを解析・理解するのに役立ちます:
  • 見出しレベルを飛ばさない(H1 → H2 → H3)
  • “it” や “this” の代わりに具体的なオブジェクト名を使う
  • コードブロックに対応するプログラミング言語のラベルを付ける
  • 画像には説明的な alt テキストを付ける
  • 関連する概念にリンクし、AI が関係性を把握できるようにする

質問に直接答える

特定のユーザーの質問に的確に応えるコンテンツを書きましょう。
  • セクションは最も重要な要点から始める
  • よくある質問に合致する、わかりやすい見出しを使う
  • 複雑なトピックは番号付きの手順に分解する

Mintlify の設定

これらの機能を使って GEO を改善しましょう。

記述的なページメタデータを追加する

フロントマターにわかりやすいタイトルと説明を含めます:
---
title: "API authentication guide"
description: "Complete guide to implementing API authentication with code examples"
---

グローバルなインデックス設定を設定する

docs.json に次を追加します:
{
  "seo": {
    "indexing": "all",
    "metatags": {
      "og:type": "website",
      "og:site_name": "Your docs"
    }
  }
}

LLMs.txt

LLMs.txt は、サイトマップが検索エンジンを支援するのと同様に、AI システムがドキュメントの構造を理解するのに役立つファイルです。Mintlify はドキュメント向けの LLMs.txt を自動生成します。設定は不要です。

ドキュメントのテスト

製品やドキュメントに関する質問で各種AIツールを試し、ドキュメントの参照・引用のされ方を確認しましょう。 アシスタントにドキュメントについて具体的な質問を投げてみてください:
  • 「このAPIで認証を設定するにはどうすればよいですか?」
  • 「インストール手順をステップごとに説明してください」
ツールが次を提供しているか確認してください:
  • 正確なコードサンプル
  • 正確なステップバイステップの手順