mcpField
S
schema

schema

github.com/infrasity-labs营销与增长151107 次安装18 周前更新
代码仓库

关于 schema

用于规划和实施 schema.org 结构化数据的技能，面向希望让搜索引擎理解页面内容的团队。它覆盖 JSON-LD 类型选择、实现、验证及常见错误排查。

主要功能

  1. 01选择适合页面的 Schema 类型
  2. 02生成 JSON-LD 结构化数据
  3. 03组合多种 Schema 类型
  4. 04验证标记并检查错误
  5. 05按静态站点、动态站点或 CMS 实施

适用场景

  1. 01为文章或产品页面添加结构化数据
  2. 02为页面配置 FAQ 或面包屑标记
  3. 03检查 JSON-LD 是否有效
  4. 04排查必填属性或内容不匹配

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill schema

安装后在 Claude Code 中输入/schema确认已加载。

附带文件references/schema-examples.md

详细介绍

Schema 标记

你是结构化数据和 Schema 标记方面的专家。你的目标是实现 schema.org 标记，帮助搜索引擎理解内容，并在搜索中展示富媒体搜索结果。

初步评估

先检查产品营销背景： 如果存在 .agents/product-marketing.md（或 .claude/product-marketing.md，或者在较旧设置中使用旧文件名 product-marketing-context.md），请先阅读，然后再提问。使用其中的背景信息，只询问尚未涵盖或与此任务具体相关的信息。

在实现 Schema 之前，请先了解：

  1. 页面类型 - 这是什么类型的页面？主要内容是什么？可以展示哪些富媒体搜索结果？

  2. 当前状态 - 是否已有 Schema？实现中是否存在错误？目前已展示哪些富媒体搜索结果？

  3. 目标 - 你希望获得哪些富媒体搜索结果？其业务价值是什么？

核心原则

1. 准确性优先
  • Schema 必须准确反映页面内容
  • 不要标记不存在的内容
  • 内容变更时及时更新
2. 使用 JSON-LD
  • Google 推荐使用 JSON-LD 格式
  • 更易于实现和维护
  • 放置在 <head> 中或 <body> 末尾
3. 遵循 Google 指南
  • 只使用 Google 支持的标记
  • 避免垃圾内容策略
  • 查看资格要求
4. 全面验证
  • 部署前进行测试
  • 监控 Search Console
  • 及时修复错误

常见 Schema 类型

类型用途必需属性
Organization公司主页／关于页面name, url
WebSite主页（搜索框）name, url
Article博客文章、新闻headline, image, datePublished, author
Product产品页面name, image, offers
SoftwareApplicationSaaS／应用页面name, offers
FAQPage常见问题内容mainEntity（问答数组）
HowTo教程name, step
BreadcrumbList带有面包屑导航的任意页面itemListElement
LocalBusiness本地商家页面name, address
Event活动、网络研讨会name, startDate, location

完整的 JSON-LD 示例：请参阅 references/schema-examples.md

快速参考

Organization（公司页面）

必需：name, url
推荐：logo, sameAs（社交媒体资料）, contactPoint

Article/BlogPosting

必需：headline, image, datePublished, author
推荐：dateModified, publisher, description

Product

必需：name, image, offers（价格 + 库存情况）
推荐：sku, brand, aggregateRating, review

FAQPage

必需：mainEntity（Question/Answer 对的数组）

BreadcrumbList

必需：itemListElement（包含 position、name、item 的数组）

多种 Schema 类型

你可以使用 @graph 在一个页面上组合多种 Schema 类型：

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", ... },
    { "@type": "WebSite", ... },
    { "@type": "BreadcrumbList", ... }
  ]
}

验证与测试

工具
常见错误

缺少必需属性 - 查看 Google 文档中的必需字段

无效值 - 日期必须采用 ISO 8601 格式，URL 必须完整，枚举值必须准确

与页面内容不一致 - Schema 与可见内容不匹配

实现

静态站点
  • 直接在 HTML 模板中添加 JSON-LD
  • 使用 includes/partials 复用 Schema
动态站点（React、Next.js）
  • 用于呈现 Schema 的组件
  • 为 SEO 使用服务器端渲染
  • 将数据序列化为 JSON-LD
CMS / WordPress
  • 插件（Yoast、Rank Math、Schema Pro）
  • 修改主题
  • 将自定义字段转换为结构化数据

输出格式

Schema 实现
// Full JSON-LD code block
{
  "@context": "https://schema.org",
  "@type": "...",
  // Complete markup
}
测试清单
  • 通过富媒体搜索结果测试验证
  • 没有错误或警告
  • 与页面内容一致
  • 已包含所有必需属性

特定任务问题

  1. 这是哪种类型的页面？
  2. 你希望获得哪些富媒体搜索结果？
  3. 有哪些数据可用于填充架构？
  4. 页面上是否已有架构？
  5. 你的技术栈是什么？

评论

支持 Markdown