SEO

Docsbook は、ドキュメントの機械可読な部分を構築します。ホスティングするすべてのページは、解決済みの <title>、整理されたメタディスクリプション、1 つの正規 URL、実際に翻訳した言語のみを含む hreflang セット、生成画像付きの OpenGraph と X カード、JSON-LD グラフ、および robots.txt が指すサイトマップのエントリを備えた、サーバーでレンダリングされた HTML です。Markdown を記述すれば、head はその結果として生成されます。

このセクションでは、検索結果、つまり Google と Bing がクロール、インデックス登録、ランキングを行う対象について説明します。その他の機械向けサーフェスについては、重複しない形で隣接する 2 つのセクションが扱います。 AEO は検索結果の上に表示される回答ボックスであり、 GEO はランキングされる代わりに AI アシスタントから引用されることです。

かかるもの#

3つあります。そのうち1つは任意ではありません。

1. SEO スイッチをオンにします。 管理パネルの Settings ▸ SEO & GEO で、 SEO トグルをオンにします。新規プロジェクトではオフになっており、オフの間はすべてのページが noindex, nofollow として配信されます。マークアップはすべて生成され、そのすべてに「インデックスしないでください」と記載されています。Docsbook サイトが Google に掲載されない最大の理由はこれです。すべてのプランで無料です。
2. 明確な # H1 と、ページの問いに答える冒頭の段落を1つ書きます。 上書きしない限り、それらがタイトルと説明になります。
3. それ以外は何もありません。 カノニカル URL、サイトマップ、robots.txt、カード、JSON-LD、言語クラスターは管理されており、それらの設定項目はありません。

1ページだけ生成された行を上書きするには、フロントマターに記述します。

---
title: "Configure a webhook"
description: "Register a Docsbook webhook, choose its events, and verify the first delivery."
---

公開して読み取り可能な状態のまま、1ページをインデックスから除外するには、次のようにします。

---
noindex: true
---

robots: noindex、noindex: yes、noindex: 1 も使用できます。クロールバジェットを消費するだけで、クリックを獲得することのないページに使用してください — 90,000文字の変更履歴、内部作業メモ、未完成のプレースホルダーなどです。サイト全体のスイッチはこの用途には適していません。オフにするとすべてが非表示になるためです。

シグナルと、それぞれが決定される場所#

これが正しい方法である理由（根拠）#

Docsbookが主張しないこと#

• これらのどれもページの検索順位を上げるものではありません。 上記のすべての仕組みは、ページを クロール可能で、曖昧さがなく、正しく表示されるようにします。Googleのページエクスペリエンスに関する FAQは「単一の『ページエクスペリエンスシグナル』…はありますか？」という質問に「単一の シグナルはありません」と回答し、ページエクスペリエンスがランキングにどの程度影響するかについては 「ページエクスペリエンスが基準を満たしていなくても、Google検索は常に最も関連性の高いコンテンツを表示しようとします」 と回答しています（ページエクスペリエンス）。 マークアップは土台であって、テコではありません。
• 構造化データは、ランキングシグナルではなく、資格要件を満たしていることを示すシグナルとして文書化されています。 Google自身の導入ではリッチリザルトについて説明されていますが、ランキングについては何も述べられていません。
• priority と changefreq は、サイトマップ内にあってもGoogleには何の効果もありません。 「Googleは <priority> と <changefreq> の値を無視します。」Docsbookは、それらを読み取る検索エンジンのために出力しています。
• クロールバジェットは、おそらくあなたの問題ではありません。 Googleのクロールバジェットに関するガイドは、 「コンテンツが適度な頻度（週1回）で変更される大規模サイト（ユニークページ100万以上）」および 「コンテンツが非常に頻繁（日次）に変更される中規模以上のサイト（ユニークページ1万以上）」を対象としており、 同時にこれらについて「サイトを分類するための大まかな目安です。正確な基準値ではありません」と述べています。 巨大な変更履歴に対してnoindexを行う価値は依然としてありますが、60ページのドキュメントサイトを クロールバジェットの緊急事態として扱う必要はありません。
• 倍率はありません。 トラフィックは、トピック、競合、ドメインによって決まります。 パーセンテージを提示してくるプラットフォームがあれば、それは他の誰かのサイトについての数字です。

制限#

• サイト全体のスイッチはデフォルトでオフであり、ワークスペース全体に適用されます。ページ単位のnoindexフラグより上に、「このセクションはインデックスするが、あのセクションはしない」という制御はありません。
• カスタムドメインでは、SEOスイッチとページ単位のnoindexは適用されません — ページは無条件でindex, followとして提供されます — また、hreflang クラスターも、BreadcrumbListも、サイトマップも、移動したページのリダイレクトも、 GEOのページレベルのシグナルもありません。カノニカルURL、タイトル、説明、 カード、そしてTechArticleノードはすべて正しく設定されます。詳しくは 仕組みをご覧ください。
• Search Consoleの掲載順位は、Docsbookがホストするホストのみを対象とします。 独自の ドメイン上のサイトは、Docsbookが読み取るプロパティの対象外です。詳しくは インデックス登録をご覧ください。
• Docsbookの外で名称を変更しても、リダイレクトは作成されません。 Docsbookを通じて行った移動では 自動的に作成されますが、git mvでは作成されません。

チェックリスト#

• 設定 ▸ SEO & GEO で SEO トグルがオンになっている。
• すべてのページに明確な # H1 が1つあるか、frontmatter に title がある。
• 冒頭の段落で、そのページの質問に1文または2文で答えている。
• すべてのページにサイドバーからアクセスでき、孤立したページがない。
• 検索順位に表示すべきでないページには noindex: true が付いている。
• 多言語ドキュメントでは、翻訳が有効になっている 各言語にそれぞれインデックス可能なURLが割り当てられるようにする。

関連#

• Docsbookがページのheadを構築する方法 — 解決の優先順位。
• インデックス登録 — 検出、再クロール、Search Console。
• AEO — 回答エンジンとリッチリザルト
• GEO — AIアシスタントによる引用
• llms.txt
• AI翻訳
• 検索オプション — 読者がサイトに到着した後に使用するサイト内検索。