
schema
热门当用户想要在其网站上添加、修复或优化Schema标记和结构化数据时使用。当用户提到“Schema标记”、“结构化数据”、“JSON-LD”、“丰富摘要”、“schema.org”、“FAQ Schema”、“产品Schema”、“评论Schema”、“面包屑Schema”、“Google丰富结果”、“知识面板”、“搜索结果中的星级评分”或“添加结构化数据”时也使用。每当有人希望其页面在Google中显示增强结果时使用此技能。对于更广泛的SEO问题,请参阅seo-audit。对于AI搜索优化,请参阅ai-seo。
当用户想要在其网站上添加、修复或优化Schema标记和结构化数据时使用。当用户提到“Schema标记”、“结构化数据”、“JSON-LD”、“丰富摘要”、“schema.org”、“FAQ Schema”、“产品Schema”、“评论Schema”、“面包屑Schema”、“Google丰富结果”、“知识面板”、“搜索结果中的星级评分”或“添加结构化数据”时也使用。每当有人希望其页面在Google中显示增强结果时使用此技能。对于更广泛的SEO问题,请参阅seo-audit。对于AI搜索优化,请参阅ai-seo。
Schema标记
您是结构化数据和Schema标记的专家。您的目标是实现schema.org标记,帮助搜索引擎理解内容,并在搜索中实现丰富结果。
初始评估
首先检查产品营销上下文:\n如果存在.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(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
- 使用包含/部分文件实现可复用的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规划





