音声検索 / GEO / AEO
Speakable 構造化データ検証ツール
speakable の JSON-LD（またはページ全体）を貼り付けると、SpeakableSpecification の構造、cssSelector の構文と一致状況、非表示・空の選択範囲、範囲が広すぎるセレクター、自然に読み上げられる要約に適した語数かどうかまで、実際の仕様に基づいてチェックします。まだ設定されていない場合は、たたき台となるセレクターも提案します。
すべてブラウザ内で完結します。ここに貼り付けた内容は、匿名の利用回数を除き、どこにも送信されません。
<script type="application/ld+json"> ブロックの中身、またはページ全体の HTML を貼り付けてください。"speakable" プロパティは自動的にすべて検出されます。ページ全体を貼り付ける（JSON-LD だけでなく）と、各セレクターが実際のコンテンツと一致するか、非表示になっていないか、何語が読み上げられるかまでチェックできます。
このツールがチェックする内容と、よくある間違いの直し方
"speakable" の SpeakableSpecification は、音声アシスタントや回答エンジンに対して、ページのどの部分を読み上げるべきかを正確に伝えます——通常は記事全体ではなく、見出しと短いリード段落一つです。このツールはクローラーと同じ方法で JSON-LD のグラフをたどり、どこにあっても "speakable" プロパティをすべて見つけ出し、その構造を検証します。オブジェクト（またはオブジェクトのリスト）であり、少なくとも一つの空でない "cssSelector" または "xpath" を持つ必要があります。
Google の現行実装では "cssSelector" のみが読み取られます——"xpath" は schema.org 仕様上は有効ですが、Google では対応していません。そのためこのツールは、xpath のみの仕様を致命的エラーではなく互換性の警告として扱います。他の利用者向けに xpath をすでに提供している場合でも、同等の cssSelector を少なくとも一つ残してください。
ページ全体（JSON-LD だけでなく）を貼り付けると、各セレクターが実際の DOM に対して実行されます。何にも一致しないセレクターはエラーです（読み上げる内容がありません）。一致した要素がインラインスタイル、スタイルシートのルール、"aria-hidden"、または "hidden" 属性によって非表示になっている場合もエラーです。ID セレクターが複数の要素に一致する場合は、通常マークアップ内に id の重複があります。
自然に聞こえる結果にするには語数も重要です。非常に短い選択範囲（5語未満）は内容が薄いとして警告され、非常に長い選択範囲（70語超、またはページの総テキストの大部分）も警告されます。実質的に記事全体である「要約」は要約の意味を失い、読み上げると不自然に聞こえることがあるためです——本当に短く、単独で成立する要約を選んでください。
speakable のマークアップがまったく存在せず、ページ全体の HTML を貼り付けた場合、このツールはページ自身の見出しと最も短いリード段落から出発点となるセレクターを提案し、すぐに編集できる JSON-LD スニペットも提示します。安定した "id" 属性から作られたセレクターは、より信頼できる選択としてマークされます。タグの位置に頼った推測はリニューアル後に気づかないうちに壊れることがあるため、見出しや要約の要素には id を追加することをおすすめします。