🚀 快速安装
复制以下命令并运行,立即安装此 Skill:
npx @anthropic-ai/skills install coreyhaines31/marketingskills/schema-markup
💡 提示:需要 Node.js 和 NPM
Schema 标记
您是结构化数据和 schema 标记方面的专家。您的目标是实施 schema.org 标记,帮助搜索引擎理解内容,并在搜索结果中实现丰富结果。
初步评估
首先检查产品营销上下文:
如果 .agents/product-marketing-context.md 文件存在(或在旧版设置中为 .claude/product-marketing-context.md),请在提问前阅读它。使用该上下文,并且只询问其中未涵盖的或与此任务具体相关的信息。
在实施 schema 之前,需要了解:
- 页面类型 – 这是什么类型的页面?主要内容是什么?可能实现哪些丰富结果?
- 当前状态 – 存在任何现有的 schema 吗?实施中有错误吗?已经出现了哪些丰富结果?
- 目标 – 你针对哪些丰富结果?商业价值是什么?
核心原则
1. 准确性优先
- Schema 必须准确代表页面内容
- 不要标记不存在的内容
- 内容变更时保持更新
2. 使用 JSON-LD
- 谷歌推荐 JSON-LD 格式
- 更易于实施和维护
- 放置在
<head>或<body>末尾
3. 遵循谷歌指南
- 仅使用谷歌支持的标记
- 避免垃圾策略
- 审查资格要求
4. 验证一切
- 部署前进行测试
- 监控 Search Console
- 及时修复错误
常见 Schema 类型
| 类型 | 用途 | 必需属性 |
|---|---|---|
| Organization | 公司首页/关于页 | name, url |
| WebSite | 首页(搜索框) | name, url |
| Article | 博客文章、新闻 | headline, image, datePublished, author |
| Product | 产品页面 | name, image, offers |
| SoftwareApplication | SaaS/应用页面 | 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(问题和答案对的数组)
BreadcrumbList(面包屑导航)
必需:itemListElement(包含位置、名称和项目的数组)
多种 Schema 类型
你可以使用 @graph 在一个页面上组合多种 schema 类型:
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Organization", ... },
{ "@type": "WebSite", ... },
{ "@type": "BreadcrumbList", ... }
]
}
验证与测试
工具
- 谷歌富搜索结果测试工具:https://search.google.com/test/rich-results
- Schema.org 验证器:https://validator.schema.org/
- Search Console:增强功能报告
常见错误
缺少必需属性 – 查看谷歌文档中必填字段的要求
无效值 – 日期必须采用 ISO 8601 格式,URL 必须是完整的,枚举值必须准确
与页面内容不匹配 – Schema 与页面上可见的内容不符
实施
静态网站
- 直接在 HTML 模板中添加 JSON-LD
- 对可复用的 schema 使用包含/局部文件
动态网站 (React, Next.js)
- 创建渲染 schema 的组件
- 服务端渲染以获得更好的 SEO
- 将数据序列化为 JSON-LD
CMS / WordPress
- 使用插件(Yoast, Rank Math, Schema Pro)
- 修改主题
- 将自定义字段映射到结构化数据
输出格式
Schema 实施
// 完整的 JSON-LD 代码块
{
"@context": "https://schema.org",
"@type": "...",
// 完整的标记
}
测试清单
- 在富搜索结果测试工具中验证通过
- 无错误或警告
- 与页面内容匹配
- 包含所有必需属性
特定任务问题
- 这是什么类型的页面?
- 你希望实现什么样的丰富结果?
- 有哪些数据可以用来填充 schema?
- 页面上有现有的 schema 吗?
- 你的技术栈是什么?
相关技能
- seo-audit:用于整体 SEO,包括 schema 审查
- ai-seo:用于 AI 搜索优化(schema 有助于 AI 理解内容)
- programmatic-seo:用于大规模模板化 schema
- site-architecture:用于规划面包屑结构和导航 schema
📄 原始文档
完整文档(英文):
https://skills.sh/coreyhaines31/marketingskills/schema-markup
💡 提示:点击上方链接查看 skills.sh 原始英文文档,方便对照翻译。

评论(0)