技能介绍

要解决什么问题

搜索引擎和 AI 摘要往往只能看到「标题 + 正文」，却读不懂页面到底是公司主页、商品详情还是教程步骤。缺少 schema.org 结构化数据时，富媒体结果（FAQ 折叠、面包屑、商品价格、活动信息等）要么不出现，要么因标记与可见内容不一致被降权。

本技能把角色设定为结构化数据与 schema 标记专家，目标是在不编造字段的前提下，用 JSON-LD 准确描述页面实体，并对接 Google 支持的富媒体类型与资格要求。

技能如何工作

实施前会先对齐上下文（若存在 .claude/product-marketing-context.md 会先读取），再围绕三类信息提问：页面类型、当前是否已有 schema / 是否有错误、目标富媒体结果与商业价值。

核心原则贯穿全流程：

准确性优先：标记必须反映真实内容；内容变更需同步更新。
JSON-LD：推荐放在 </head> 或 </body> 末尾，便于维护。
遵循 Google 指南：只用受支持类型，部署前用 Rich Results Test / Schema.org Validator 全量校验。

常见类型与必填字段有速查表，例如 Organization（name、url）、Article（headline、image、datePublished、author）、Product（name、image、offers）、FAQPage（mainEntity）、BreadcrumbList（itemListElement）等；多类型可用 @graph 同页组合。输出包含 Schema 实现 与 测试清单（Rich Results、无告警、与页面一致、必填齐全）。

静态站、React/Next（SSR 序列化 JSON-LD）、CMS/WordPress 插件等实施路径在 SKILL 中有对应说明；完整 JSON-LD 示例指向 references/schema-examples.md。

适用边界与注意点

不会为「页面上不存在」的信息补标记；追求富媒体前先确认数据源是否齐全（作者、价格、库存、活动时间等）。
富媒体资格以 Google 文档与 Search Console 报告为准；类型选错或枚举/日期格式（如 ISO 8601）错误是常见失败原因。
整体 SEO 审计、AI 搜索优化、大规模模板化 schema 可配合相关技能（如 seo-audit、ai-seo、programmatic-seo），本技能聚焦单次页面的标记设计与校验闭环。

截图预览

使用场景

商品详情页已在站内展示价格与库存，但搜索结果未出现商品富媒体，需按 Product 类型补全 `name`、`image`、`offers` 并通过 Rich Results Test。
博客或新闻详情页改版后丢失作者与发布时间，需在 React/Next 服务端渲染路径输出 Article 的 `headline`、`datePublished`、`author` 并与可见正文一致。
帮助中心已有问答正文但未做标记，需将每对问答整理为 FAQPage 的 `mainEntity` 数组，部署前用 Schema.org Validator 排查必填字段。
公司首页含站内搜索与面包屑导航，需在同一页面用 `@graph` 组合 Organization、WebSite 与 BreadcrumbList，避免与页面实体信息冲突。

适合人员

维护 Next.js 生产站点的全栈工程师，要把商品或文章数据在 SSR 阶段序列化为 JSON-LD 并避免与客户端渲染不一致。
负责新页面上线清单的内容或增长运营，需按 Google 支持类型核对 FAQ、Article 等必填属性是否可从 CMS 字段导出。
接手存量站审计的技术 SEO 顾问，需根据 Search Console 增强报告与 Rich Results Test 报错定位无效 URL 或 ISO 8601 日期问题。
用静态站点生成器维护多页模板的开发者，要在 HTML 局部片段中复用 Organization 标记并在品牌信息变更时批量更新。

Schema 结构化标记