在线检测网页 JSON-LD 结构化数据:逐段验证 JSON 语法、必填字段、@context 与内容一致性;支持 Organization、Article、FAQPage 等多种代码在线生成。
输入任意网页地址,检查它给搜索引擎的「结构化数据」写得对不对:JSON 能否解析、必填字段是否齐全、内容与页面是否一致,并给出 100 分制评分。检测不到时会直接告诉你该补哪类代码 —— 下一节的生成器可以直接用。
选抓取身份:部分站点的 CDN / WAF 会按 UA 放行,用搜索引擎 UA 才能拿到「爬虫真正看到的那份 HTML」。单次检测抓取总量 ≤ 300KB,结果缓存 10 分钟。
选一个类型,填几个字段,代码实时生成。复制后按下面的方法加到网站里。
「复制完整代码」得到的是 <script type=”application/ld+json”>…</script> 整段,可直接粘贴;「只复制 JSON」适合粘进已有代码块里合并。
| 检查项 | 说明 |
|---|---|
| JSON 可解析性 | 每一段 <script type=”application/ld+json”> 单独解析。JSON 少个逗号、多个尾逗号,整段代码就被搜索引擎直接丢弃 —— 这是「明明写了却没效果」的头号原因。 |
| 必填字段 | 按 schema.org 类型逐项校验 required 字段(如 Article 需要 headline / image / datePublished / author)。缺一个,对应的富结果就拿不到。 |
| 建议字段 | recommended 字段缺失只提示不计硬伤 —— 不给只是拿不到加分项。 |
| 内容一致性 | FAQPage 的问题会与页面正文比对:结构化数据里写了、页面上却不展示,属于 Google 明令禁止的手法,有被人工处罚的风险。 |
| 格式规范 | @context 是否为 schema.org、URL 是否绝对地址、日期是否符合 ISO 8601、headline 是否超过 110 字符。 |
| 实体冲突 | Organization、WebSite 等身份类型出现多段(主题和 SEO 插件各输出一份是常见原因),字段不一致时搜索引擎会困惑。 |
| 评分与建议 | 100 分制评分(存在与可解析 25 + 身份类型 20 + 内容类型 25 + 字段质量 20 + 技术规范 10),缺什么类型会直接给出「用生成器补哪类」的建议。 |
网页上的人读的是文字,搜索引擎除了读文字,还想读「这段文字是什么」:这是一篇文章还是一件产品?作者是谁?价格多少?有几个常见问题?结构化数据就是把答案用约定好的词表(schema.org)明确写出来,让机器不用猜。
写法有三种:microdata(把标记揉进 HTML 标签里)、RDFa、以及 JSON-LD(单独一个 script 块,与页面结构完全分离)。Google 官方文档明确推荐 JSON-LD,原因很实际:它不碰你的 HTML 结构,改版、换主题都不容易坏,加错了也只是删掉一段代码的事。
搜索结果里的评分星、价格、面包屑路径、FAQ 折叠展开、站内搜索框,背后都依赖结构化数据。要说明的是:加了不保证一定展示 —— Google 会按查询意图、设备、算法自行决定是否展示富结果;但不加是肯定没有的。此外,清晰的实体信息也在帮助 AI 搜索引擎(如 AI Overviews、ChatGPT 搜索)更准确地引用你的内容。
三种常见方式,按推荐顺序:
① 主题 / SEO 插件自动输出:Rank Math Seo、Yoast 等会自动给文章加 Article、给站点加 WebSite / Organization。先用本工具检测一遍是否真的输出了、字段齐不齐。
② WPCode 添加自定义代码:用本页生成器做出代码,复制完整代码(含 script 标签),新建一个 PHP 片段:
add_action( 'wp_head', function () {
if ( is_single( 123 ) ) { // 只在需要的页面输出
echo '<script type="application/ld+json">{...粘贴你的 JSON...}</script>';
}
} );
③ Elementor或古腾堡编辑器的 HTML 模块:单页临时使用时,把完整代码放进 HTML 小部件即可,注意别放进需要渲染样式的区域。
重要提醒:同一个实体不要输出多份不一致的代码。常见事故是主题输了一份 Organization、插件又输出一份,两份 logo 或 name 不一样,反而降低机器的理解信心。加了新代码后用本工具重新检测一遍。
| 问题 | 后果与处理 |
|---|---|
| JSON 语法错误(少逗号 / 多尾逗号 / 引号没转义) | 整段被丢弃,页面看起来「什么都有」实际什么都没生效。本工具会逐段标红并给出解析错误原因。 |
| 缺 @context 或写错词表 | 搜索引擎不知道字段含义,整段忽略。固定写 "@context": "https://schema.org"。 |
| FAQ 写进代码但页面不展示 | 结构化数据必须与页面可见内容一致,只写不展示属于违规手法,有被人工处罚的风险。要么把问答真实展示出来,要么删掉。 |
| Organization / WebSite 多份冲突 | 主题和 SEO 插件各输出一份。保留一份最完整的,其余去掉。 |
| 图片 / 链接用了相对地址 | 部分场景下搜索引擎拼不出完整链接,image 用 https:// 开头的完整地址。 |
| 日期不是 ISO 8601 | 富结果不显示日期。写成 2026-06-01 或带时间的完整格式。 |
| 分项 | 分值 | 判断标准 |
|---|---|---|
| 存在与可解析 | 25 | 页面有 JSON-LD 且全部能解析;有解析失败的段扣到 12 分;完全没有记 0 分 |
| 身份类型 | 20 | Organization / WebSite / LocalBusiness 至少其一且必填齐全;有声明但缺必填记 12 分 |
| 内容类型 | 25 | Article / Product / Service / FAQPage / BreadcrumbList 等至少其一且必填齐全 |
| 字段质量 | 20 | 从满分扣:格式类警告每条 -4,建议项每条 -2 |
| 技术规范 | 10 | @context 问题每处 -5;与 microdata 混用 -2(不算错,建议统一) |
等级:A ≥ 90 / B ≥ 75 / C ≥ 60 / D < 60。等级只反映「机器读懂这段页面的容易程度」,不影响排名本身。