SuperAPI AI 工具集

schema-markup

营销与增长

查看项目

更新于 10-14 23:39

技能介绍

用途

该技能面向结构化数据(Schema Markup)与 schema.org 标记的专家级工作,目标是帮助实施、审计和验证 JSON-LD schema,从而争取 Google 富媒体搜索结果、提升点击率,并让内容更易被 AI 搜索系统读取。

主要能力

技能提供三种工作模式:

  1. 审计现有标记:对页面 HTML 运行 scripts/schema_validator.py,检查 Google Search Console 的 Enhancements 报告,并对照 references/schema-types-guide.md 核对必填字段,最终输出审计报告,说明已存在、已损坏、缺失的内容及优先级。

  2. 实施新标记:识别页面类型并选择正确的 schema 类型,从 references/implementation-patterns.md 获取 JSON-LD 模板,填入真实页面内容,并给出放置建议(head 内联 script、CMS 插件或 GTM 注入),交付可直接复制粘贴的 JSON-LD。

  3. 验证与修复:在 rich-results.google.com 和 validator.schema.org 测试,将错误映射到具体缺失或格式错误的字段,交付修正后的 JSON-LD 并解释修复原因。

技能还包含 schema 类型选择表(如首页用 Organization + WebSite,文章用 Article + BreadcrumbList + Person,FAQ 页用 FAQPage,产品页用 Product + Offer + AggregateRating 等),以及堆叠规则(如非首页有面包屑时始终添加 BreadcrumbList,不得为不销售产品的页面添加 Product)。

使用方式

技能建议优先使用 JSON-LD,而非 Microdata 或 RDFa。放置方式为在 head 中通过 script type="application/ld+json" 嵌入,多个 schema 块可用独立 script 标签或数组嵌套。技能还提供 CMS 实施捷径:WordPress 可用 Yoast SEO 或 Rank Math,Webflow 可添加自定义 head 代码,Shopify 产品 schema 自动生成,自定义 CMS 可服务端生成 JSON-LD。

测试验证需使用三个工具:Google Rich Results Test、Schema.org Validator,以及本地脚本 scripts/schema_validator.py(运行命令:python3 scripts/schema_validator.py page.html)。部署后可通过 Google Search Console 的 Enhancements 查看真实错误,但需 1-2 周更新。

适用场景

适用于需要为网站添加或修复结构化数据的场景,包括争取 FAQ 下拉、星级评分、面包屑、HowTo 步骤等富媒体结果,以及提升在 Google AI Overviews、Perplexity、ChatGPT Search、Bing Copilot 等 AI 搜索中的可见性。技能还列出主动触发项,如 FAQ 内容缺少 FAQPage schema、Article schema 缺少 image 字段、通过 GTM 注入 schema 可能不被索引、dateModified 早于 datePublished、同一实体存在多个冲突 @type、Product schema 缺少 offers 等。

限制

资料未提供该技能的具体收费、价格、平台支持范围或效果保证。技能本身为提示词/工作流型技能,实际效果取决于页面内容、CMS 环境和搜索引擎政策。所有输出遵循结构化沟通标准:结论先行、What + Why + How、行动有负责人和截止时间、置信度标记(🟢 已验证 / 🟡 中等 / 🔴 假设)。相关技能包括 seo-audit、site-architecture、content-strategy、programmatic-seo,但 schema 专项工作应使用本技能。