ToolboxAgent

JSON-LD 结构化数据校验器

校验 JSON-LD 结构化数据语法与 schema.org 必填字段,支持 Article、Product、FAQ、Breadcrumb、HowTo、Organization 等 12+ 类型,并生成可直接嵌入网页的脚本。

等待处理

使用说明

  1. 1 粘贴 JSON-LD 文本,或从「生成器」选择类型并填写字段
  2. 2 查看语法错误、字段缺失警告和富结果预览
  3. 3 复制校验后的 JSON-LD 脚本,嵌入到网页 head 中

相关工具

关于此工具

JSON-LD 是 Google 推荐的结构化数据格式,通过在网页中嵌入一段 JSON 告诉搜索引擎「这是一个产品」「这是一篇教程」,从而在搜索结果中获得富媒体展示(星级、价格、面包屑、FAQ 折叠)。错误的 JSON-LD 会导致富结果失效甚至触发手动操作处罚。

本工具校验两层:JSON 语法本身(解析错误、引号缺失、尾逗号等),以及 schema.org 规范(@context、@type、各类型的必填字段,例如 Article 需要 headline、author、datePublished;Product 需要 name 和 offers;FAQPage 的 mainEntity 必须是 Question 数组)。校验通过后展示富结果的预览效果。

如果不会手写 JSON-LD,使用「生成器」选择类型、填表,即可得到一份合规的 JSON-LD 脚本,复制到网页 head 中即可生效。

常见问题

这个工具和 Google 官方的富结果测试工具有什么区别? +

Google 富结果测试(search.google.com/test/rich-results)只能在线提交 URL 测试,且只检查 Google 自己支持的类型。本工具在浏览器本地运行,可以直接粘贴 JSON-LD 片段,无需部署到线上;覆盖更多 schema.org 类型,且能本地预览富结果样式。建议先用本工具本地校验通过,再提交到 Google 官方工具做最终验证。

JSON-LD、Microdata、RDFa 三选一用哪个? +

推荐 JSON-LD。Google 官方明确表示 JSON-LD 是首选方式,因为它把结构化数据从 HTML 标记中解耦,维护方便。Microdata 需要在 HTML 标签上加 itemprop,会让模板代码变乱;RDFa 在 SEO 圈已几乎废弃。本工具只处理 JSON-LD。

@type 写错了会怎样? +

如果写成 Schema.org 不认识的类型,Google 会忽略整段结构化数据;如果是大小写错误(如 article 而不是 Article),同样无效。本工具内置 12+ 种常见类型的白名单,遇到拼写错误会给出建议。完整类型列表见 schema.org/docs/full。

FAQPage 的 mainEntity 为什么必须用 Question 数组? +

schema.org 规范要求 FAQPage.mainEntity 是 Question 对象的数组,每个 Question 又有 acceptedAnswer(Answer 对象)。少一层嵌套、用错字段名都会让 Google 不识别。本工具会校验嵌套结构并给出错误定位。

为什么我的 JSON-LD 看起来正确但 Google 还是没显示富结果? +

可能原因:1) 站点整体质量不够,Google 暂时不信任;2) 该类型富结果只在部分国家/语言生效(如 HowTo 仅英文);3) 结构化数据与页面可见内容不一致(Google 会交叉验证);4) 触发了人工审核拒绝。可用 Google Search Console 的「人工操作」报告确认。