Agent Skills
返回列表
🤖

Schema JSON 优化

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/schema-json-optimization-gx3t。

技能介绍

要解决的问题

很多页面的 JSON-LD 结构化数据处于「有但不一定对」的状态:JSON 语法错误、缺少 @context 或 @type、必填字段缺失。更常见的问题是,优化工具不顾页面实际类型,盲目推荐一堆根本用不上的 Schema。这个技能的核心原则是相关性优先于完整性——先判断页面是什么类型,再只校验和建议对该类型真正有价值的 Schema。

核心工作方式

技能按三步执行:

  1. 发现并校验现有 JSON-LD:扫描页面中所有 <script type="application/ld+json"> 块。未找到则发出 ⚠️ WARN;找到则逐块校验:JSON 无法解析、缺少 @context、缺少 @type 均判 ❌ FAIL,通过后再进入类型级字段检查。
  2. 自动识别页面类型:根据页面信号判断类型,结果可以是零种、一种或多种。支持 Article/Blog、LocalBusiness、Product、FAQ、Organization、BreadcrumbList、WebSite 等类型的识别。
  3. 只针对检测到的类型校验或建议:例如检测到 Product 页面时,检查 name(缺失为 FAIL)、offers(需含 price 与 priceCurrency)、image、description;对 FAQ 页面则从内容中提取问答对,建议生成 FAQPage Schema。

适用边界

  • 未检测到任何类型时,只校验现有 Schema,不主动建议新的。
  • 一个页面可同时命中多种类型(如商品页内嵌 FAQ 区块),此时建议同时补齐 Product 与 FAQPage。
  • 现有 Schema 合法但与检测类型不符时照常校验,不必强行替换。
  • 检测信号有歧义时如实报告,交由用户决定,而非强行猜测。
  • @type 可以是数组(如 ["Article", "NewsArticle"]),校验时需兼容。

使用场景

  • 接手存量站点,需要检查页面已有 JSON-LD 是否可解析且 `@context`、`@type` 完整。
  • 准备上线博客文章页,需要确认 Article Schema 是否缺少 `headline`、`author` 等字段。
  • 电商商品页已标注 Product,需要核对 `offers` 中的 `price` 与 `priceCurrency` 是否有效。
  • 官网含公司简介与联系方式页面,需要判断是否适合建议 LocalBusiness Schema。

适合人员

  • 负责技术 SEO 的工程师,需要保证结构化数据字段完整且不引入无关 Schema。
  • 前端或全栈开发者,在重构页面时同步维护现有 JSON-LD 标记。
  • 跨境电商运营,需要确认商品价格与币种在 Product Schema 中正确呈现。