用途:当需要为站点添加、修复或优化 schema markup 与结构化数据时使用,目标是用 schema.org 标记帮助搜索引擎理解内容并触发搜索结果富媒体展示。
主要能力:实现前先做初始评估,确认页面类型、当前 schema 状态与目标富结果;若存在 .agents/product-marketing.md(或 .claude/product-marketing.md,旧命名为 product-marketing-context.md)则先读取其中的产品营销背景,只再询问未覆盖的信息。核心原则为准确性优先(不得标记页面上不存在的内容)、使用 JSON-LD、遵循 Google 支持范围与指南、避免垃圾手法,并在部署前验证、上线后用 Search Console 监控和及时修复错误。
覆盖的常见类型与必填属性:Organization(name、url)、WebSite(name、url)、Article(headline、image、datePublished、author)、Product(name、image、offers)、SoftwareApplication(name、offers)、FAQPage(mainEntity)、HowTo(name、step)、BreadcrumbList(itemListElement)、LocalBusiness(name、address)、Event(name、startDate、location)。同一页面可用 @graph 组合多个类型,例如 Organization、WebSite、BreadcrumbList 并列。
使用方式:JSON-LD 建议放在 head 或 body 末尾;静态站点直接写入 HTML 模板或用 include/partial 复用,动态站点(React、Next.js)用组件渲染并服务端渲染,CM5/WordPress 可用插件(Yoast、Rank Math、Schema Pro)或主题改造、自定义字段映射。校验工具为 Google Rich Results Test、Schema.org Validator 和 Search Console 的 Enhancements 报告;常见错误包括缺必填属性、取值不合法(日期需 ISO 8601、URL 需完整、枚举需精确)以及与页面内容不一致。
适用场景与限制:适合需要提升搜索展现的建站与 SEO 工作,含规模化模板化 schema。资料未提供具体价格、平台限制或效果保证;完整 JSON-LD 示例见其 references/schema-examples.md。