多言語ドキュメントのSEO:hreflangとURL
2026年現在、製品ドキュメントの大半は英語のみです。適切に翻訳するチームは、英語のみのサイトには決して届かないオーガニックトラフィックを獲得しています—同じ購買意図を持つ日本語、スペイン語、ドイツ語、中国語での検索です。
これは、GoogleやAI検索を損なうことなく、15言語でドキュメントを公開するための実践的なSEOガイドです。
要約#
- 各言語はそれぞれ個別のURL(
/ja/、/es/、/de/)に配置する必要があります - 検索エンジンがどのページがどのページの翻訳かを認識できるように、
hreflangタグを追加します <html>要素でlang属性を使用します- 2026年のAI翻訳はドキュメントには十分な品質です(マーケティングコピーには不十分です)
- 英語の正規ソースを1つ用意し、その上にAI翻訳を重ねます — ソースを重複させないでください
基本ルール#
(ページ、言語)の組み合わせごとに1つのURL。
誤り:
docs.yourcompany.com/quick-start?lang=ja
docs.yourcompany.com/quick-start (with cookies)
正しい例:
docs.yourcompany.com/quick-start
docs.yourcompany.com/ja/quick-start
docs.yourcompany.com/es/quick-start
言語ごとに個別のURLがなければ、検索エンジンが言語別にインデックスする対象がありません。1つのURLがインデックス内で保持できるドキュメントは1つだけなので、検索エンジンが認識した言語だけがランキングの対象になります。それ以外のすべてのロケールは、翻訳の品質がどれほど優れていても、それぞれの言語での検索結果からは見えなくなります。
hreflang の設定#
各ページには、すべての翻訳を指す <link rel="alternate" hreflang="..."> タグが必要です。
<link rel="alternate" hreflang="en" href="https://docs.yourcompany.com/quick-start">
<link rel="alternate" hreflang="ja" href="https://docs.yourcompany.com/ja/quick-start">
<link rel="alternate" hreflang="es" href="https://docs.yourcompany.com/es/quick-start">
<link rel="alternate" hreflang="x-default" href="https://docs.yourcompany.com/quick-start">x-default はGoogleに「他のロケールに一致するものがない場合は、これを表示してください」と伝えます。通常は英語版です。
設定 → 言語で言語を有効にすると、Docsbookはhreflangを自動的に生成します。
AI翻訳で十分な場合#
3つの要因があります。
| コンテンツの種類 | AI翻訳の品質 | 推奨事項 |
|---|---|---|
| リファレンスドキュメント(API、設定) | 高い | AIを使用 |
| チュートリアルとハウツー | 高い | AIを使用し、簡単な人手レビューを行う |
| マーケティング用ランディングページ | 中程度 | 人手によるレビューが必要 |
| ブランドコピー(タグライン、ミッション) | 低い | 人手で翻訳 |
| コードサンプル | 該当なし | 原文のまま使用 |
| エラーメッセージ | 用語が一貫していれば高い | AIを使用 |
技術コンテンツに対するLLM翻訳の品質は、2023年から2026年にかけて大幅に向上しました。特にドキュメントでは、機械翻訳には単なる価格面の優位性にとどまらず、人手によるプロセスに対する構造的な優位性があります。
- 用語の一貫性。 モデルは、1,000ページにわたって同じ概念に同じ用語を適用します。一方、交代制の人間翻訳者の間では用語の揺れが生じ、その揺れは読者がバグとして報告するまで見えません。
- スピード。 言語ごとに見積もりとスケジュール調整を行うのではなく、15言語を数分で翻訳できます。
- 改訂コスト。 人手翻訳の本当のコストは初回の翻訳ではなく、その後のすべての改訂にあります。段落を変更すると、すべての言語で再び単語単位の料金が発生します。機械翻訳では、変更されたページだけを再計算できます。そのため、人手による翻訳パイプラインでは翻訳済みドキュメントが古くなり、機械翻訳では最新の状態を維持できます。
それでも人間のほうが優れている分野:
- 文化的なローカライズ(日付形式、例、ブランドボイス)
- 重要性の高い法務コピー
- マーケティングのタグライン
ドキュメントでは、2026年には費用対効果がAI翻訳に大きく傾いています。
各言語は個別にインデックス登録される#
重要なシグナルは3つです:
- URLパターン —
/ja/サブディレクトリまたはja.yourdomain.comサブドメイン(サブディレクトリのほうが容易) - hreflangタグ — 双方向で、すべてのバージョン間を相互に指し示す
lang属性 — 日本語版では<html lang="ja">- サイトマップのエントリ — 各言語に
xhtml:linkアノテーション付きの独自エントリ
Googleはその後、それぞれのロケールの検索結果で各言語を順位付けします。日本のユーザーが日本語で検索すると、/ja/ が表示されます。スペインのユーザーがスペイン語で検索すると、/es/ が表示されます。
AI検索エンジンが翻訳をどのように扱うか#
観察された3つの挙動:
ChatGPT#
ChatGPTは、クエリがその言語で入力されている場合、翻訳されたページを引用します。ChatGPTに「ドキュメンテーションプラットフォームを比較してください」(日本語でドキュメンテーションプラットフォームを比較してください)と尋ねると、日本語版のドキュメントを含む日本語の情報源が返されます。
パープレキシティ#
ChatGPTと同様に、Perplexityはクエリの言語とソースの言語を厳密に一致させます。適切に翻訳すれば、言語ごとに引用チャネルを獲得できます。
Gemini#
Google Gemini は Google の基盤となるインデックスを使用します。Google AI Overviews に役立つものと同じ hreflang およびロケールシグナルが、Gemini にも役立ちます。
Docsbookが多言語に対応する仕組み#
言語を有効にするための3つの手順:
- ダッシュボード → 設定 → 言語 → 言語を選択 → 有効化
- AIがドキュメントセット全体をその言語に翻訳します。翻訳の実行料金は、プロジェクトの残高に対してドル単位で計上されます
- ページが
/{language-code}/{path}に表示され、hreflang とlangが正しく設定されます
15言語に対応しています:EN、ES、FR、DE、PT、IT、RU、ZH、JA、KO、AR、HI、TR、PL、NL。
人間の翻訳者がいる場合は、MCPツール upload_translation または管理UIから独自の翻訳をアップロードすることもできます。
翻訳モード#
3つのモードを利用できます:
- 自動 — Docsbook AIがすべて自動的に翻訳します
- 手動 — 翻訳待ちのキューを確認し、公開前にレビューします
- 外部 — 独自の翻訳パイプライン(TMSや翻訳者)をWebhookで接続します
外部モードは、すでに翻訳メモリを持っていて、引き続きそれを使用したいチーム向けです。set_translation_mode MCPツールでモードを切り替えます。
多言語 SEO を台無しにする間違い#
- クエリパラメータによる切り替え (
?lang=ja) — Google はこれらを個別のページとしてインデックス登録しません - Cookie に基づく言語検出 — 同じ問題が発生し、1 つの URL しかインデックス登録されません
- hreflang タグの欠落 — Google は翻訳ページを重複コンテンツとして扱います
- 一方向の hreflang — 両方のページが互いを参照する必要があります
lang属性がない — スクリーンリーダーやクローラーは英語にフォールバックします
コスト比較#
200ページを14の追加言語に翻訳する場合:
| DIYによる人手翻訳 | Docsbook AI翻訳 | |
|---|---|---|
| コスト | 単語単位で、言語ごとに見積もり、改訂のたびに再度支払い | プロジェクト残高から翻訳実行ごとに従量課金 |
| 所要時間 | 数か月 | 数時間 |
| 更新コスト | 原文ページが変更されるたびに、単語単位で再度課金 | 原文の変更時に再計算 |
| SEOインデックス登録 | hreflangの手動設定 | ロケールごとに自動 |
| 最適な用途 | 人による承認が必要な法務、規制対象、マーケティングのコピー | 頻繁に変更されるリファレンスおよびハウツーコンテンツ |
機械翻訳が常に優れているわけではありません。多くの翻訳プロジェクトを頓挫させる作業、つまり初回の翻訳ではなく20回目の改訂において、機械翻訳のほうが優れています。
次のステップ#
- ドキュメントSEOガイド — このページが拡張する単一ロケールの基盤
- ドキュメント向けAI検索 — ロケール間のサイト内検索
- ChatGPTにドキュメントを引用してもらう方法 — アシスタントも多くの言語で質問します
- ドキュメント向けJSON-LD — 各翻訳ページに追加される構造化データ