seo-geo-answerblocks

seo-geo-answerblocks（M11）

AI エンジンは、周囲の文脈がなくてもそのまま引用できる文章を引用するため、文章の構成はページ上で最も効果の大きい AI シグナルです。このモジュールでは抽出可能性を確認します。ページの取得と引用を許可されている主体については、references/ai-crawlers.md を参照してください。

入力

ディスパッチ用エンベロープで指定された PageSnapshot を使用します。<run_dir>/pages/<slug>.json から parsed（headings[]、text_sample、word_count）を読み込みます。文章は HTML ファイルから取得し、要約からは取得しません。逐語的な根拠を確認するには、pages/<slug>.html を Grep します。サイトのアーティファクトは <run_dir>/site/{robots.json,sitemaps.json,discovery.json} にあります。audit.mjs がすでに出力した決定論的な検出結果は <run_dir>/findings.deterministic.json に記載されています。これらの ID を再出力せず、モデルが判断した検出結果のみを追加してください。スナップショットがない状態で URL／パスを直接指定して実行する場合は、最初に node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs" を実行し、出力されたスナップショットのパスを使用してください。

監査

PageSnapshot（render.used が none でない場合は parsed_rendered、それ以外は parsed）を使用して、次を確認します。

1. 見出し → 直接的な回答：質問として読める（または質問を示唆する）各 H2／H3 について、最初の段落が約 40～60 語の直接的な回答になっていますか。「このセクションでは……を見ていきます」のような前置きではありませんか？
2. 単独で成立する文章：最上位の文章は約 134～167 語で、それだけで回答として成立しますか？先行する文脈がないと解釈できない照応表現（「前述のとおり」「これ」「後者」など）があれば、フラグを立てます。
3. 構造化された形式：内容に適している場合、リスト、比較表、明示的な用語の定義が含まれていますか？これらは引用される可能性が特に高い形式です。
4. 質問形式の見出し：見出しは、ユーザーが実際に尋ねる質問（方法／内容／理由／時期）を表し、想定されるプロンプトに合っていますか？
5. TL;DR／要約ブロック：エンジンがそのまま抽出できる、冒頭の要約または重要ポイントのブロックがありますか？
6. 意味的な完全性：各文章は、外部の文脈がなくても見出しに回答できますか？これは AI による引用との相関が最も強い単一の要素であり、このモジュールで最も重い確認項目です（最も高い重みが割り当てられますが、スコアの上限にはなりません。「検出結果」を参照してください）。

修正

• 提案：既存のページ内容から生成した回答ブロックの書き換え（見出し → 簡潔な 40～60 語の導入文）や TL;DR の草案を、一度に 1 項目ずつ提示し、ユーザーが採用または編集できるようにします。採用後にのみ、それぞれが fix_preview の差分になります。
• 助言：編集上の判断が必要な構成上の提案（「この 400 語の文章を分割する」「ここに定義リストを追加する」など）。
• 公開済みの文章を決して黙って書き換えず、文章を補うために事実を捏造しないでください。主張が不足している場合は、ユーザー向けに明確な TODO プレースホルダーを残してください。このモジュールの検出結果が auto になることはありません。

検証

• 手法は manual_review です。決定論的な部分はオフラインで再現できます。語数の範囲（回答 40～60 語、文章 134～167 語）、疑問形の見出しの検出、照応表現で始まる文、TL;DR の有無を、node "${CLAUDE_PLUGIN_ROOT}/scripts/check-answerblocks.mjs" --snapshot <pages/<slug>.json> [--lang en|es|auto]（または --url <u>／--file <path>）で確認できます。検出結果の verification.method には manual_review を使用してください（列挙型に heuristic はありません）。このスクリプトを verification.reproduce コマンドに指定します。
• 言語の対応範囲：ヒューリスティックには EN と ES の辞書が含まれています（疑問詞。¿ を含む、前置き表現、照応表現、TL;DR／Resumen のマーカー）。検出された言語がそれ以外の場合、言語に依存するフィールドは 0 ではなく null となり、検出結果は manual_review になります。そのため、未対応言語のページが誤って合格と評価されることはありません。
• 意味的な完全性と照応表現の解決には、引き続き判断によるレビューが必要です。そのレビューまたはレンダリング済み DOM が利用できない場合、ステータスは needs_api（または manual_review）となり、誤って pass になることはありません。

検出結果

検出結果は schema/finding.schema.json に準拠し、軸は ai です。重大度の方針：5 は、サイト／テンプレート全体に関わり、適格性を損なう壊滅的な事実に限ります。4 は重大、3 は中程度、2 は軽微、1 は表面的、0 は情報提供のみです。また、スコアに上限を設けられるのは、有効なカテゴリにおける established の重大度 5 の fail のみです（references/scoring-model.md）。M11 に established はないため、ここでスコアに上限が設けられることはありません。

• M11.heading.no_direct_answer — 質問形式の H2／H3 見出しの後に、回答ではなく前置きが続いています（fail、重大度 3、fixable: proposed、信頼度 directional）。
• M11.passage.unresolved_anaphora — 「As mentioned above…」／「Esto…」などで段落が始まり、単独では読めません（warn、重大度 2、fixable: proposed、信頼度 directional）。
• M11.passage.overlong — 抽出可能な範囲（167 語超）を大幅に超える長さの段落で、抜き出せる内部構造がありません（warn、重大度 2、fixable: proposed、信頼度 directional）。
• M11.summary.missing_tldr — 長文ページに冒頭の要約／重要ポイントのブロックがありません（warn、重大度 2、fixable: proposed、信頼度 directional）。
• M11.answers.ok — 質問形式の見出しに直接回答しており、各段落が自己完結しています（pass、重大度 3、信頼度 directional）。
• M11.lang.unsupported — ページの言語が EN／ES の語彙リストに含まれていないため、段落のヒューリスティクスでは判定できません（manual_review、重大度 0。言語に依存するフィールドは null）。 各検出結果の evidence.observed にはページからの引用（見出しテキストと最初の文、または該当する節）が記載され、verification.reproduce には上記の実行可能なコマンドが記載されています。expected_impact は、信頼度ラベル付きの範囲で示し、根拠のない割合は提示しません。

誠実さ

• Google は AI 専用の書き換えやチャンク分割を求めていません。 生成 AI に関するガイダンスでも、同じ基本事項、つまりインデックス可能で、スニペットの対象となり、構成が整った、人に向けて書かれたページを推奨しています。段落の長さ、チャンクサイズ、回答ブロックの形式については何も定めていません。このモジュールの内容はすべて、人間の読者にも役立つ 読みやすさと抽出しやすさ に関するものです。そのように説明し、書き換えを検索エンジンの要件として売り込まないでください。
• 語数の範囲は、観測された引用パターンに基づくヒューリスティクスであり、検索エンジンが公表したしきい値ではありません。directional とし、established にはしないでください。段落には警告を出し、長さだけを理由に fail にしないでください。
• 「TL;DR」というラベルを加えたり、見出しに疑問符を付けたりしても、段落が単独で回答できなければ効果はありません。重要なのは意味の完結性です。見せかけだけの書式設定は神話であり、このツールでは採用していません。
• ヒューリスティクスは言語に依存します。サポート対象外の言語に対する誠実な出力は pass ではなく manual_review です。何も示さないゼロでは、「問題が見つからなかった」と受け取られてしまいます。