语音搜索 / 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,而不要依赖工具对标签位置的猜测,后者在改版后可能悄悄失效。

📊 这个页面有多准确?

点一个表情来评分 — 然后看看大家的想法。

0%

无法保存你的投票 — 请重试。

2