seo-metadata-audit

SEO 元数据审计技能

知识来源： 哥飞撰写的《影响 SEO 最重要的 10 个 metadata》。

概述

使用此技能审计网页最重要的 SEO 元数据，并制定按优先级排序的修复计划。该技能适用于 SEO 从业者、开发者、创始人和内容团队，用于诊断页面是否向搜索引擎提供了清晰、可抓取、规范、适合移动设备且结构化的信号。

何时使用此技能

当用户提供 URL、HTML、页面规范或元数据列表，并提出以下请求时，使用此技能：

• “审计此页面的 SEO 元数据。”
• “我的标题和描述写得好吗？”
• “我需要 canonical、robots、schema 或 Open Graph 标签吗？”
• “为什么此页面排名不佳或显示异常？”
• “为此页面创建元数据。”

核心原则

SEO 元数据是一个系统：每个标签都能说明页面主题、搜索引擎应如何处理页面，以及用户在搜索或社交场景中如何看到页面。不要在优化某个标签的同时，破坏可抓取性、规范化、移动端渲染或语义结构。

工作流清单

工作流	用户提问模式	输入	步骤	输出	是否有独立触发条件？	是否有独立参考资料？	分诊评分	是否应设为子技能？	原因
完整元数据审计	“审计此页面”	URL/HTML、目标关键词、页面用途	检查所有标签类别；按优先级排列问题	优先级问题表	是	是	3	否	核心工作流；各标签之间相互影响。
搜索摘要优化	“修正标题/描述”	标题、描述、关键词、意图	检查长度、唯一性、点击吸引力	多个改写版本	是	是	3	否	范围较窄，但使用相同的元数据评分方法。
抓取/索引控制	“此页面应该被索引吗？”	页面角色、重复内容、robots/canonical	确定索引、跟踪、canonical 设置	索引指令计划	是	是	3	否	由于输出会纳入审计计划，因此保留在同一文件中。
结构化数据/社交预览	“添加 schema/Open Graph”	页面类型、实体数据、社交预览	选择 schema 和 OG/Twitter 标签	标记清单	是	是	3	否	使用相同的输入和修复报告。

架构理由

元数据标签可以分别检查，但问题往往源于标签之间的相互作用：canonical 可能覆盖索引意图，标题会影响搜索摘要的相关性，标题层级和 schema 会影响语义清晰度，而 viewport 会影响移动端渲染。单一的审计技能可以清晰呈现这些依赖关系。

维度 1：相关性和搜索摘要信号

规则： 标题、描述和标题层级必须清晰传达页面主题和搜索意图，且不得堆砌关键词。

要问的关键问题：

• 标题是否独特、简洁且与关键词相关？
• 描述是否使用自然语言来提升点击率？
• 是否只有一个明确的 H1，并且 H2-H6 层级是否合理？

判断标准/清单：

• 尽可能将标题控制在 50-60 个字符左右。
• 尽可能将描述控制在 150-160 个字符左右。
• 设置一个与页面意图一致的 H1。
• 标题层级应构建页面结构，而非仅用于视觉样式。

警示信号：

• 多个页面使用重复标题。
• 标题或描述中堆砌关键词。
• 缺少 H1，或存在多个令人困惑的 H1。

Agent 指令：

当用户分享 HTML 或元数据时，首先审计搜索摘要信号，因为这些信号会影响搜索引擎的理解和用户的点击行为。

维度 2：抓取、索引和规范化控制

规则： Robots 和 canonical 标签必须告知搜索引擎哪些 URL 值得索引，以及应如何整合权重。

要问的关键问题：

• 此页面是否应该被索引？
• canonical 是否指向真正的首选 URL？
• 重复页面或带参数的页面是否已正确整合？
• 重要页面是否被意外屏蔽？

决策标准 / 检查清单：

• Robots 元标签符合页面的业务角色。
• Canonical 指向正确的自身 URL 或首选等效 URL。
• Nofollow 仅用于不可信、付费或用户生成的链接。
• 确保不会意外地全局应用索引控制。

警示信号：

• 每个页面的 Canonical 都指向首页。
• 重要页面被标记为 noindex。
• 在内部链接上不加区分地使用 Nofollow。

Agent 指令：

对于索引问题，先说明期望的搜索引擎行为，再选择与该行为相符的 robots 和 canonical 指令。

维度 3：媒体、移动设备与编码基础

规则： 搜索引擎和用户需要可访问的图片、适配移动设备的页面呈现，以及正确的字符解读。

要提出的关键问题：

• 有意义的图片是否具有描述性 alt 文本？
• 是否配置了适用于响应式移动显示的 viewport？
• charset 是否正确声明？

决策标准 / 检查清单：

• Alt 自然地描述图片内容或功能。
• Viewport 包含响应式宽度和缩放设置。
• Charset 在文档前部声明，且与文档相符。

警示信号：

• 有信息价值的图片使用空 alt。
• 面向移动设备的页面缺少 viewport。
• 编码问题导致摘要或内容显示异常。

Agent 指令：

审查技术元数据时，即使这些问题并非用户最初关注的重点，也应将其标记为基础问题。

维度 4：结构化与社交上下文

规则： Schema 和社交元数据有助于机器与平台理解、分类和预览页面。

要提出的关键问题：

• 哪种 Schema 类型适合此页面？
• 必需的结构化字段是否齐全且准确？
• Open Graph 或社交标签是否符合预期的分享预览？

决策标准 / 检查清单：

• Schema 与页面类型和可见内容相符。
• 结构化数据准确，不含垃圾信息。
• 社交标题、描述和图片均经过审慎设计。

警示信号：

• Schema 声明了页面上不可见的内容。
• 缺少社交图片，或预览文案不匹配。
• 添加结构化数据却没有明确的页面级目的。

Agent 指令：

只有在确定页面类型、实体和用户意图后，才建议 Schema 和社交标签。

查询响应框架

查询类型 1：完整的 SEO 元数据审查

1. 确定页面用途和目标搜索意图。
2. 审查相关性、抓取与索引、技术基础以及结构化与社交上下文。
3. 按搜索影响和实施风险对问题排序。
4. 提供修正后的标签示例。

查询类型 2：生成元数据

1. 如缺少信息，询问页面用途、主要关键词、品牌、Canonical URL、页面类型和区域设置。
2. 拟定标题、描述、Canonical、Robots、OG、Twitter、Viewport、Charset 和 Schema 建议。
3. 解释为何包含或省略每个标签。

查询类型 3：诊断排名 / 索引问题

1. 首先检查索引资格和 Canonical。
2. 然后检查标题、标题层级、内容一致性和 Schema。
3. 将元数据问题与更广泛的内容、权威性和技术 SEO 问题区分开来。

输出格式

## SEO Metadata Audit
**Page:** ...
**Verdict:** Healthy / Needs fixes / Indexing risk / Snippet weak

| Tag / Signal | Status | Issue | Recommended Fix | Priority |
|---|---|---|---|---|

## Corrected Metadata
```html
...

实施说明

• ...

引用

• ...

## Critical Reminders

1. Title is important, but metadata is a system.
2. Description influences clicks even when it is not a direct ranking factor.
3. Canonical errors can erase good content from search visibility.
4. Do not block important pages accidentally.
5. Schema must describe real visible content.

## CITATION RULES

Every substantive metadata recommendation must include a citation to the source quote files.

**Quote files:**
- `seo-metadata-quotes.md` — strategy, title, description, H1, alt, nofollow, canonical, and canonical mistakes.
- `seo-technical-quotes.md` — technical tag details, robots, viewport, charset, Open Graph, and schema markup.

**Citation format:**

> "Author's exact words here."
>
> — [*影响SEO最重要的10个metadata*, cited excerpt](https://github.com/simbajigege/book2skills/blob/main/skills/seo-metadata-audit/quotes/FILENAME.md#ANCHOR)

**Anchor mapping:**
- `seo-metadata-quotes.md`: `#comprehensive-strategy`, `#title-importance`, `#title-keyword-ranking`, `#semantic-matching`, `#description-click-rate`, `#h1-essential`, `#alt-for-image-search`, `#nofollow-weight`, `#canonical-weight-aggregation`, `#canonical-mistake`
- `seo-technical-quotes.md`: `#comprehensive-seo-strategy`, `#title-length-importance`, `#title-brand-position`, `#description-length`, `#heading-hierarchy`, `#alt-description-best-practice`, `#nofollow-evolution`, `#robots-meta-control`, `#canonical-purpose`, `#viewport-mobile`, `#charset-encoding`, `#open-graph-social`, `#schema-markup`

**Rules:**
- Cite the closest tag-specific anchor for each major recommendation.
- If auditing a real page, distinguish observed defects from general best practice.
- Do not invent quote text; use exact quote files only.