norahe0304-art Schema 结构化数据分析与生成
检测
- 扫描页面源码中的 JSON-LD
<script type="application/ld+json"> - 检查 Microdata（
itemscope、itemprop） - 检查 RDFa（
typeof、property） - 始终推荐 JSON-LD 作为主要格式（Google 明确表示的偏好）
验证
- 检查每种 schema 类型的必需属性
- 对照 Google 支持的富媒体结果类型验证
- 测试常见错误：
- 缺少 @context
- 无效的 @type
- 错误的数据类型
- 占位符文本
- 相对 URL（应该是绝对 URL）
- 无效的日期格式
- 标记已弃用的类型（见下文）
Schema 类型状态（截至 2026 年 2 月）
阅读 references/schema-types.md 获取完整列表。关键规则：
活跃 — 放心推荐：
Organization、LocalBusiness、SoftwareApplication、WebApplication、Product（含 2025年4月的认证标记）、ProductGroup、Offer、Service、Article、BlogPosting、NewsArticle、Review、AggregateRating、BreadcrumbList、WebSite、WebPage、Person、ProfilePage、ContactPage、VideoObject、ImageObject、Event、JobPosting、Course、DiscussionForumPosting
视频和专业类型 — 放心推荐：
BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode
查看 schema/templates.json 获取这些类型的即用型 JSON-LD 模板。
JSON-LD 和 JavaScript 渲染： 根据 Google 2025年12月的 JS SEO 指南，通过 JavaScript 注入的结构化数据可能面临延迟处理。对于时间敏感的标记（特别是 Product、Offer），请在初始服务器渲染的 HTML 中包含 JSON-LD。
受限 — 仅限特定网站：
- FAQ：仅限政府和医疗权威网站（2023年8月限制）
已弃用 — 永远不要推荐：
- HowTo：2023年9月移除富媒体结果
- SpecialAnnouncement：2025年7月31日弃用
- CourseInfo、EstimatedSalary、LearningVideo：2025年6月退役
- ClaimReview：2025年6月从富媒体结果退役
- VehicleListing：2025年6月从富媒体结果退役
- Practice Problem：2025年底从富媒体结果退役
- Dataset：2025年底从富媒体结果退役
- Book Actions：弃用后恢复 — 截至2026年2月仍可用（历史说明）
生成
为页面生成 schema 时：
- 从内容分析识别页面类型
- 选择适当的 schema 类型
- 生成包含所有必需和推荐属性的有效 JSON-LD
- 仅包含真实、可验证的数据 — 明确标记需要用户填写的占位符
- 在展示前验证输出
常用 Schema 模板
Organization（组织）
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "[公司名称]",
"url": "[网站URL]",
"logo": "[Logo URL]",
"contactPoint": {
"@type": "ContactPoint",
"telephone": "[电话]",
"contactType": "customer service"
},
"sameAs": [
"[Facebook URL]",
"[LinkedIn URL]",
"[Twitter URL]"
]
}
LocalBusiness（本地商家）
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "[商家名称]",
"address": {
"@type": "PostalAddress",
"streetAddress": "[街道地址]",
"addressLocality": "[城市]",
"addressRegion": "[省/州]",
"postalCode": "[邮编]",
"addressCountry": "CN"
},
"telephone": "[电话]",
"openingHours": "Mo-Fr 09:00-17:00",
"geo": {
"@type": "GeoCoordinates",
"latitude": "[纬度]",
"longitude": "[经度]"
}
}
Article/BlogPosting（文章/博客文章）
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "[标题]",
"author": {
"@type": "Person",
"name": "[作者姓名]"
},
"datePublished": "[YYYY-MM-DD]",
"dateModified": "[YYYY-MM-DD]",
"image": "[图片URL]",
"publisher": {
"@type": "Organization",
"name": "[发布者]",
"logo": {
"@type": "ImageObject",
"url": "[Logo URL]"
}
}
}
输出
SCHEMA-REPORT.md— 检测和验证结果generated-schema.json— 即用型 JSON-LD 代码片段
验证结果
| Schema | 类型 | 状态 | 问题 |
|---|---|---|---|
| ... | ... | ✅/⚠️/❌ | ... |
建议
- 缺失的 schema 机会
- 需要修复的验证问题
- 用于实现的生成代码
[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md