seo-structured-data

结构化数据诊断模块

本模块负责检查网站的结构化数据实现，满分 15 分。结构化数据是让搜索引擎和 AI 引擎理解页面内容语义的关键——没有它，你的内容只是一堆文字；有了它，引擎能准确知道"这是一篇文章""这是一个 FAQ""这是一家公司"。

检查项

1. Schema Markup（6 分）

检查方法：

1. 用 web_fetch 获取页面 HTML
2. 搜索 JSON-LD 块（<script type="application/ld+json">）
3. 搜索 Microdata 属性（itemscope、itemtype、itemprop）
4. 解析找到的 Schema，检查：
   • 使用了哪些 Schema 类型（Organization、WebSite、Article、FAQ、BreadcrumbList、Product、LocalBusiness 等）
   • 必填字段是否完整
   • 是否有嵌套 Schema（如 Article 内嵌 Author）
   • JSON-LD 语法是否正确
5. 根据页面类型评估是否使用了合适的 Schema：
   • 首页：Organization + WebSite
   • 文章页：Article + Author + BreadcrumbList
   • FAQ 页：FAQPage
   • 产品页：Product
   • 本地商家：LocalBusiness

评分：

• 6 分：有 JSON-LD + 使用了与页面类型匹配的 Schema + 必填字段完整
• 4 分：有 Schema 但类型不够完整或缺少部分推荐字段
• 2 分：有 Schema 但类型不匹配或语法有错误
• 0 分：无任何 Schema Markup

输出格式：

状态：✅/⚠️/❌
Schema 格式：JSON-LD / Microdata / 无
检测到的 Schema 类型：
- Organization ✅（字段完整度 X%）
- Article ⚠️（缺少 datePublished）
- ...

推荐但缺失的 Schema：
- FAQPage（页面有 FAQ 内容但未标记）
- BreadcrumbList（有面包屑导航但未加结构化标记）

修复建议：（具体 JSON-LD 代码示例）

2. Open Graph 标签（4 分）

Open Graph 决定了你的页面在社交平台（Facebook、LinkedIn、微信等）分享时的展示效果，同时也是 AI 引擎理解页面元信息的参考。

检查方法：

1. 检查以下必填 OG 标签：
   • og:title
   • og:description
   • og:image
   • og:url
   • og:type
2. 检查 og:image 的 URL 是否可访问
3. 检查 og:title 和 og:description 的长度是否合适
4. 检查 og:locale 是否与页面语言一致

评分：

• 4 分：5 个核心标签齐全 + 图片可访问 + 长度合适
• 3 分：核心标签齐全但有小问题（如图片不可访问）
• 1 分：有部分 OG 标签但不完整
• 0 分：无任何 OG 标签

输出格式：

状态：✅/⚠️/❌
OG 标签检查：
| 标签 | 状态 | 值 |
|------|------|-----|
| og:title | ✅/❌ | "..." |
| og:description | ✅/❌ | "..." |
| og:image | ✅/❌ | URL（可访问/不可访问）|
| og:url | ✅/❌ | "..." |
| og:type | ✅/❌ | "..." |

修复建议：（具体建议）

3. Twitter Card 标签（2 分）

检查方法：

1. 检查 twitter:card（summary / summary_large_image）
2. 检查 twitter:title
3. 检查 twitter:description
4. 检查 twitter:image
5. 如果缺少 twitter 专用标签，检查是否有 OG 标签可作为 fallback

评分：

• 2 分：twitter:card 存在 + 核心标签齐全（或 OG fallback 充分）
• 1 分：有部分标签但不完整
• 0 分：无任何 Twitter Card 标签且 OG 标签也无法作为 fallback