SuperAPI AI 工具集

schema-entity-graph

通用与其它

查看项目

更新于 10-16 06:14

技能介绍

用途:为英国本地服务类企业网站(如 Astro 获客站)构建完整、互相链接的 Schema.org 实体图,输出 JSON-LD 结构化数据。所有业务数据均来自单一 siteConfig,schema 文件中不硬编码业务数据。该技能负责构建,schema-audit 技能负责校验,二者配合使用。

架构:src/config/ 下包含 siteConfig.ts(Zod 类型定义与校验)、siteConfig.example.ts(实际项目数据,唯一数据源)、schema.ts(JSON-LD 生成器,从 siteConfig 派生全部内容)。每个生成函数首个参数均为 config: SiteConfig。

主要能力:为核心实体生成 @id(如 #business、#website、#person、#service、#webapp),通过 id() 助手统一生成完整 URL 加 hash 片段,去除尾部斜杠并处理根路径。自动派生字段包括 slogan、sameAs、AggregateRating(按评论数加权平均)、areaServed、hasOfferCatalog、knowsAbout、knowsLanguage、openingHoursSpecification、address/geo、photo、potentialAction、founder 及 Person 的相关字段。提供按页面类型划分的生成器:homepageSchema、contactPageSchema、aboutPageSchema、collectionPageSchema、serviceSchema、areaServiceSchema、articleSchema、personSchema、faqSchema、videoSchema、calculatorSchema。实体之间通过 publisher、founder、provider、author、isPartOf、mainEntity、worksFor 等属性交叉引用。

使用方式:先在 siteConfig 中确认必需字段(schemaType、googleMapsCid、people 的 slug/sameAs/jobTitle、services 的 serviceType、reviews、legal.companyNumber、address.geo、hours),缺失需先补全;再将 schema.ts 放入 src/config/,并按项目路由调整 URL 模式;随后在 Astro 页面中调用对应生成器并用 script type="application/ld+json" set:html={JSON.stringify(...)} 渲染;多 schema 页面通过 schema['@graph'].push(...) 合并;作者页需手动添加 breadcrumb。

限制与规则:禁止在 schema.ts 中硬编码业务数据、在内部页面重复声明完整 LocalBusiness、在 LocalBusiness 子类型旁另设 Organization、在区域页放置 LocalBusiness、使用相对 URL 或裸 #fragment @id、使用无法核实的假评论、声明不含 termsOfService。评论数字须真实可核对,页面需注明聚合与平台拆分。FAQ 富结果已于 2026 年 1 月移除,但 FAQ schema 仍有助于 AI 搜索可见性,需页面存在真实问答且文案逐字一致。校验需通过 Google Rich Results Test 与 Schema.org Validator,确保每个 @id 可解析、无重复实体类型、schema 内容与可见页面一致。

适用场景:Astro 构建的本地服务获客站、需 JSON-LD 实体图的项目、需要跨页面实体链接与自动 review 聚合的站点。

暂未提供:具体价格、授权方式、性能数据及官方文档链接等未在资料中说明。