SuperAPI AI 工具集

tl-schema-org

数据与分析

查看项目

更新于 10-16 03:04

技能介绍

用途:帮助在网页、数据库、API 和数据交换中熟练使用完整 Schema.org 词汇表(类型、属性、枚举及其关系),适用于添加结构化数据、映射数据库模型、设计 API、扩展自定义属性、选择类型与验证标记等场景。

主要能力:

  • 词汇基础:类型以 Thing 为根的多重继承层级,属性有 domain/range,枚举为固定成员集合;遵循 Postel 法则,接受宽松、产出保守。提供主要分支(Action、CreativeWork、Event、Intangible、Organization、Person、Place、Product 等)及电商、活动、新闻、图书、招聘、本地商家等垂类类型组合。
  • JSON-LD 渲染:单实体、@graph 多实体与 @id 交叉引用、多类型实体写法;枚举值使用完整 URI(如 https://schema.org/InStock);放置于 head 或 body 前的 application/ld+json 脚本,SSR 与 SPA 注入方式,建议每页一个脚本配合 @graph。
  • 扩展模式:优先复用现有属性,其次 additionalProperty/PropertyValue,再考虑 x- 公开扩展与 _x- 内部扩展;字段按 @context、@type、标准属性、x-、_x-、其他隐藏字段排序;公开响应递归剥离 _x- 字段;可结合外部词汇表与 pending 术语。
  • 数据库建模:Schema.org 作为命名与设计参考而非数据库 schema;图书需区分作品(Book)与版本(bookEdition,经 workExample/exampleOfWork 关联),系列用 BookSeries 或 CreativeWorkSeries + hasPart/isPartOf + position;系列表采用 series 表加可空 series_id/position 的三段式布局,成员可由 slug 约定派生而非手工维护。
  • API 互操作:用 OpenAPI allOf 镜像继承;响应格式从完整 JSON-LD 到仅用命名约定;用结构化外部标识与 sameAs 做跨系统映射。
  • 富媒体结果:各类型必需与推荐属性(如 Product 需 name/image/offers 含 price 与 availability),缺失必需属性会抑制整条富媒体结果;配套验证流程、常见错误与质量规则需参阅完整文档。

限制:Schema.org 是协作词汇表而非严格本体,接受度高但产出需保守;扩展前应先查现有属性;pending 术语可能被改名或移除,需锁定版本;介绍未给出具体价格、平台或效果承诺。