用途:该技能面向结构化数据与 schema markup 专家场景,目标是在站点上实施 schema.org 标记,帮助搜索引擎理解内容并触发搜索结果中的富媒体展示。适用于用户提出添加、修复或优化 schema markup、结构化数据相关需求时。
主要能力:先做初始评估,包括判断页面类型、主要内容和可能的富媒体结果;检查现有 schema 与实现错误;明确目标富媒体类型及其业务价值。若存在 .claude/product-marketing-context.md,会先读取该上下文,只询问未覆盖或本任务特有的信息。
核心原则:准确性优先,schema 必须真实反映页面内容,不为不存在的内容加标记,内容变更时同步更新;推荐使用 JSON-LD 格式,放在 head 或 body 末尾;遵循 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 在同一页面组合多种类型。
验证与测试:Google Rich Results Test(https://search.google.com/test/rich-results)、Schema.org Validator(https://validator.schema.org/)、Search Console 的 Enhancements 报告。常见错误包括缺少必填属性、取值无效(日期需 ISO 8601、URL 需完整限定、枚举需精确)、与页面可见内容不一致。
实施方式:静态站点可直接在 HTML 模板中加入 JSON-LD,或用 includes/partials 复用;动态站点(React、Next.js)可用组件渲染并服务端渲染,将数据序列化为 JSON-LD;CMS/WordPress 可用插件(Yoast、Rank Math、Schema Pro)、主题修改或自定义字段转结构化数据。
限制:资料未提供具体收费、价格、平台支持范围或效果保证;实际可用性取决于搜索引擎支持情况与页面内容,需以验证工具和 Search Console 结果为准。