mcpField
3
30x-seo-schema

30x-seo-schema

github.com/norahe0304-art营销与增长5663 次安装33 周前更新
代码仓库

关于 30x-seo-schema

30x-seo-schema 是用于检测、验证和生成网页结构化数据标记的技能。它会检查受支持的类型，并生成检测报告及可用于实施的 JSON-LD 片段。

主要功能

  1. 01检测 JSON-LD、Microdata 和 RDFa
  2. 02验证结构化数据属性和值
  3. 03检查富媒体搜索结果支持及类型状态
  4. 04生成 JSON-LD 标记
  5. 05报告检测结果与修复建议

适用场景

  1. 01审查现有页面结构化数据
  2. 02修复无效或不完整的标记
  3. 03为页面添加合适的结构化数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/norahe0304-art/30x-seo --skill 30x-seo-schema

安装后在 Claude Code 中输入/30x-seo-schema确认已加载。

详细介绍

Schema 标记分析与生成

检测

  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 类型状态（截至 2026 年 2 月）

阅读 references/schema-types.md 查看完整列表。主要规则：

ACTIVE — 可放心推荐：

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

VIDEO & SPECIALIZED — 可放心推荐：

BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode

参阅 schema/templates.json，获取这些类型的即用型 JSON-LD 模板。

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

RESTRICTED — 仅适用于特定网站：
  • FAQ：仅适用于政府和医疗卫生主管机构网站（自 2023 年 8 月起受限）
DEPRECATED — 切勿推荐：
  • 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 月仍可使用（历史说明）

生成

为页面生成 Schema 时：

  1. 根据内容分析确定页面类型
  2. 选择合适的 Schema 类型
  3. 生成包含所有必需和建议属性的有效 JSON-LD
  4. 仅包含真实且可验证的数据——使用明确标记的占位符供用户填写
  5. 在呈现前验证输出

常见 Schema 模板

Organization
{
  "@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]"
  ]
}
LocalBusiness
{
  "@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]"
  }
}
Article/BlogPosting
{
  "@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 片段
验证结果
Schema类型状态问题
......✅/⚠️/❌...
建议
  • 尚未利用的 Schema 机会
  • 需要修复的验证问题
  • 用于实施的生成代码

[PROTOCOL]: 变更此标头后请更新，然后检查 CLAUDE.md

评论

支持 Markdown