# 结构化数据检测工具 输入页面网址，像浏览器在脚本运行后看到的那样读取其中的 JSON-LD。检测工具会列出每个 schema.org 类型，找出搜索引擎无法解析的代码块，并对照 Google 文档中的必需属性和建议属性检查每个项目。 ## 此工具检查什么 - JSON 语法错误: 每个 JSON-LD 代码块都会按搜索引擎的方式进行解析。带有多余逗号或引号的代码块会连同解析器的消息一起报告，因为搜索引擎会忽略整个代码块。 - schema.org 上下文: 没有 "@context": "https://schema.org" 的代码块会被标出，因为搜索引擎无法判断它们使用的是哪种词汇表。 - 每个项目，包括 @graph: 顶层和 @graph 内的项目，以及页面的 mainEntity 和 breadcrumb，每个都附有类型以及名称或标题。 - Google 的必需属性: 产品、文章、面包屑导航、组织、本地商家、活动、视频、食谱、软件应用、职位发布和网站名称（WebSite）项目，会对照 Google 标为必需的属性进行检查。 - 建议属性: Google 对每种富媒体搜索结果建议添加的属性，例如产品的 image 和 availability，或文章的 datePublished 和 author。 - 已停用的富媒体搜索结果: FAQPage 和 HowTo 项目会附上说明一并列出：Google 已不再显示这些富媒体搜索结果，因此这些标记不会再为页面带来此类结果。 - 由 JavaScript 添加的标记: 我们会先在 Chrome 中运行页面再读取，因此由脚本或代码管理器插入的 JSON-LD 也包括在内。 ## 它无法检查什么 - 无法保证获得富媒体搜索结果。是否显示由 Google 决定；有效的标记只能让页面具备资格。 - 无法检查 Google 指南中的每一条规则。有些规则取决于具体的值，例如图片尺寸、价格和日期格式；请以 Google 的富媒体搜索结果测试为准。 - 无法检查微数据或 RDFa 的属性。它们只按类型列出。 - 无法确认标记与页面显示的内容一致。Google 要求两者一致，而只有人才能对两者进行比对。 - 无法测试您输入的页面以外的页面。 ## 为什么重要 结构化数据以标准方式向机器描述页面：这是一件标价如此的产品，这是某位作者写的文章，这是网站背后的组织。Google 利用它来理解页面，并显示价格、评分和面包屑导航等富媒体搜索结果。 它的错误是无声的。损坏的 JSON-LD 代码块在页面上看起来毫无异常，缺少必需属性则会悄悄让项目失去获得相应富媒体搜索结果的资格。Search Console 会报告其中一部分问题，但仅限于 Google 已经抓取过的页面。 它不是进入 AI 回答的捷径。Google 表示，AI 概览（AI Overviews）和 AI 模式不需要任何特殊的 schema.org 标记。关键在于标记有效，并且与页面显示的内容一致。 ## 如何解读结果 - 有效的 JSON 或无法读取: 代码块能否被解析。无法读取的代码块会被完全忽略，无论其中包含什么。 - 缺少必需属性: 添加这些属性之前，该项目无法获得相应的富媒体搜索结果，Search Console 也会将其列为无效。 - 建议添加的属性: 该项目已具备资格；这些属性能让搜索结果更丰富。只添加真实且在页面上显示的值。 - 完整: 必需属性和建议属性都已具备。不过，它们的值仍需正确无误。 - 无富媒体搜索结果检查项: 有效的类型，例如 WebPage 或 ImageObject，但 Google 没有为它设定带必需属性的富媒体搜索结果。 - Google 已不再显示此类富媒体搜索结果: FAQ（自 2026 年 5 月 7 日起）和 How-to（自 2023 年 9 月起）。保留这些标记并无害处。 - a / b: 任一属性都能满足要求，例如产品的 offers / review / aggregateRating。 ## 如何修复最常见的问题 - 末尾多余的逗号或未转义的引号: 这是最常见的语法错误。把代码块粘贴到 JSON 验证工具中找出位置，并用反斜杠转义文本值中的双引号。 - 产品缺少 offers、review 或评分: Google 的产品摘要需要 name，以及 offers、review 或 aggregateRating 之一。网店平台通常会输出带价格和库存状态的 offers；如果您的平台没有，请检查主题或 SEO 应用。 - 有评分却没有数量: aggregateRating 需要 ratingValue，以及 ratingCount 或 reviewCount。只为访客能在页面上看到的评分添加标记：Google 的指南不允许为不可见的内容添加标记。 - 两个插件，两套标记: 主题、SEO 插件和应用都可能各自添加 Product 或 Organization 数据。值不相同的重复标记对谁都没有帮助：只保留一个来源，关闭其他来源。 - 没有网址的面包屑导航项: 每个 ListItem 都需要 item 网址（最后一项除外，它可以是当前页面）和 name，并且列表至少需要两项。 - 首页上的网站名称和组织: 在首页添加带 name 和 url 的 WebSite，告诉 Google 您网站的名称；再添加带 url、logo 以及指向官方主页的 sameAs 链接的 Organization。 ## 常见问题 ### 什么是 JSON-LD？ 一种把结构化数据写成 JSON 对象、放在 script 元素中的方式，与可见的 HTML 分开。只要您的环境允许，Google 就推荐使用它，因为这是最容易添加和维护的格式。 ### 为什么添加标记后看不到富媒体搜索结果？ Google 需要重新抓取页面，即便如此，它也会针对每次搜索决定是否显示富媒体搜索结果。即使标记通过了 Google 的测试，Google 也不保证一定会显示。 ### 结构化数据能提高排名吗？ Google 的文档把结构化数据描述为帮助理解内容、启用富媒体搜索结果的方式，而不是排名因素。富媒体搜索结果可以让搜索结果条目更醒目。 ### FAQ 标记还值得添加吗？ 就 Google 富媒体搜索结果而言不值得：Google 已于 2026 年 5 月 7 日停止显示此类结果。这些标记仍是有效的 schema.org，因此无需删除，但不要指望添加后能获得富媒体搜索结果。 ### 要出现在 AI 概览或 ChatGPT 中，需要 schema 标记吗？ Google 表示，AI 概览和 AI 模式不需要任何特殊的 schema.org 标记。其他 AI 服务没有公布相关要求。内容清晰、标记有效且准确，才是稳妥的做法。 ### 它和 Google 的富媒体搜索结果测试有什么不同？ 富媒体搜索结果测试是 Google 的权威参考工具，还会检查具体的值。本检测工具用通俗易懂的语言列出页面上的每个项目，显示每项缺少什么，并链接到对应的指南。 ## 来源 - [Google 搜索中心：结构化数据标记简介](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data) - [Google 搜索中心：结构化数据常规指南](https://developers.google.com/search/docs/appearance/structured-data/sd-policies) - [Google 搜索中心：结构化数据搜索库](https://developers.google.com/search/docs/appearance/structured-data/search-gallery) - [Google 搜索中心：AI 功能与您的网站](https://developers.google.com/search/docs/appearance/ai-features) - [Google 搜索中心：最新文档更新](https://developers.google.com/search/updates) - [Google：富媒体搜索结果测试](https://search.google.com/test/rich-results) - [Schema.org：Schema Markup Validator](https://validator.schema.org/)