schema-markup

用途：为页面添加、修复或优化 schema.org 结构化数据，帮助搜索引擎理解内容并争取富媒体结果。开始前先了解页面类型、主要内容和可能的富媒体类型，确认现有 schema、实现错误与已出现的富媒体结果，并明确目标富媒体类型和业务价值。若存在 .claude/product-marketing-context.md，应先读取，只用它询问未覆盖的信息。\n\n主要能力：覆盖常见类型，包括 Organization、WebSite、Article、Product、SoftwareApplication、FAQPage、HowTo、BreadcrumbList、LocalBusiness、Event；可用 @graph 在同一页面组合多种类型。核心原则是准确代表页面内容、使用 Google 推荐的 JSON-LD（放在 <head> 或 <body> 末尾）、只使用 Google 支持的标记并避免垃圾手段、上线前验证并通过 Search Console 监控。\n\n必要用法与验证：Google 富媒体结果测试 https://search.google.com/test/rich-results；Schema.org 验证器 https://validator.schema.org/；Search Console 增强报告。常见错误包括缺少必需属性、值无效（日期需 ISO 8601、URL 需完整限定、枚举值需精确）以及与页面可见内容不符。实现上，静态站点直接在 HTML 模板加 JSON-LD，动态站点（React、Next.js）用组件并服务端渲染后序列化为 JSON-LD，CMS/WordPress 可用插件或主题修改、自定义字段转结构化数据。输出为完整 JSON-LD 代码块并附测试清单：通过富媒体测试、无错误警告、与页面内容一致、包含全部必需属性。\n\n适用场景：博客、产品页、FAQ、教程、公司主页、本地商家、活动页等需要结构化数据的场景。限制：不得标记不存在的内容，内容变更需同步更新；缺失事实（如具体价格、评分等）暂未提供；相关技能为 seo-audit 与 programmatic-seo。