SuperAPI AI 工具集

schema-markup

营销与增长

查看项目

更新于 10-16 09:59

技能介绍

用途:实现 schema.org 结构化数据,帮助搜索引擎理解页面内容并争取搜索富媒体结果,包括新增、修复与优化 JSON-LD 标记。

开始前先做评估:若存在 .claude/product-marketing-context.md 先读取;确认页面类型与主要内容、当前是否已有 schema 及其错误、目标富媒体结果与业务价值。

核心原则:准确性优先,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。

验证工具:Google Rich Results Test(https://search.google.com/test/rich-results)、Schema.org Validator(https://validator.schema.org/)、Search Console 的 Enhancements 报告。常见错误:缺少必填属性、日期非 ISO 8601、URL 非完整、枚举值不精确、与页面可见内容不符。

实现方式:静态站点在 HTML 模板中直接添加 JSON-LD,可用 include/partial 复用;React、Next.js 等动态站点用组件渲染并服务端渲染以保证 SEO,再将数据序列化为 JSON-LD;CMS/WordPress 可用插件(Yoast、Rank Math、Schema Pro)、主题修改或自定义字段转结构化数据。

输出包含完整 JSON-LD 代码块与测试清单(通过富结果测试、无错误警告、与页面内容一致、包含全部必填属性)。相关技能:seo-audit、ai-seo、programmatic-seo。具体价格、平台支持范围等资料暂未提供。