Schema Markup 是一个专注于结构化数据与 schema.org 标记的专家技能，目标是实现能够帮助搜索引擎理解内容、并争取搜索结果富媒体展示（rich results）的 schema.org 标记。
用途 该技能用于在网站上添加、修复或优化 schema 标记与结构化数据。当用户提及 schema markup、structured data 等关键词时同样适用。
初始评估 在实施 schema 之前，需要先了解：页面类型（这是什么页面、主要内容是什么、可能获得哪些富媒体结果）；当前状态（是否已有 schema、现有实现是否存在错误、已经出现了哪些富媒体结果）；目标（要争取哪些富媒体结果、其业务价值是什么）。
核心原则
- 准确性优先：schema 必须准确反映页面内容，不要标记不存在的内容，内容变化时保持同步更新。
- 使用 JSON-LD：Google 推荐 JSON-LD 格式，更易实现与维护，可放在 <head> 或 <body> 末尾。
- 遵循 Google 指南：只使用 Google 支持的标记，避免垃圾手段，审查资格要求。
- 全面验证：部署前测试，监控 Search Console，及时修复错误。
常见 Schema 类型
- Organization：用于公司/品牌首页或关于页面。必填属性 name、url；推荐属性 logo、sameAs（社交资料）、contactPoint。
- WebSite（含 SearchAction）：用于首页，可启用站内搜索框。必填属性 name、url；搜索框需 potentialAction 与 SearchAction。
- Article / BlogPosting：用于博客文章、新闻文章。必填属性 headline、image、datePublished、author；推荐属性 dateModified、publisher、description、mainEntityOfPage。
- Product：用于商品页（电商或 SaaS）。必填属性 name、image、offers（含 price 与 availability）；推荐属性 description、sku、brand、aggregateRating、review。
- SoftwareApplication：用于 SaaS 产品页、应用落地页。必填属性 name、offers（或免费标识）；推荐属性 applicationCategory、operatingSystem、aggregateRating。
- FAQPage：用于包含常见问题的页面。必填属性 mainEntity（Question/Answer 数组）。
- HowTo：用于指导性内容、教程。必填属性 name、step（HowToStep 数组）；推荐属性 image、totalTime、estimatedCost、supply/tool。
- BreadcrumbList：用于任何带面包屑导航的页面。
- LocalBusiness：用于本地商家位置页。必填属性 name、address（因业务类型而异）。
- Review / AggregateRating：用于评论页或带评论的产品。注意：自利性评论（评论自己的产品）违反指南，评论必须来自真实客户。
- Event：用于活动页、网络研讨会、会议。必填属性 name、startDate、location（线上活动则用 eventAttendanceMode）。
单页多类型 可以（且通常应该）在同一页面使用多种 schema 类型，通过 @graph 组织，并用 @id 相互引用，例如 Organization、WebSite、BreadcrumbList 组合。
验证与测试 工具：Google Rich Results Test（https://search.google.com/test/rich-results）、Schema.org Validator（https://validator.schema.org/）、Search Console 的 Enhancements 报告。 常见错误：缺少必填属性（需查 Google 文档，其要求与 schema.org 最低要求不同）；无效值（日期必须为 ISO 8601 格式、URL 必须为完整限定、枚举必须使用精确值）；与页面内容不匹配（schema 与可见内容不符、展示无评论产品的评分、价格与显示价格不一致）。
实现模式
- 静态站点：直接在 HTML 模板中添加 JSON-LD，使用 includes/partials 复用 schema。
- 动态站点（React、Next.js 等）：使用渲染 schema 的组件，服务端渲染以利 SEO，将数据序列化为 JSON-LD。
- CMS / WordPress：使用插件（Yoast、Rank Math、Schema Pro）、主题修改、自定义字段到结构化数据的映射。
输出格式 包含完整 JSON-LD 代码块、放置说明（在哪里添加代码以及如何添加）、测试清单（在 Rich Results Test 中验证、无错误或警告、与页面内容匹配、包含所有必填属性）。
需要更多上下文时可询问：这是什么类型的页面？希望获得哪些富媒体结果？有哪些数据可用于填充 schema？页面上是否已有 schema？实现的技术栈是什么？
相关技能 seo-audit（整体 SEO 含 schema 审查）、programmatic-seo（规模化模板化 schema）、analytics-tracking（衡量富媒体结果影响）。