用途:检测、验证并生成 Schema.org 结构化数据,帮助页面获得或优化富媒体搜索结果(rich results)。优先推荐并生成 JSON-LD 格式。
主要能力:
- 检测:扫描页面源码中的 JSON-LD(<script type="application/ld+json">)、Microdata(itemscope、itemprop)和 RDFa(typeof、property)。始终推荐以 JSON-LD 作为主要格式。
- 验证:检查各 Schema 类型的必填属性,对照 Google 支持的富媒体结果类型进行校验,并排查常见错误,如缺少 @context、@type 无效、数据类型错误、占位文本、相对 URL(应为绝对 URL)、无效日期格式等。
- 生成:根据页面内容识别页面类型,选择合适的 Schema 类型,生成包含必填与推荐属性的合法 JSON-LD,仅使用真实可验证数据,占位符明确标注供用户填写,并在输出前进行校验。
- Schema 类型状态管理(截至 2026 年 2 月):推荐活跃类型如 Organization、LocalBusiness、SoftwareApplication、WebApplication、Product、Offer、Service、Article、BlogPosting、NewsArticle、Review、AggregateRating、BreadcrumbList、WebSite、WebPage、Person、ProfilePage、ContactPage、VideoObject、ImageObject、Event、JobPosting、Course、DiscussionForumPosting 等;视频与特殊类型如 BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode 可自由推荐。FAQ 仅限政府与医疗权威站点(2023 年 8 月起受限)。弃用类型包括 HowTo(2023 年 9 月移除富媒体结果)、SpecialAnnouncement(2025 年 7 月 31 日弃用)、CourseInfo、EstimatedSalary、LearningVideo(2025 年 6 月退役)、ClaimReview、VehicleListing(2025 年 6 月退役)、Practice Problem、Dataset(2025 年末退役)。
- 共享数据缓存:执行前检查 .seo-cache/ 中可复用的上下文(如 site-meta.json、audit-scores.json、pages/{url-slug}/page-analysis.json),若存在且有效则使用并注明来源日期;若缺失、损坏或不相关则使用新证据;用户要求“刷新”或“重新运行”时忽略缓存读取并覆盖写入。工作完成后将持久性发现以 JSON 摘要写入 .seo-cache/,包含 cache_type、analyzed_at、源 URL/域名、关键发现、问题、建议和工具限制,并建议将 .seo-cache/ 加入 .gitignore。
使用方式:提供目标 URL 或页面内容后,技能会执行检测、验证和生成流程。输出包括 SCHEMA-REPORT.md(检测与验证结果)、generated-schema.json(可直接使用的 JSON-LD 片段)以及推荐项(缺失的 Schema 机会、验证修复、实施代码)。
适用场景:SEO 审计、富媒体结果优化、结构化数据迁移与修复、页面 Schema 标记生成。
限制与注意事项:仅使用真实可验证数据,占位符需用户自行填写;JavaScript 注入的结构化数据可能面临延迟处理,对时效敏感的标记(尤其是 Product、Offer)建议在初始服务器渲染的 HTML 中包含 JSON-LD;受限与弃用类型应避免推荐;URL 不可达时报告连接错误及状态码,未检测到标记时报告并基于内容推荐合适类型,JSON-LD 语法错误时报告具体错误并提供修正输出。