免费工具 结构化数据检测:一个网页对机器说了什么
填一个网址,工具把页面上所有写给机器读的数据都提出来:每个 JSON-LD 块解析后按 Google 要求的属性检查,Microdata 和 RDFa 列出类型和属性,Open Graph、X 卡片标签决定链接分享时的预览,再加上常用 meta 标签。每一部分都能一键复制。
- JSON-LD、Microdata、RDFa
- Open Graph 和 X 卡片
- 经 check.tapcub.com
提取并检查结构化数据
填网址后点「检查」;还没上线的页面,切换到「粘贴 HTML」。
check.tapcub.com(TapCub 部署在 Cloudflare Workers 上的服务),由它从 Cloudflare 的网络去抓这个网页(8 秒超时、最多跟 5 次跳转、正文取前 512 KB),请求里带 From: tools@tapcub.com 表明来源,再把响应原样交回你的浏览器,所有分析都在浏览器里做。粘贴的 HTML 只在你的浏览器里分析,不会发出去。它不保存网页内容,日志只记域名、状态码和耗时,不记完整网址。额度:每个 IP 每分钟 10 次、每天 200 次。完整网址或只写域名和路径。
粘贴完整源码(查看网页源代码 → 全选 → 复制)。
JSON-LD 块
5
script 标签数
JSON-LD 条目
5
顶层对象,含 @graph 里的每一项
错误
1
影响富结果
注意
0
推荐属性或有风险的写法
Microdata 条目
0
itemscope 元素
RDFa 条目
0
typeof 元素
JSON-LD 条目
| 块 | @type | @id 或名称 | 状态 |
|---|---|---|---|
| 1 | Organization | TapCub | 通过 |
| 2 | WebSite | TapCub | 通过 |
| 3 | BreadcrumbList | — | 通过 |
| 4 | WebApplication | UTM 链接生成器:UTM 参数一次配好 | 1 个错误 |
| 5 | FAQPage | — | 通过 |
检查项
错误排在前面,行号对应网页源代码。
- 错误第 41 行WebApplication:aggregateRating / review 至少要有一个。
- 说明第 42 行FAQPage:标记本身有效,但 Google 已于 2026 年 5 月 7 日起对所有网站停止展示 FAQ 富结果。只有其它用途需要时才保留。
- 通过Open Graph 的 4 个必填属性都有。
- 通过第 38 行Organization:必填属性齐全,可以参与 Google 富结果。是否展示仍由 Google 决定。
- 通过第 40 行BreadcrumbList:面包屑有效。2025 年 1 月起 Google 只在电脑端结果显示面包屑,手机端只显示域名。
<!-- 1 / 5 -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "TapCub",
"url": "https://tapcub.com",
"logo": "https://tapcub.com/assets/img/logo-mark.svg"
}
</script>
<!-- 2 / 5 -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "TapCub",
"url": "https://tapcub.com",
"inLanguage": "zh-CN"
}
</script>
<!-- 3 / 5 -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "首页",
"item": "https://tapcub.com/zh/"
},
{
"@type": "ListItem",
"position": 2,
"name": "工具",
"item": "https://tapcub.com/zh/tools"
},
{
"@type": "ListItem",
"position": 3,
"name": "网站统计与埋点",
"item": "https://tapcub.com/zh/tools/analytics"
},
{
"@type": "ListItem",
"position": 4,
"name": "UTM 生成器",
"item": "https://tapcub.com/zh/tools/utm"
}
]
}
</script>
<!-- 4 / 5 -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebApplication",
"name": "UTM 链接生成器:UTM 参数一次配好",
"description": "UTM 参数在线生成:填好 utm_source、utm_medium、utm_campaign 等参数配置,生成推广链接,带百度、微信、抖音等常用预设,自动转小写,一键复制。",
"url": "https://tapcub.com/zh/tools/utm",
"applicationCategory": "BusinessApplication",
"operatingSystem": "Any",
"browserRequirements": "Requires JavaScript",
"isAccessibleForFree": true,
"offers": {
"@type": "Offer",
"price": "0",
"priceCurrency": "USD"
},
"softwareVersion": "2.0",
"datePublished": "2026-10-04",
"dateModified": "2026-11-12",
"inLanguage": "zh-CN"
}
</script>
<!-- 5 / 5 -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "UTM 参数是什么?",
"acceptedAnswer": {
"@type": "Answer",
"text": "UTM 参数是加在网址 ? 后面的 5 个标签:utm_source(来源)、utm_medium(媒介)、utm_campaign(活动)、utm_term(关键词)、utm_content(内容)。访客点链接进站时,统计工具读这几个值,把这次访问记到对应的渠道和活动下。微信内打开、短信、二维码这类没有来源页的流量,几乎只能靠 UTM 区分。"
}
},
{
"@type": "Question",
"name": "utm_source 等参数怎么配置?",
"acceptedAnswer": {
"@type": "Answer",
"text": "按「谁发的、什么渠道、哪次活动」来填,并且全组统一写法:公众号推文 utm_source=wechat&utm_medium=social ,短信 utm_source=sms&utm_medium=sms ,百度搜索广告 utm_source=baidu&utm_medium=cpc ,再加上 utm_campaign=double11_2026 这类活动名。取值用英文小写和下划线,中文会被编码成一长串 %XX,不好读。完整约定见上面的命名表。"
}
},
{
"@type": "Question",
"name": "哪些参数是必填的?",
"acceptedAnswer": {
"@type": "Answer",
"text": "utm_source 必填,报表靠它归类流量;utm_medium 强烈建议填。campaign、term、content 可选,随报表需求逐步补上。"
}
},
{
"@type": "Question",
"name": "UTM 参数会影响 SEO 吗?",
"acceptedAnswer": {
"@type": "Answer",
"text": "用在对外分享的链接上不会。给落地页加上 canonical 标签,搜索引擎就会把带参数和不带参数的版本合并。"
}
},
{
"@type": "Question",
"name": "广告平台已经带点击 ID 了,还要加 UTM 吗?",
"acceptedAnswer": {
"@type": "Answer",
"text": "要,两者都加。gclid、ttclid 这类点击 ID 标识平台;UTM 带上你自己起的活动和素材名。TapCub 两种都读。"
}
},
{
"@type": "Question",
"name": "带参数的链接可以缩短吗?",
"acceptedAnswer": {
"@type": "Answer",
"text": "可以。先生成完整链接再缩短,确认一次短链服务保留了查询串。"
}
},
{
"@type": "Question",
"name": "UTM 的取值区分大小写吗?",
"acceptedAnswer": {
"@type": "Answer",
"text": "大多数统计工具区分。比如 GA4 会把 Email 和 email 当成两个不同的媒介。所以生成器默认把取值转成小写;只有当你已有的报表沿用了别的写法时,才需要关掉规范化。"
}
}
]
}
</script>全部块整理好缩进,可直接粘到结构化数据校验器里。
Microdata 和 RDFa
只列类型和属性名,不校验取值。
Open Graph 和 X(Twitter)标签
| 属性 | 内容 | 写法 | 行 |
|---|---|---|---|
og:url | https://tapcub.com/zh/tools/utm | property | 14 |
og:type | website | property | 17 |
og:site_name | TapCub | property | 18 |
og:title | UTM 参数配置与 UTM 链接生成器(utm_source 等) | TapCub | property | 19 |
og:description | UTM 参数在线生成:填好 utm_source、utm_medium、utm_campaign 等参数配置,生成推广链接,带百度、微信、抖音等常用预设,自动转小写,一键复制。 | property | 20 |
og:image | https://tapcub.com/assets/img/og/zh/tools-utm.jpg | property | 21 |
og:image:width | 1200 | property | 22 |
og:image:height | 630 | property | 23 |
og:image:alt | UTM 参数配置与 UTM 链接生成器(utm_source 等) | TapCub | property | 24 |
og:locale | zh_CN | property | 25 |
twitter:card | summary_large_image | name | 26 |
twitter:title | UTM 参数配置与 UTM 链接生成器(utm_source 等) | TapCub | name | 27 |
twitter:description | UTM 参数在线生成:填好 utm_source、utm_medium、utm_campaign 等参数配置,生成推广链接,带百度、微信、抖音等常用预设,自动转小写,一键复制。 | name | 28 |
<meta property="og:url" content="https://tapcub.com/zh/tools/utm">
<meta property="og:type" content="website">
<meta property="og:site_name" content="TapCub">
<meta property="og:title" content="UTM 参数配置与 UTM 链接生成器(utm_source 等) | TapCub">
<meta property="og:description" content="UTM 参数在线生成:填好 utm_source、utm_medium、utm_campaign 等参数配置,生成推广链接,带百度、微信、抖音等常用预设,自动转小写,一键复制。">
<meta property="og:image" content="https://tapcub.com/assets/img/og/zh/tools-utm.jpg">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="UTM 参数配置与 UTM 链接生成器(utm_source 等) | TapCub">
<meta property="og:locale" content="zh_CN">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="UTM 参数配置与 UTM 链接生成器(utm_source 等) | TapCub">
<meta name="twitter:description" content="UTM 参数在线生成:填好 utm_source、utm_medium、utm_campaign 等参数配置,生成推广链接,带百度、微信、抖音等常用预设,自动转小写,一键复制。">常用 meta
| 标签 | 值 | 行 |
|---|---|---|
<title> | UTM 参数配置与 UTM 链接生成器(utm_source 等) | TapCub | 6 |
meta description | UTM 参数在线生成:填好 utm_source、utm_medium、utm_campaign 等参数配置,生成推广链接,带百度、微信、抖音等常用预设,自动转小写,一键复制。 | 7 |
meta robots | max-image-preview:large | 9 |
meta viewport | width=device-width, initial-scale=1 | 5 |
meta theme-color | #ffffff | 29 |
meta application-name | TapCub | 34 |
meta charset | utf-8 | 4 |
html lang | zh-CN | — |
link canonical | https://tapcub.com/zh/tools/utm | 10 |
link hreflang | 3 | — |
分享这组输入:数值写在链接的 # 后面,不会发到服务器。
https://tapcub.com/zh/tools/structured-data-extractor
版本 v1.0更新于 更新记录
报告里每一部分是什么
最上面是统计,下面每种格式一块,没有内容的块不显示。
JSON-LD 条目和检查项
每个 script 块单独解析,语法错误给出在网页源码里的行号。条目按 Google 各功能指南里的必填、推荐属性检查,规则和结构化数据校验器相同。
Microdata 和 RDFa
按类型列出,后面是条目里找到的属性名,嵌套条目缩进显示。不校验取值,这两种格式的取值用 Google 富媒体搜索结果测试检查。
Open Graph 和 X 卡片
Facebook、LinkedIn、X 和多数聊天软件生成链接预览时读的标签。Open Graph 必填 og:title、og:type、og:image、og:url;X 的多数字段会回退读 Open Graph,但卡片类型要靠 twitter:card。
常用 meta
标题、描述、robots、viewport、canonical、语言和 hreflang 数量,方便对照这些基础信息和结构化数据是否一致。
结构化数据有效,只说明页面有资格获得富结果,不保证一定展示。Google 还要求标记描述的是页面上看得见的内容。
审查一个页面的结构化数据
换主题、更新插件之后,或者富结果突然消失时用它排查。
-
1
填网址
选一个应该有富结果的页面:商品、文章、菜谱、门店页。
-
2
点检查
抓一次网页,交给浏览器解析。测试环境的页面改用「粘贴 HTML」。
-
3
先看错误
语法错误会让整个块对 Google 不可见;缺必填属性的条目拿不到富结果。
-
4
复制、修改
复制格式化好的 JSON-LD,到结构化数据校验器里改好,上线后再查一次,最后用 Google 富媒体搜索结果测试确认。
提取什么、怎么提取
一切都从服务器返回的 HTML 里读,不执行 JavaScript,所以脚本或跟踪代码管理器后插入的标记不会出现在这里。
- JSON-LD:每个
<script type="application/ld+json">;顶层数组和@graph拆成单独的条目 - Microdata:带
itemscope的元素,类型取itemtype,属性是属于这个条目的itemprop(嵌套条目单独一行) - RDFa:带
typeof的元素及其中的property名称;Open Graph 的property="og:…"meta 单独列出 - Open Graph 和 X:
property或name以 og:、twitter:、article:、fb:、profile:、product: 开头的<meta>
| 格式 | 写在哪里 | Google 支持情况 |
|---|---|---|
| JSON-LD | 单独的 script 块,和可见 HTML 分开 | 支持,推荐 |
| Microdata | 写在可见 HTML 元素的属性上 | 支持 |
| RDFa | 写在可见 HTML 元素的属性上 | 支持 |
| Open Graph | head 里的 meta 标签 | 对 Google 不算结构化数据,社交平台用 |
示例:本站的一个工具页
默认结果是 2026-11-17 抓取的 https://tapcub.com/zh/tools/utm。
| 部分 | 找到的内容 | 解读 |
|---|---|---|
| JSON-LD | 5 个块:Organization、WebSite、BreadcrumbList、WebApplication、FAQPage | 工具页的常见组合 |
| 错误 | 1 个:WebApplication 没有 aggregateRating 或 review | Google 的软件应用富结果需要评分;我们不写没有的评分,这个页面就不参与这类富结果 |
| 说明 | FAQPage | 标记有效,但 Google 已于 2026 年 5 月 7 日起对所有网站停止展示 FAQ 富结果 |
| Open Graph 和 X | og: 的 4 个必填属性齐全 | 链接预览信息完整 |
错误不一定都要改:它告诉你这个页面拿不到哪种富结果、为什么。值不值得改,看那种富结果对你有没有用。
结构化数据为什么会失效
多数问题出在模板和插件,不在手写的代码。
两个插件输出两套标记
SEO 插件和主题都输出 Organization 或 Product,取值还不一样。只留一个来源。
只靠 JavaScript 插入
Google 能渲染,但很多爬虫和其它读取方只看 HTML。服务端直接输出 JSON-LD 最稳。
标记了页面上没有的东西
评分、价格、问答写在标记里,访客却看不到,违反 Google 的结构化数据指南。
og:image 写相对路径
社交平台需要图片的完整 https 地址,写相对路径常常导致预览没有图。
看标记带来了什么
富结果会改变点击率。TapCub 把搜索点击和访问放在一起,方便对比改标记前后的变化。
怎么查一个网页的结构化数据?
在上面填网址、点「检查」。工具抓下网页,列出全部 JSON-LD 块、Microdata 和 RDFa 条目、Open Graph 和 X 卡片标签,JSON-LD 的错误和注意项附行号。
和 Google 富媒体搜索结果测试一样吗?
不一样。Google 的测试用 Googlebot 渲染页面,告诉你能获得哪些富结果;本工具读服务器返回的 HTML,把几种格式并排列出,并按 Google 文档里的属性检查 JSON-LD。先用它快速找问题,再到 Google 的测试里确认。
为什么这里看不到我的 JSON-LD?
如果它是 JavaScript 或跟踪代码管理器后插入的,服务器返回的 HTML 里就没有,本工具读不到。Google 渲染后也许能看到,但服务端直接输出更可靠。
该用哪种格式?
Google 三种都支持,推荐 JSON-LD:它和可见 HTML 分开写,维护起来容易。
Open Graph 算结构化数据吗?
不算 schema.org 意义上的结构化数据,Google 也不用它做富结果。社交网络和聊天软件靠它生成链接预览,所以和其它机器可读数据一起列在这里。百度对 Open Graph 没有公开说明。
还没上线的页面能查吗?
能。把「来源」切换成「改为粘贴 HTML」,粘贴页面源码。粘贴的内容只在浏览器里分析,不会发出去。