Schema 标记验证工具:检查单个页面或整个网站的结构化数据
结构化数据以搜索引擎无需猜测就能读懂的形式,告诉它们页面的内容:这是一款产品,这是它的价格,这是作者。Schema 标记验证工具会读取这些标记,告诉您它能否被解析、词汇使用是否正确,以及是否完整到足以获得某项搜索功能。测试一个页面很容易。拥有数千个模板化页面的网站,则需要在所有页面上运行同样的测试。
Schema 标记验证工具检查什么
验证分四个层次,每个层次发现不同类型的问题:
- 语法。JSON-LD 能否被解析?每个微数据属性是否都在某个条目中?少一个逗号或一个未转义的引号,就可能让整个代码块无法读取。
- 词汇。类型和属性是否是真正的 Schema.org 术语,并用在它们所属的类型上?拼错的属性是有效的 JSON,但没有任何意义。
- 功能要求。Google 为它支持的每种富媒体搜索结果都说明了必需属性和推荐属性。标记可以是有效的 Schema.org,却仍然缺少 Google 显示产品摘要或活动信息所需的某个属性。
- 与页面一致。Google 的结构化数据指南要求标记描述访问者能看到的内容。标记中的价格不在页面上,或标题与可见标题不同,这是任何语法检查都发现不了的质量问题。
大多数单页面工具覆盖前三个层次。第四个层次需要把标记和渲染后的页面并排对比。
Schema.org 验证工具与 Google 富媒体搜索结果测试
有两款免费工具可以一次测试一个页面,它们回答的是不同的问题。Google 的结构化数据简介建议在构建过程中使用富媒体搜索结果测试。
| Schema Markup Validator | 富媒体搜索结果测试 | |
|---|---|---|
| 开发方 | Schema.org | |
| 每次测试的页面数 | 1 | 1 |
| URL 或粘贴的代码 | ✓ | ✓ |
| JSON-LD、微数据、RDFa | ✓ | ✓ |
| 完整的 Schema.org 词汇 | ✓ | – |
| Google 富媒体搜索结果资格 | – | ✓ |
| 缺少必需属性 | – | ✓ |
| 结果预览 | – | ✓ |
Schema Markup Validator 取代了 Google 旧的结构化数据测试工具。用它来确认标记是否是正确的 Schema.org,包括那些用于知识面板或 AI 回答、但没有富媒体搜索结果的类型。目标是某项具体的 Google 功能时,请使用富媒体搜索结果测试。两者都不能一次测试整个网站。SEO ProCheck 介绍了如何用这两款工具调试失效的富媒体搜索结果。
JSON-LD、微数据与 RDFa
Google 能读取这三种格式,并表示只要有效就同样可行,但推荐 JSON-LD,因为它位于一个独立于 HTML 的 script 代码块中,最容易在各个模板中保持正确。一个最简单的 Product 代码块如下:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"image": "https://www.example.com/shoe.jpg",
"offers": {
"@type": "Offer",
"price": "89.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>
微数据和 RDFa 把同样的信息写在可见 HTML 的属性中。这让标记紧贴内容,但对 HTML 的一次模板修改就可能悄悄破坏它。无论使用哪种格式,每个条目只用一种;用两种格式描述同一个产品两次,很容易导致两者不一致。
常见的结构化数据错误
- JSON 损坏。末尾多余的逗号、从文档中粘贴过来的弯引号,或字符串中的原始换行符。
- 缺少 @context 或 @type。没有它们,解析器就不知道这个代码块描述的是什么。
- 缺少必需属性。见下表。
- 标记与页面不一致。页面上的价格变了,标记中的却没变。
- 过时的值。priceValidUntil 已过期的优惠,或 dateModified 早于 datePublished。
几种常见功能的必需属性,来自 Google 的搜索库:
| 类型 | Google 要求的属性 |
|---|---|
| 产品摘要 | name,加上 offers、review 或 aggregateRating |
| Event | name、startDate、location |
| Recipe | name、image |
| BreadcrumbList | itemListElement:name、position、item |
| Article | 0(全部为推荐属性) |
有些标记虽然有效,但已不再像以前那样带来回报:
| 标记写法 | 变化 | 起始时间 |
|---|---|---|
| data-vocabulary.org | 不再支持 | 2021 |
| HowTo | 不再显示富媒体搜索结果 | 2023 年 9 月 |
| FAQPage | 仅限政府和健康类网站 | 2023 年 8 月 |
| FAQPage | 不再显示富媒体搜索结果 | 2026 年 5 月 |
为什么只看一个页面不够
结构化数据几乎总是由模板生成的。一旦出错,就会在该模板提供的每个页面上出错,或者在某个字段为空的那部分页面上出错。测试您碰巧打开的那个产品页,看不出有 300 个产品因为价格字段是区间而没有价格,也看不出某位作者的文章都没有 author 标记。
有三件事只有在整个网站范围内才会显现:
- 覆盖范围。哪些页面组带有标记,以及组内哪些页面缺少同组其他页面都有的标记。
- 边缘情况。空字段、特殊字符,以及只有部分记录才有的值。
- 漂移。上线时有效、某次发布后失效的标记。正是出于这个原因,Google 的文档建议在部署后关注富媒体搜索结果报告。
如何在整个网站上验证 Schema 标记
- 抓取网站,从每个 HTML 页面提取结构化数据。如果有些标记由 JavaScript 注入,也请渲染页面,具体见 JavaScript SEO 爬虫指南。
- 先修复语法错误。无法解析的代码块,其他内容都无从检查。
- 按模板对页面分组,列出每组带有的类型。找出缺少同组大多数页面都有的类型的页面。
- 检查必需属性,针对您想要的功能,然后检查推荐属性。
- 把标记与可见文本对比:名称、标题和价格都应该出现在页面上。
- 在富媒体搜索结果测试中抽查每个模板的一个页面,确认 Google 看到的内容。
- 每次发布后关注 Search Console:富媒体搜索结果报告和「网址检查」会显示 Google 在自己的抓取中发现了什么。
结构化数据是技术 SEO 诊断检查清单中的一步,干净的标记也有助于 AI 系统读懂页面,AI SEO 爬虫指南对此有说明。
用 Neova 验证结构化数据
Neova 的「结构化数据」类别会把每个页面上的 Schema 标记标为有效、有警告或有错误,添加「Schema 类型」列,并在 URL 面板中对每种类型给出结论。它会读取抓取中每个 HTML 页面的 JSON-LD、微数据和 RDFa。部分检查项:
- 结构化数据有语法错误,针对无法解析或缺少 @context 或 @type 的 JSON-LD
- 结构化数据缺少必需属性或与可见文本不一致,针对 Google 有文档说明的功能
- 结构化数据缺少推荐属性,也会标记 data-vocabulary.org 标记
- 结构化数据中的 Product 价格未显示在 HTML 页面上和Offer 的 priceValidUntil 日期已过
- 结构化数据、站点地图 lastmod 或 Last-Modified 中的日期相互矛盾
- 缺少页面组中常见的结构化数据类型和HTML 页面缺少其页面组普遍带有的富媒体搜索结果标记
- Organization 或 Person 标记缺少识别属性
- HTML 页面没有结构化数据,如果抓取进行了渲染,也会读取渲染后的 HTML
- 富媒体搜索结果无效,来自 Google Search Console 的「网址检查」
由于 Neova 根据 HTML 识别页面组,模板问题会显示为一个带有相同标记的组,而不是成千上万行单独的记录。关于类型和格式的其他问题,SEO ProCheck 的 Schema 标记常见问题中有解答。请查看功能或下载 Neova;免费套餐每次抓取 1,000 个 URL,运行所有检查项。
常见问题
什么是 Schema 标记验证工具?
一种读取页面上结构化数据(JSON-LD、微数据或 RDFa)的工具,检查它能否被解析、是否正确使用了 Schema.org 类型和属性,有些工具还会检查它是否具备某项搜索功能所需的内容。
Schema Markup Validator 和富媒体搜索结果测试有什么区别?
validator.schema.org 上的 Schema Markup Validator 按完整的 Schema.org 词汇检查标记。Google 的富媒体搜索结果测试检查页面有资格获得哪些 Google 富媒体搜索结果,以及缺少哪些必需或推荐属性。
有效的结构化数据能保证获得富媒体搜索结果吗?
不能。Google 表示,有效的标记只是让页面具备资格,而不是保证。是否显示富媒体搜索结果,由 Google 根据查询、页面及其质量指南来决定。
可以在整个网站上验证 Schema 标记吗?
用单页面工具不行。能在每个页面上提取并检查结构化数据的爬虫,可以发现模板问题、缺失的标记以及与同组页面不一致的页面,然后您再在富媒体搜索结果测试中按每个模板抽查一个页面。
应该使用哪种结构化数据格式?
Google 能读取 JSON-LD、微数据和 RDFa,并推荐 JSON-LD,因为它位于独立于 HTML 的一个代码块中,最容易维护。