schema · 让网页结构化数据与页面事实一致

作者提供的示例，实际效果取决于你的输入和使用工具。

输入

示例站点 https://example.com；可见导航：首页 > 教程 > 图片压缩；路径 /guides/image-compression。

输出

编辑示例 · 未运行

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type":"ListItem","position":1,"name":"首页","item":"https://example.com/"},
    {"@type":"ListItem","position":2,"name":"教程","item":"https://example.com/guides"},
    {"@type":"ListItem","position":3,"name":"图片压缩","item":"https://example.com/guides/image-compression"}
  ]
}

选择合适的 schema 类型并检查 JSON-LD 字段，帮助搜索系统理解页面。

具体任务

给真实页面补结构化数据：按页面可见事实选 Organization、Article 或面包屑等类型并写 JSON-LD。

排查标记和正文不一致：核对必需字段、链接及嵌套关系，列出验证器要检查的问题。

必需材料

页面实际内容与 canonical URL

目标页面类型和现有标记

可选材料

站点技术栈

搜索平台验证结果

使用门槛

对页面正文与实体信息有可核实的来源。

这个 Skill 额外提供的方法

把代码与事实逐字段对照，既便于开发接入，也便于内容维护。

编辑示例（未运行）

为教程页补面包屑标记

任务：让首页到教程页的层级与导航保持一致。

输入：
示例站点 https://example.com；可见导航：首页 > 教程 > 图片压缩；路径 /guides/image-compression。

结果片段：
```json
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type":"ListItem","position":1,"name":"首页","item":"https://example.com/"},
    {"@type":"ListItem","position":2,"name":"教程","item":"https://example.com/guides"},
    {"@type":"ListItem","position":3,"name":"图片压缩","item":"https://example.com/guides/image-compression"}
  ]
}
```

使用保留示例域名演示实际 JSON-LD；上线时须换成真实 canonical 地址。 此为编辑示例，未安装或运行上游 Skill。

首次任务

根据【页面内容】和【canonical URL】写【类型】JSON-LD，并列验证步骤；验收：字段可回查到页面事实，无虚构评分，层级和可见导航一致。
必需材料：页面实际内容与 canonical URL：【请填写或粘贴】；目标页面类型和现有标记：【请填写或粘贴】

验收方法

JSON 是否可解析且类型层级正确

URL 与 canonical 和可见导航是否一致

是否用当前官方工具检查相关富结果支持

依赖与准备

可编辑网页模板或 CMS 的权限；验证需要网络与搜索平台官方工具，具体支持以使用时文档为准。

使用边界

有效标记不保证搜索引擎显示富结果。

评分、价格、作者等字段必须与真实可见内容一致，不能为展示效果补造。

排错

验证器通过但搜索结果没变化：确认抓取与索引状态；把展示视作搜索引擎决定，不能承诺生效。

多个组件重复注入不同实体信息：统一实体 @id 和数据来源，移除冲突字段。

固定来源

https://github.com/coreyhaines31/marketingskills/blob/5b2c0007766c6a1cf1d53fd8fc73e979e0821022/skills/schema/SKILL.md

先看看示例

输入

输出

方法说明