关于 seo-schema
seo-schema 是用于检测、验证和生成 Schema 标记的 SEO 技能，面向需要改进页面结构化数据的从业者。它检查 JSON-LD、Microdata 和 RDFa，并提供可用于页面的 JSON-LD 输出。
主要功能
- 01检测 JSON-LD、Microdata 与 RDFa
- 02按类型检查必需属性
- 03验证 Google 支持的富媒体结果类型
- 04识别过时及已停用类型
- 05生成 JSON-LD 标记模板
- 06输出检测报告与实施建议
适用场景
- 01审计网页现有结构化数据
- 02修复 JSON-LD 属性或格式问题
- 03为页面生成 Schema 标记
- 04判断现有标记是否仍受支持
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/seo-schema确认已加载。
附带文件LICENSE.txtreferences/deprecated-types-2024-2026.md
详细介绍
Schema 标记分析与生成
检测
- 使用
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py --url <url> --json提取 JSON-LD （或扫描页面源代码中的<script type="application/ld+json">）。标记任何缺少@context或@type的代码块：Google 无法将其关联到实体（此类代码块中的 评分不会关联到 Product）。 - 检查 Microdata（
itemscope、itemprop） - 检查 RDFa（
typeof、property） - 始终建议将 JSON-LD 作为首选格式（这是 Google 明确表示的偏好）
验证
- 检查每种 Schema 类型的必需属性
- 根据 Google 支持的富媒体搜索结果类型进行验证
- 检查常见错误：
- 缺少 @context
- 无效的 @type
- 数据类型错误
- 占位文本
- 相对 URL（应为绝对 URL）
- 日期格式无效
- 标记已弃用的类型（见下文）
Schema 类型状态（截至 2026 年 6 月）
阅读 ../seo/references/schema-types.md 查看完整列表。主要规则：
ACTIVE（可放心推荐）：
Organization、LocalBusiness、SoftwareApplication、WebApplication、Product（自 2025 年 4 月起支持 Certification 标记）、ProductGroup、Offer、Service、Article、BlogPosting、NewsArticle、Review、AggregateRating、BreadcrumbList、WebSite、WebPage、Person、ProfilePage、ContactPage、VideoObject、ImageObject、Event、JobPosting、Course、DiscussionForumPosting
VIDEO & SPECIALIZED（可放心推荐）：
BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode
请参阅 schema/templates.json，获取这些类型的即用型 JSON-LD 模板。
**JSON-LD 和 JavaScript 渲染：**Google 支持使用 JavaScript 生成结构化数据，但其“使用 JavaScript 生成结构化数据”指南（最近更新于 2025-12-10）警告称，动态生成的 Product 标记可能导致 Shopping 抓取频率降低、可靠性变差，尤其是在价格和库存情况快速变化时。对于时效性要求高的标记（尤其是 Product、Offer），应将 JSON-LD 放入初始的服务器渲染 HTML 中。
NO RICH RESULTS，若有用则保留：
- FAQPage：Google 于 2026 年 5 月 7 日为所有网站停用了 FAQ 富媒体搜索结果（取代 2023 年 8 月针对政府和健康领域的限制）。不会带来 Google SERP 富媒体搜索结果收益；应将现有 FAQPage 标记为 Info（而非 Critical），不要建议移除。对于真实的用户问答页面，请使用 QAPage。
DEPRECATED（切勿推荐）：
- HowTo：富媒体搜索结果已于 2023 年 9 月移除
- SpecialAnnouncement：已于 2025 年 7 月 31 日弃用
- CourseInfo、EstimatedSalary、LearningVideo：已于 2025 年 6 月停用
- ClaimReview：自 2025 年 6 月起不再提供 Search 富媒体搜索结果。Google 的 Fact Check Explorer 仍会使用此标记，因此事实核查发布者可以保留；切勿将其作为 SERP 功能推荐
- VehicleListing：已于 2025 年 6 月从富媒体搜索结果中停用
- Practice Problem：弃用通知日期为 2025-11-05；工具支持自 2026 年 1 月起移除；文档于 2026-01-06 移除
- Search Console / Rich Results Test / 外观筛选器对 CourseInfo、ClaimReview、EstimatedSalary、LearningVideo、SpecialAnnouncement、VehicleListing 的支持已于 2025-09-09 移除（Search Console API 支持至 2025 年 12 月）。
仍受支持（尽管此前曾发布停用通知）：
- Book Actions：未弃用。2025 年 6 月的停用横幅已于 2025-11-05 移除，因为某项 Search 功能仍在使用该标记。
仅支持 Dataset Search：
- Dataset：并未停用；Google Dataset Search 会使用它，但 Google Search 没有对应的富媒体搜索结果展示位。不要将其描述为已废弃并建议移除。
仍受支持（不要标记）：
- QAPage（2026-03-24 扩展了评论串属性）、DiscussionForumPosting、Education Q&A（Quiz /
eduQuestionType=Flashcard）。对于电子商务，成人产品必须使用 hasAdultConsideration（2026-05-20 新增；值为https://schema.org/SexualContentConsideration）。Product.category接受Text、CategoryCode，也接受混合两者的数组。
生成
为页面生成架构时：
- 通过内容分析识别页面类型
- 选择合适的架构类型
- 生成包含所有必需属性和推荐属性的有效 JSON-LD
- 仅包含真实且可验证的数据。使用清晰标注的占位符供用户填写
- 在呈现前验证输出
- 对于评论标记，拒绝虚假评论和未披露的激励评论。 激励信息必须在页面上清晰且显著地披露。
常见架构模板
组织
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "[Company Name]",
"url": "[Website URL]",
"logo": "[Logo URL]",
"contactPoint": {
"@type": "ContactPoint",
"telephone": "[Phone]",
"contactType": "customer service"
},
"sameAs": [
"[Facebook URL]",
"[LinkedIn URL]",
"[Twitter URL]"
]
}
本地商家
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "[Business Name]",
"address": {
"@type": "PostalAddress",
"streetAddress": "[Street]",
"addressLocality": "[City]",
"addressRegion": "[State]",
"postalCode": "[ZIP]",
"addressCountry": "US"
},
"telephone": "[Phone]",
"openingHours": "Mo-Fr 09:00-17:00",
"geo": {
"@type": "GeoCoordinates",
"latitude": "[Lat]",
"longitude": "[Long]"
}
}
文章/博客文章
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "[Title]",
"author": {
"@type": "Person",
"name": "[Author Name]"
},
"datePublished": "[YYYY-MM-DD]",
"dateModified": "[YYYY-MM-DD]",
"image": "[Image URL]",
"publisher": {
"@type": "Organization",
"name": "[Publisher]",
"logo": {
"@type": "ImageObject",
"url": "[Logo URL]"
}
}
}
输出
SCHEMA-REPORT.md：检测和验证结果generated-schema.json：可直接使用的 JSON-LD 片段
验证结果
| 架构 | 类型 | 状态 | 问题 |
|---|---|---|---|
| ... | ... | ✅/⚠️/❌ | ... |
建议
- 缺失的架构机会
- 需要修复的验证问题
- 用于实现的生成代码
错误处理
| 场景 | 操作 |
|---|---|
| URL 无法访问 | 报告包含状态代码的连接错误。建议检查 URL 是否正确，以及页面是否需要身份验证。 |
| 未找到架构标记 | 报告未检测到 JSON-LD、Microdata 或 RDFa。根据页面内容分析推荐合适的架构类型。 |
| JSON-LD 语法无效 | 解析并报告具体语法错误（缺少括号、尾随逗号、未加引号的键）。提供修正后的 JSON-LD 输出。 |
| 检测到已弃用的架构类型 | 标记已弃用的类型及其停用日期。推荐当前的替代类型；如果没有替代类型，则建议移除。 |