Agent Skills
返回列表
💻

Schema.org 结构化数据类型

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/schema-dts-typescript-types-schemaorg-structured-data 到当前 AI 助手。

技能介绍

要解决的问题

为页面添加 SEO 结构化数据时，团队通常直接手写 JSON-LD：类型名、必填字段、嵌套关系全靠记忆和翻文档。字段拼错、层级放错这类问题，往往要到搜索引擎抓取之后才暴露，排障成本高。schema-dts 将 Schema.org 词汇表编译为完整的 TypeScript 类型定义，让 JSON-LD 像普通对象一样获得编译期校验。

核心能力与工作方式

  • 词汇表即类型：基于 Schema.org 官方 ontology（schemaorg-all-https.nt）生成类型定义，覆盖实体、属性与层级关系。
  • 类型安全输出：编写结构化数据时，字段名、取值类型、必填项在 tsc 编译期即报错，不必等运行时或搜索引擎反馈。
  • 节点复用：任意节点可声明 @id，其他位置通过 ID 引用同一实体，符合 JSON-LD 的图结构习惯。
  • 面向 SEO 场景：针对富搜索结果、知识图谱等依赖 JSON-LD 的场景设计。

适用边界与注意点

  • 类型定义依赖对 ontology 的生成步骤，Schema.org 词汇表更新后需重新生成才能拿到新类型。
  • 词汇表规模庞大，常用类型覆盖完整，冷门子类型建议生成后实际核对一遍。
  • 该技能只负责类型层，不做运行时数据抓取或渲染；提交前的富媒体预览仍需其他工具配合。

使用场景

  • 在团队代码库为官网首页补 JSON-LD，需要用 Schema.org 类型在提交前拦住必填字段和嵌套错误。
  • 为商品详情页生成 Rich Results 结构化数据时，需要统一复用 Organization 与 Product 的 @id 实体。
  • 把博客文章接入知识图谱，需要按最新 Schema.org 词汇表生成并校验 Article、BreadcrumbList 等类型。
  • 重构内容中台输出层，需要把 SEO 结构化数据从手写 JSON 改成可被 TypeScript 编译检查的代码。

适合人员

  • 前端工程师：在页面模板中输出 SEO JSON-LD，希望编译器检查字段名、类型和必填项。
  • SEO 工程师：为文章、商品、面包屑设计结构化数据，需要统一管理实体的 @id 和嵌套关系。
  • 内容平台开发者：批量生成站点级结构化数据，希望词汇表更新后能快速重新生成类型。
  • 技术负责人：在代码评审中替代人工核对 SEO markup，希望用 Schema.org 类型固化输出约束。