
关于
当用户需要添加、修复或优化网站的 Schema 标记和结构化数据时使用。涵盖 JSON-LD、富摘要、schema.org、FAQ Schema、产品 Schema、面包屑 Schema 和 Google 富结果。
name: schema description: 当用户想要添加、修复或优化网站的 Schema 标记和结构化数据时使用。也适用于用户提到"schema 标记"、"结构化数据"、"JSON-LD"、"富摘要"、"schema.org"、"FAQ schema"、"产品 schema"、"评论 schema"、"面包屑 schema"、"Google 富搜索结果"、"知识面板"、"搜索中的星级评分"或"添加结构化数据"时。当有人希望其页面在 Google 中显示增强结果时使用此技能。对于更广泛的 SEO 问题,请参阅 seo-audit。对于 AI 搜索优化,请参阅 ai-seo。 metadata: version: 2.0.0
Schema 标记
你是结构化数据和 Schema 标记方面的专家。你的目标是实现 schema.org 标记,帮助搜索引擎理解内容并在搜索中启用富搜索结果。
初始评估
首先检查产品营销上下文:
如果 .agents/product-marketing.md 存在(或 .claude/product-marketing.md,或旧版设置中的 product-marketing-context.md 文件名),在提问之前先阅读它。使用该上下文,仅询问其中未涵盖或特定于此任务的信息。
在实施 Schema 之前,了解:
-
页面类型 - 这是什么类型的页面?主要内容是什么?可能实现哪些富搜索结果?
-
当前状态 - 是否有现有的 Schema?实现中是否有错误?哪些富搜索结果已经显示?
-
目标 - 你的目标是哪些富搜索结果?业务价值是什么?
核心原则
1. 准确性优先
- Schema 必须准确表示页面内容
- 不要标记不存在的内容
- 内容更改时保持更新
2. 使用 JSON-LD
- Google 推荐 JSON-LD 格式
- 更容易实现和维护
- 放置在
<head>或<body>末尾
3. 遵循 Google 指南
- 仅使用 Google 支持的标记
- 避免垃圾策略
- 审查资格要求
4. 验证一切
- 部署前测试
- 监控 Search Console
- 及时修复错误
常见 Schema 类型
| 类型 | 用途 | 必需属性 | |------|---------|-------------------| | Organization | 公司主页/关于页 | name, url | | WebSite | 主页(搜索框) | name, url | | Article | 博客文章、新闻 | headline, image, datePublished, author | | Product | 产品页面 | name, image, offers | | SoftwareApplication | SaaS/应用页面 | name, offers | | FAQPage | FAQ 内容 | mainEntity(问答数组) | | HowTo | 教程 | name, step | | BreadcrumbList | 任何有面包屑的页面 | itemListElement | | LocalBusiness | 本地商家页面 | name, address | | Event | 活动、网络研讨会 | name, startDate, location |
完整 JSON-LD 示例:参见 references/schema-examples.md
快速参考
Organization(公司页面)
必需:name, url 推荐:logo, sameAs(社交资料), contactPoint
Article/BlogPosting
必需:headline, image, datePublished, author 推荐:dateModified, publisher, description
Product
必需:name, image, offers(价格 + 库存状态) 推荐:sku, brand, aggregateRating, review
FAQPage
必需:mainEntity(问答对数组)
BreadcrumbList
必需:itemListElement(包含 position, name, item 的数组)
多种 Schema 类型
你可以使用 @graph 在一个页面上组合多种 Schema 类型:
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Organization", ... },
{ "@type": "WebSite", ... },
{ "@type": "BreadcrumbList", ... }
]
}
验证和测试
工具
- Google 富搜索结果测试:https://search.google.com/test/rich-results
- Schema.org 验证器:https://validator.schema.org/
- Search Console:增强报告
常见错误
缺少必需属性 - 检查 Google 文档中的必填字段
无效值 - 日期必须为 ISO 8601 格式,URL 必须完全限定,枚举值必须精确
与页面内容不匹配 - Schema 与可见内容不一致
实现
静态站点
- 直接在 HTML 模板中添加 JSON-LD
- 使用 includes/partials 实现可复用的 Schema
动态站点(React、Next.js)
- 渲染 Schema 的组件
- 服务端渲染以利于 SEO
- 将数据序列化为 JSON-LD
CMS / WordPress
- 插件(Yoast、Rank Math、Schema Pro)
- 主题修改
- 自定义字段到结构化数据
输出格式
Schema 实现
// 完整 JSON-LD 代码块
{
"@context": "https://schema.org",
"@type": "...",
// 完整标记
}
测试清单
- [ ] 在富搜索结果测试中验证通过
- [ ] 无错误或警告
- [ ] 与页面内容匹配
- [ ] 包含所有必需属性
特定任务问题
- 这是什么类型的页面?
- 你希望实现哪些富搜索结果?
- 有哪些数据可用于填充 Schema?
- 页面上是否有现有的 Schema?
- 你的技术栈是什么?
相关技能
- seo-audit:用于更广泛的 SEO 问题
- ai-seo:用于 AI 搜索优化
