Schema JSON 优化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/schema-json-optimization-gx3t。
技能介绍
要解决的问题
很多页面的 JSON-LD 结构化数据处于「有但不一定对」的状态:JSON 语法错误、缺少 @context 或 @type、必填字段缺失。更常见的问题是,优化工具不顾页面实际类型,盲目推荐一堆根本用不上的 Schema。这个技能的核心原则是相关性优先于完整性——先判断页面是什么类型,再只校验和建议对该类型真正有价值的 Schema。
核心工作方式
技能按三步执行:
- 发现并校验现有 JSON-LD:扫描页面中所有
<script type="application/ld+json">块。未找到则发出⚠️ WARN;找到则逐块校验:JSON 无法解析、缺少@context、缺少@type均判❌ FAIL,通过后再进入类型级字段检查。 - 自动识别页面类型:根据页面信号判断类型,结果可以是零种、一种或多种。支持 Article/Blog、LocalBusiness、Product、FAQ、Organization、BreadcrumbList、WebSite 等类型的识别。
- 只针对检测到的类型校验或建议:例如检测到 Product 页面时,检查
name(缺失为 FAIL)、offers(需含price与priceCurrency)、image、description;对 FAQ 页面则从内容中提取问答对,建议生成FAQPageSchema。
适用边界
- 未检测到任何类型时,只校验现有 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 中正确呈现。