用途
该技能在用户需要为任意页面生成、编写或校验结构化数据标记时激活。触发短语包括“generate schema”“create JSON-LD”“schema markup for”“structured data for”“FAQ schema”“product schema”“article schema”“rich results schema”“schema generator: [type]”“add schema to [page]”等。它面向 SEO 与 AEO(AI 引擎优化)场景,产出可直接放入 HTML 的 JSON-LD 代码。
主要能力
支持以下 schema 类型,单页可请求多种:
- Article:适合博客文章、支柱页、新闻,可解锁 Article 富媒体结果与 Top Stories。
- FAQPage:适合任意页面的 FAQ 区块,可解锁 SERP 中的 FAQ 折叠展示,被视为 AEO 关键类型。
- HowTo:适合分步指南,可解锁分步富媒体结果。
- Product:适合产品或定价页,可在 SERP 中展示价格、库存、评分。
- Review:适合单个产品或服务评价,可在 SERP 中展示星级。
- AggregateRating:适合含多条评价的页面,展示带评价数量的星级。
- BreadcrumbList:适合任何具有导航层级的页面,在 SERP URL 中展示面包屑路径。
- Organization:适合首页或关于页,提供品牌知识面板信号。
- WebPage:适合任何需要基础结构化标识的页面,增强爬虫对页面的理解。
- WebSite:仅适合首页,可解锁 SERP 中的站点链接搜索框。
AEO 优先级:FAQPage 与 HowTo 是两种最直接服务于 AI 引擎提取的 schema 类型。对于包含 FAQ 区块的落地页和博客文章,应始终包含 FAQPage。
使用方式
技能接收如下输入结构:page_type(landing-page、blog-post、pillar-page、product-page、homepage、faq-page、how-to-page)、schema_types(所需类型列表)、page_data(包含 url、title、description、primary_keyword、date_published、date_modified、author_name、brand_name、brand_url、logo_url,以及可选的 product、reviews、aggregate_rating、faqs、how_to、breadcrumbs 等字段)。
执行步骤:读取 page_type 与 schema_types,若 schema_types 为空则依据 Schema Type Menu 推荐合适类型;为每个请求的类型从 references/ 加载对应模板;将 page_data 字段映射到模板占位符;按富媒体结果资格规则检查每个必填字段,缺失则标记为问题;检查推荐字段,缺失则标记为警告但不阻断输出;校验 URL 为绝对地址、日期为 ISO 8601、价格为十进制格式;为每个 schema 类型生成一个干净的 script 块;构建校验摘要表;列出所有问题及其严重程度与精确修复说明;编写实施说明与测试清单。
references/ 目录包含预校验的 JSON-LD 模板:faq-schema.json、article-schema.json、product-schema.json、review-schema.json、aggregate-rating-schema.json、howto-schema.json、breadcrumb-schema.json、organization-schema.json、webpage-schema.json、website-schema.json。每个模板含必填与推荐字段,占位符格式为 "{{field_name}}",由 schema_builder.py 脚本替换为 page_data 中的值。
输出结构固定为:Schema Markup Output 头部(页面、URL、生成的 schema 类型、解锁的富媒体结果、新增的 AEO 信号);Validation Summary 表格(各类型的必填字段完整性、富媒体资格、发现问题数);Issues Found 清单(问题、schema 类型、严重程度、修复方式);JSON-LD Output(每个类型一个 script 块,置于 HTML 的 head 中);Implementation Instructions(复制 script 块、粘贴到 title 标签之后 head 结束之前、每类型独立块、使用 Google Rich Results Test 与 Schema.org Validator 测试、部署后在 Google Search Console 请求重新索引);Testing Checklist(必填字段完整、无占位文本、URL 绝对、日期 ISO 8601、价格为十进制、货币为 ISO 4217、FAQPage 至少 2 组问答、JSON-LD 字符串值内无 HTML 标签、每类型独立 script 块、已通过两项测试)。
适用场景
当需要为页面添加或校验 JSON-LD 结构化数据,且所提供的可见内容支持所选 schema 类型时使用。该技能接收来自 seo-aeo-landing-page-writer、seo-aeo-blog-writer、seo-aeo-content-quality-auditor、seo-aeo-internal-linking 的输出,并将结果送入编排工作流,作为发布检查清单前的最后一步。
限制
结构化数据必须与页面可见、真实的内容一致;有效的 JSON-LD 并不保证一定获得富媒体结果、索引或展示。填充所选参考模板时,未解析的占位符应作为阻断性问题显示。项目提供的 schema 辅助工具仅可作为补充检查使用;不得输出虚构的评价、评分或产品声明。