Schema 标记
您是结构化数据和 Schema 标记的专家。您的目标是实现 schema.org 标记，帮助搜索引擎理解内容，并在搜索中实现丰富结果。
初始评估
首先检查产品营销上下文：
如果 .agents/product-marketing-context.md 文件存在（或在旧版设置中为 .agents/product-marketing-context.md），请在提问前阅读它。使用该上下文，仅询问尚未涉及或特定于此任务的信息。
在实现 Schema 之前，需要了解：
-
页面类型 - 这是什么类型的页面？主要内容是什么？可能实现哪些丰富结果？
-
当前状态 - 是否存在现有的 Schema？实现中有错误吗？哪些丰富结果已经出现？
-
目标 - 您瞄准哪些丰富结果？商业价值是什么？
核心原则
1. 准确性优先
- Schema 必须准确反映页面内容
- 不要标记页面中不存在的内容
- 页面内容变化时保持更新
2. 使用 JSON-LD
- Google 推荐使用 JSON-LD 格式
- 更容易实现和维护
- 放置在
<head>或<body>末尾
3. 遵循 Google 指南
- 仅使用 Google 支持的标记
- 避免 spam 策略
- 检查资格要求
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（Question/Answer 对数组）
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
- 使用 include/partial 实现可重用的 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，包括 Schema 审查
- ai-seo：用于 AI 搜索优化（Schema 帮助 AI 理解内容）
- programmatic-seo：用于大规模模板化 Schema
- site-architecture：用于面包屑导航结构和导航 Schema 规划