seo-schema

支持材料可用性

此目录副本包含以下内嵌指导，但不包含以下支持材料路径。这些是外部前置条件，并非随附文件：

• <support-root>/references/schema-types.md

请从声明的上游来源或用户提供的该来源安装副本中获取所需材料。相对于该安装副本解析每个路径，检查其内容，并核实适用的许可证和执行前置条件。所需文件不存在时，不要运行命令或声称已遵循所引用的流程。不要伪造缺失的脚本，也不要将名称相同但无关的文件视为等效文件。此处已完整记录且可独立执行的步骤，可在用户授权范围内继续；将任何依赖步骤报告为不可用。

Schema 标记分析与生成

适用场景

• 用于检测、验证或生成 Schema.org 结构化数据。
• 用户询问 JSON-LD、富媒体搜索结果或标记机会时使用。
• 当 Schema 验证是主要任务，而非更广泛的 SEO 审核时使用。

检测

1. 扫描页面源代码，查找 JSON-LD <script type="application/ld+json">
2. 检查 Microdata（itemscope、itemprop）
3. 检查 RDFa（typeof、property）
4. 始终优先推荐 JSON-LD（这是 Google 明确表示的偏好）

验证

• 检查各 Schema 类型所需的属性
• 根据 Google 支持的富媒体搜索结果类型进行验证
• 检查常见错误：
  • 缺少 @context
  • @type 无效
  • 数据类型错误
  • 占位文本
  • 相对 URL（应为绝对 URL）
  • 日期格式无效
• 标记已弃用的类型（见下文）

Schema 类型状态（历史快照，使用前请核实）

Schema.org 词汇的有效性与 Google 富媒体搜索结果的适用资格并不相同。Google 已停用某项搜索结果功能，并不意味着相应的 Schema.org 类型无效；删除其他方面真实无误的标记前，请查阅当前官方文档，确认实际的搜索展示位置。未随附 schema/templates.json。

请阅读 references/schema-types.md 以查看完整列表。关键规则：

有效（可自由推荐）：

Organization、LocalBusiness、SoftwareApplication、WebApplication、Product（截至 2025 年 4 月，包含 Certification 标记）、ProductGroup、Offer、Service、Article、BlogPosting、NewsArticle、Review、AggregateRating、BreadcrumbList、WebSite、WebPage、Person、ProfilePage、ContactPage、VideoObject、ImageObject、Event、JobPosting、Course、DiscussionForumPosting

视频与专业类型（可自由推荐）：

BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode

请参阅 schema/templates.json，查看这些类型可直接使用的 JSON-LD 模板。

**JSON-LD 与 JavaScript 渲染：**根据 Google 于 2025 年 12 月发布的 JS SEO 指南，通过 JavaScript 注入的结构化数据可能会延迟处理。对于有时效要求的标记（尤其是 Product、Offer），请将 JSON-LD 包含在初始服务器渲染的 HTML 中。

受限（仅适用于特定网站）：

• FAQ：仅限政府和医疗卫生主管机构网站（2023 年 8 月起受限）

Google 富媒体搜索结果的历史停用情况（不代表词汇无效）：

• HowTo：富媒体搜索结果于 2023 年 9 月移除
• SpecialAnnouncement：于 2025 年 7 月 31 日弃用
• CourseInfo、EstimatedSalary、LearningVideo：于 2025 年 6 月停用
• ClaimReview：于 2025 年 6 月从富媒体搜索结果中停用
• VehicleListing：于 2025 年 6 月从富媒体搜索结果中停用
• Practice Problem：于 2025 年末从富媒体搜索结果中停用
• Dataset：于 2025 年末从富媒体搜索结果中停用
• Book Actions：弃用后又恢复，截至 2026 年 2 月仍可使用（历史说明）

生成

为页面生成架构时：

1. 根据内容分析确定页面类型
2. 选择合适的架构类型
3. 生成有效的 JSON-LD，包含所有必需属性和推荐属性
4. 仅包含真实、可验证的数据。使用明确标记的占位符供用户填写
5. 提交前验证输出

常见架构模板

组织

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "[Company Name]",
  "url": "[Website URL]",
  "logo": "[Logo URL]",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "[Phone]",
    "contactType": "customer service"
  },
  "sameAs": [
    "[Facebook URL]",
    "[LinkedIn URL]",
    "[Twitter URL]"
  ]
}

本地商家

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "[Business Name]",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "[Street]",
    "addressLocality": "[City]",
    "addressRegion": "[State]",
    "postalCode": "[ZIP]",
    "addressCountry": "US"
  },
  "telephone": "[Phone]",
  "openingHours": "Mo-Fr 09:00-17:00",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "[Lat]",
    "longitude": "[Long]"
  }
}

文章/博客文章

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "[Title]",
  "author": {
    "@type": "Person",
    "name": "[Author Name]"
  },
  "datePublished": "[YYYY-MM-DD]",
  "dateModified": "[YYYY-MM-DD]",
  "image": "[Image URL]",
  "publisher": {
    "@type": "Organization",
    "name": "[Publisher]",
    "logo": {
      "@type": "ImageObject",
      "url": "[Logo URL]"
    }
  }
}

输出

• SCHEMA-REPORT.md：检测和验证结果
• generated-schema.json：可直接使用的 JSON-LD 片段

验证结果

架构	类型	状态	问题
...	...	✅/⚠️/❌	...

建议

• 缺失的架构机会
• 需要修复的验证问题
• 用于实施的生成代码

错误处理

情况	操作
URL 无法访问	报告包含状态码的连接错误。建议检查 URL 是否正确，以及页面是否需要身份验证。
未找到架构标记	报告未检测到 JSON-LD、Microdata 或 RDFa。根据页面内容分析，推荐合适的架构类型。
JSON-LD 语法无效	解析并报告具体语法错误（缺少括号、尾随逗号、键未加引号）。提供修正后的 JSON-LD 输出。
检测到已弃用的架构类型	标记已弃用的类型及其停用日期。推荐当前的替代类型；若没有替代类型，则建议移除。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为针对特定环境的验证、测试或专家评审的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。