用途
seo-schema 用于检测、校验和生成 Schema.org JSON-LD 结构化标记。它面向需要对网页结构化数据进行核查或补充的场景，帮助识别页面已有的 JSON-LD、验证其是否符合 schema.org 定义，并按页面类型补齐缺失的标记。
主要能力
- 检测 HTML 中已有的 JSON-LD 块。
- 通过 scripts/validate-schema.ts 对照 schema.org 离线数据校验标记。
- 根据页面类型识别缺失的 schema 类型。
- 从 templates/json-ld/ 中的模板生成 JSON-LD。
支持的类型与模板
| 类型 | 用途 | 模板 |
|---|---|---|
| Article | 博客文章、新闻 | templates/json-ld/article.json |
| Product | 电子商务 | templates/json-ld/product.json |
| LocalBusiness | 本地 SEO | templates/json-ld/localbusiness.json |
| Organization | 品牌/公司页面 | templates/json-ld/organization.json |
| BreadcrumbList | 导航 | templates/json-ld/breadcrumb.json |
| FAQPage | 问答（自 2023 年 8 月起仅限政府/健康站点） | templates/json-ld/faq.json |
| VideoObject | 视频内容 | templates/json-ld/video.json |
| Event | 活动 | templates/json-ld/event.json |
| Recipe | 食谱 | templates/json-ld/recipe.json |
使用方式
资料给出的工作流为：先在 HTML 中检测现有 JSON-LD 块；运行 scripts/validate-schema.ts，对照 schema.org 离线数据进行检查；根据页面类型识别缺失的 schema 类型；再从 templates/json-ld/ 的模板生成标记。
废弃与限制（2025）
- HowTo：2023 年 9 月废弃。
- FAQ：自 2023 年 8 月起仅限政府/健康类站点。
- SpecialAnnouncement：2025 年 7 月废弃。
相关技能
- seo-entity：通过 about/sameAs/knowsAbout 将实体解析到 Wikidata。
- seo-video：VideoObject / Clip / SeekToAction。
- seo-local：LocalBusiness 标记。