SuperAPI AI 工具集

schema

营销与增长

查看项目

更新于 10-24 16:20

技能介绍

用途:Schema 技能用于在网站上添加、修复或优化 schema 标记与结构化数据,目标是让搜索引擎更好地理解页面内容,并使页面有资格获得富媒体搜索结果。

主要能力:技能以专家角色引导结构化数据实现流程。首先进行初步评估:先检查是否存在产品营销上下文文件(如 .agents/product-marketing.md、.claude/product-marketing.md 或旧版 product-marketing-context.md),读取后再询问未覆盖的信息;随后明确页面类型、当前 schema 状态与目标富媒体结果。核心原则包括:准确性优先,标记必须真实反映页面内容,不标记不存在的内容,并随内容更新维护;使用 Google 推荐的 JSON-LD 格式,便于实现维护,可置于 head 或 body 末尾;遵循 Google 指南,只使用受支持的标记,避免垃圾手法,核对资格要求;全面验证,部署前测试、监控 Search Console、及时修复错误。

常见类型与要求:Organization(公司主页/关于页,必填 name、url);WebSite(主页搜索框,name、url);Article(博客/新闻,headline、image、datePublished、author);Product(产品页,name、image、offers);SoftwareApplication(SaaS/应用页,name、offers);FAQPage(FAQ 内容,mainEntity 问答数组);HowTo(教程,name、step);BreadcrumbList(含面包屑的页面,itemListElement);LocalBusiness(本地商家页,name、address);Event(活动/网络研讨会,name、startDate、location)。完整 JSON-LD 示例参见 references/schema-examples.md。多类型可在同一页面通过 @graph 组合,例如 Organization、WebSite 与 BreadcrumbList。

使用方式:技能按任务引导输出。实现时提供完整 JSON-LD 代码块,并附测试清单(在富媒体结果测试中通过验证、无错误或警告、与页面内容匹配、包含所有必填属性)。验证工具包括 Google 富媒体结果测试(https://search.google.com/test/rich-results)、schema.org 验证器(https://validator.schema.org/)以及 Search Console 增强报告。常见错误包括缺失必填属性、无效值(日期须为 ISO 8601、URL 须完整限定、枚举值须精确)以及与页面可见内容不匹配。

实现途径:静态站点可直接在 HTML 模板中加入 JSON-LD,或用 includes/partials 复用 schema;动态站点(React、Next.js)可用组件渲染 schema 并服务端渲染以利 SEO,将数据序列化为 JSON-LD;CMS/WordPress 可通过插件(Yoast、Rank Math、Schema Pro)、主题修改或自定义字段输出结构化数据。

适用场景:页面需要富媒体结果、FAQ/教程/产品/活动等结构化展示,或需要审查与修复现有 schema 错误时。

限制:资料未提供价格、收费模式、平台兼容性细节或效果保证;实际富媒体资格取决于 Google 规则与页面内容,技能本身不承诺排名或展示效果。