🚀 快速安装

复制以下命令并运行,立即安装此 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 之前,需要了解:

  1. 页面类型 – 这是什么类型的页面?主要内容是什么?可能实现哪些丰富结果?
  2. 当前状态 – 存在任何现有的 schema 吗?实施中有错误吗?已经出现了哪些丰富结果?
  3. 目标 – 你针对哪些丰富结果?商业价值是什么?

核心原则

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", ... }
  ]
}

验证与测试

工具

常见错误

缺少必需属性 – 查看谷歌文档中必填字段的要求

无效值 – 日期必须采用 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": "...",
  // 完整的标记
}

测试清单

  • 在富搜索结果测试工具中验证通过
  • 无错误或警告
  • 与页面内容匹配
  • 包含所有必需属性

特定任务问题

  1. 这是什么类型的页面?
  2. 你希望实现什么样的丰富结果?
  3. 有哪些数据可以用来填充 schema?
  4. 页面上有现有的 schema 吗?
  5. 你的技术栈是什么?

相关技能

  • seo-audit:用于整体 SEO,包括 schema 审查
  • ai-seo:用于 AI 搜索优化(schema 有助于 AI 理解内容)
  • programmatic-seo:用于大规模模板化 schema
  • site-architecture:用于规划面包屑结构和导航 schema

📄 原始文档

完整文档(英文):

https://skills.sh/coreyhaines31/marketingskills/schema-markup

💡 提示:点击上方链接查看 skills.sh 原始英文文档,方便对照翻译。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。