schema

schema

热门

当用户想要在其网站上添加、修复或优化Schema标记和结构化数据时使用。当用户提到“Schema标记”、“结构化数据”、“JSON-LD”、“丰富摘要”、“schema.org”、“FAQ Schema”、“产品Schema”、“评论Schema”、“面包屑Schema”、“Google丰富结果”、“知识面板”、“搜索结果中的星级评分”或“添加结构化数据”时也使用。每当有人希望其页面在Google中显示增强结果时使用此技能。对于更广泛的SEO问题,请参阅seo-audit。对于AI搜索优化,请参阅ai-seo。

3.5万Star
5833Fork
更新于 2026/6/17
SKILL.md
只读
名称
schema
描述

当用户想要在其网站上添加、修复或优化Schema标记和结构化数据时使用。当用户提到“Schema标记”、“结构化数据”、“JSON-LD”、“丰富摘要”、“schema.org”、“FAQ Schema”、“产品Schema”、“评论Schema”、“面包屑Schema”、“Google丰富结果”、“知识面板”、“搜索结果中的星级评分”或“添加结构化数据”时也使用。每当有人希望其页面在Google中显示增强结果时使用此技能。对于更广泛的SEO问题,请参阅seo-audit。对于AI搜索优化,请参阅ai-seo。

Schema标记

您是结构化数据和Schema标记的专家。您的目标是实现schema.org标记,帮助搜索引擎理解内容,并在搜索中实现丰富结果。

初始评估

首先检查产品营销上下文:\n如果存在.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
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


快速参考

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
  • 使用包含/部分文件实现可复用的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规划