SEO 全能分析

技能文档

---
name: seo
title: SEO 全能分析
category: 内容创作
description: "全面的 SEO 分析技能，支持整站审计、单页分析、技术 SEO（可爬取性、可索引性、Core Web Vitals/INP）、Schema 结构化数据、内容质量评估（E-E-A-T）、图片优化、站点地图分析，以及面向 AI 搜索（AI Overviews/ChatGPT/Perplexity）的生成引擎优化（GEO）。支持 SaaS、电商、本地服务、媒体出版、代理机构等行业自动识别。当用户请求 SEO 分析、网站审计、结构化数据、Core Web Vitals、站点地图、E-E-A-T 评估、AI 搜索优化、GEO 优化、技术 SEO、内容质量检查、页面速度分析时触发。"
---

# SEO：全能 SEO 分析技能

**调用方式：** `/seo <命令> <URL或参数>`

**脚本位置：** 技能根目录 `scripts/` 下。

覆盖全行业（SaaS、本地服务、电商、媒体出版、代理机构）的综合 SEO 分析。协调 21 个专项子技能与 18 个子代理（+ 3 个可选扩展子技能：seo-dataforseo、seo-firecrawl、seo-image-gen）。

## 快速参考

| 命令 | 功能说明 |
|------|----------|
| `/seo audit <url>` | 整站审计，并行子代理分析 |
| `/seo page <url>` | 单页深度分析 |
| `/seo sitemap <url 或 generate>` | 分析或生成 XML 站点地图 |
| `/seo schema <url>` | 检测、验证并生成 Schema.org 结构化数据 |
| `/seo images <url 或 optimize>` | 图片 SEO：页面审计、SERP 分析、文件优化 |
| `/seo technical <url>` | 技术 SEO 审计（9 大类别） |
| `/seo content <url>` | E-E-A-T 与内容质量分析 |
| `/seo geo <url>` | AI Overviews / 生成引擎优化 |
| `/seo plan <业务类型>` | 战略性 SEO 规划 |
| `/seo programmatic [url\|plan]` | 程序化 SEO 分析与规划 |
| `/seo competitor-pages [url\|generate]` | 竞品对比页面生成 |
| `/seo local <url>` | 本地 SEO 分析（GBP、引用、评论、地图包） |
| `/seo maps [命令] [参数]` | 地图智能（地理网格、GBP 审计、评论、竞品） |
| `/seo hreflang [url]` | Hreflang/国际化 SEO 审计与生成 |
| `/seo google [命令] [url]` | Google SEO API（GSC、PageSpeed、CrUX、Indexing、GA4） |
| `/seo backlinks <url>` | 外链分析（免费：Moz、Bing、CC；付费：DataForSEO） |
| `/seo cluster <种子关键词>` | 基于 SERP 的语义聚类与内容架构 |
| `/seo sxo <url>` | 搜索体验优化：页面类型分析、用户故事、人物画像 |
| `/seo drift baseline <url>` | 捕获 SEO 基线用于变化监控 |
| `/seo drift compare <url>` | 对比当前状态与已存储基线 |
| `/seo drift history <url>` | 展示随时间变化的漂移历史 |
| `/seo ecommerce <url>` | 电商 SEO：产品结构化数据、市场情报 |
| `/seo firecrawl [命令] <url>` | 全站爬取与站点映射（扩展） |
| `/seo dataforseo [命令]` | 通过 DataForSEO 获取实时 SEO 数据（扩展） |
| `/seo image-gen [用途] <描述>` | AI 生成 SEO 相关图片资源（扩展） |
| `/seo flow [阶段] [url\|主题]` | FLOW 框架：面向 Find、Leverage、Optimize、Win、Local 阶段的循证提示 |

## 技能工作流

### 步骤1：整站审计编排

当用户调用 `/seo audit` 时，按以下流程并行委派子代理：

1. 检测业务类型（SaaS、本地服务、电商、媒体出版、代理机构、其他）
2. 启动子代理：seo-technical、seo-content、seo-schema、seo-sitemap、seo-performance、seo-visual、seo-geo
3. 若检测到 Google API 凭据（`python scripts/google_auth.py --check`），额外启动 seo-google 代理
4. 若检测到本地服务业务，额外启动 seo-local 代理
5. 若检测到本地服务业务且 DataForSEO MCP 可用，额外启动 seo-maps 代理
6. 若检测到外链 API（`python scripts/backlinks_auth.py --check`），额外启动 seo-backlinks 代理
7. 若 Firecrawl MCP 可用，使用 `firecrawl_map` 发现站点所有 URL 后再分析
8. 若检测到内容策略信号（博客、支柱页面、主题集群），额外启动 seo-cluster 代理
9. 若检测到电商，额外启动 seo-ecommerce 代理
10. 若该 URL 存在漂移基线（`python scripts/drift_history.py <url>`），额外启动 seo-drift 代理
11. 完整审计中始终包含 seo-sxo（搜索体验适用于所有站点）
12. 汇总结果，生成统一报告与 SEO 健康评分（0-100）
13. 创建优先级行动计划（严重 → 高 → 中 → 低）
14. **提供 PDF 报告**："生成专业 PDF 报告？使用 `/seo google report full`"

对于单独命令，直接加载对应子技能。
任何分析命令完成后，提供通过 `scripts/google_report.py` 生成 PDF 报告的选项。

### 步骤2：行业识别

从首页信号检测业务类型：

- **SaaS**：定价页面、/features、/integrations、/docs、"免费试用"、"注册"
- **本地服务**：电话号码、地址、服务区域、"服务 [城市]"、Google Maps 嵌入 → 自动建议 `/seo local` 深度分析
- **电商**：/products、/collections、/cart、"加入购物车"、产品结构化数据
- **媒体出版**：/blog、/articles、/topics、文章结构化数据、作者页面、发布日期
- **代理机构**：/case-studies、/portfolio、/industries、"我们的作品"、客户 Logo

### 步骤3：质量门禁

读取 `references/quality-gates.md` 获取各页面类型的内容薄弱阈值。
硬性规则：

- 30+ 个地域页面时发出警告（确保 60%+ 唯一内容）
- 50+ 个地域页面时强制停止（需用户说明理由）
- 不再推荐 HowTo 结构化数据（2023 年 9 月已弃用）
- FAQ 结构化数据用于 Google 富结果：仅限政府与医疗网站（2023 年 8 月限制）；商业站点已有 FAQPage 标记为信息优先级（非严重），注明 AI/LLM 引用价值；新增 FAQPage 不建议以获取 Google 收益为目的
- 所有 Core Web Vitals 引用使用 INP，不使用 FID

### 步骤4：评分与优先级

**SEO 健康评分（0-100）**

各类别加权汇总：

| 类别 | 权重 |
|------|------|
| 技术 SEO | 22% |
| 内容质量 | 23% |
| 页面 SEO | 20% |
| 结构化数据 | 10% |
| 性能（CWV） | 10% |
| AI 搜索就绪度 | 10% |
| 图片 | 5% |

**优先级等级：**

- **严重**：阻碍索引或导致惩罚（需立即修复）
- **高**：显著影响排名（1 周内修复）
- **中**：优化机会（1 个月内修复）
- **低**：锦上添花（纳入待办）

## 子技能清单

本技能协调 21 个专项子技能（+ 3 个扩展）：

1. **seo-audit** — 整站审计，并行委派
2. **seo-page** — 单页深度分析
3. **seo-technical** — 技术 SEO（9 大类别）
4. **seo-content** — E-E-A-T 与内容质量
5. **seo-schema** — 结构化数据检测与生成
6. **seo-images** — 图片优化、SERP 分析、文件优化
7. **seo-sitemap** — 站点地图分析与生成
8. **seo-geo** — AI Overviews / GEO 优化
9. **seo-plan** — 战略规划与模板
10. **seo-programmatic** — 程序化 SEO 分析与规划
11. **seo-competitor-pages** — 竞品对比页面生成
12. **seo-hreflang** — Hreflang/国际化审计、文化画像、内容对等
13. **seo-local** — 本地 SEO（GBP、NAP、引用、评论、本地结构化数据、多门店）
14. **seo-maps** — 地图智能（地理网格、GBP 审计、评论、竞品半径）
15. **seo-google** — Google SEO API（GSC、PageSpeed、CrUX、Indexing API、GA4）
16. **seo-backlinks** — 外链分析（免费：Moz、Bing、CC；付费：DataForSEO）
17. **seo-cluster** — 基于 SERP 的语义聚类
18. **seo-sxo** — 搜索体验优化
19. **seo-drift** — SEO 漂移监控
20. **seo-ecommerce** — 电商 SEO 情报
21. **seo-firecrawl** — 通过 Firecrawl MCP 全站爬取与映射（扩展）
22. **seo-dataforseo** — 通过 DataForSEO MCP 获取实时 SEO 数据（扩展）
23. **seo-image-gen** — 通过 Gemini 生成 SEO 图片资源（扩展）
24. **seo-flow** — FLOW 框架集成（Find → Leverage → Optimize → Win，41 个 AI 提示，CC BY 4.0）

## 子代理

审计期间用于并行分析：

- `seo-technical` — 可爬取性、可索引性、安全性、CWV
- `seo-content` — E-E-A-T、可读性、内容薄弱度
- `seo-schema` — 检测、验证、生成
- `seo-sitemap` — 结构、覆盖率、质量门禁
- `seo-performance` — Core Web Vitals 测量
- `seo-visual` — 截图、移动端测试、首屏内容
- `seo-geo` — AI 爬虫访问、llms.txt、可引用性、品牌提及信号
- `seo-local` — GBP 信号、NAP 一致性、评论、本地结构化数据（条件：检测到本地服务时启动）
- `seo-maps` — 地理网格排名追踪、GBP 审计、评论情报、竞品半径映射（条件：本地服务且 DataForSEO MCP 可用）
- `seo-google` — CWV 实测数据、URL 索引状态、自然流量趋势（条件：检测到 Google API 凭据）
- `seo-backlinks` — 外链数据：DA/PA、引用域、锚文本、有毒链接（条件：检测到 Moz/Bing API 或始终获取 CC 域级指标）
- `seo-cluster` — 语义聚类分析（条件：检测到内容策略）
- `seo-sxo` — 页面类型不匹配、用户故事、人物画像评分（完整审计中始终启动）
- `seo-drift` — 基线对比（条件：该 URL 存在漂移基线）
- `seo-ecommerce` — 产品结构化数据、市场情报（条件：检测到电商）
- `seo-dataforseo` — 实时 SERP、关键词、外链、本地 SEO 数据（扩展，可选）
- `seo-image-gen` — SEO 图片审计与生成计划（扩展，可选）
- `seo-firecrawl` — 全站爬取与站点映射（扩展，可选；审计用于 URL 发现）

## 参考文件

按需加载（不要在启动时全部加载）：

- `references/cwv-thresholds.md`：当前 Core Web Vitals 阈值与测量详情
- `references/schema-types.md`：所有支持的结构化数据类型与弃用状态
- `references/eeat-framework.md`：E-E-A-T 评估标准（2025 年 9 月 QRG 更新）
- `references/quality-gates.md`：内容长度最低要求、唯一性阈值
- `references/local-seo-signals.md`：本地排名因素、评论基准、引用层级、GBP 状态
- `references/local-schema-types.md`：LocalBusiness 子类型、行业特定结构化数据与引用来源

地图专项参考（由 seo-maps 子技能加载，非启动时）：

- `references/maps-geo-grid.md`、`references/maps-gbp-checklist.md`、`references/maps-api-endpoints.md`、`references/maps-free-apis.md`

## 错误处理

| 场景 | 处理方式 |
|------|----------|
| 未识别的命令 | 列出快速参考表中的可用命令，建议最接近的命令 |
| URL 不可达 | 报告错误并建议用户核实 URL，不要猜测站点内容 |
| 审计中子技能失败 | 报告已成功子技能的部分结果，明确标注失败的子技能及原因，建议单独重跑该子技能 |
| 业务类型识别模糊 | 展示前两种检测类型及支持信号，请用户确认后再进行行业专项推荐 |

使用说明

# SEO 全能分析

一站式 SEO 分析技能，覆盖整站审计、技术 SEO、内容质量、结构化数据、AI 搜索优化等全链路。

## 使用

```bash
# 整站审计
/seo audit https://example.com

# 单页分析
/seo page https://example.com/page

# 技术 SEO
/seo technical https://example.com

# 结构化数据检测
/seo schema https://example.com

# AI 搜索优化
/seo geo https://example.com

# 本地 SEO
/seo local https://example.com
```

## 工作原理

技能自动识别网站所属行业（SaaS、电商、本地服务、媒体出版、代理机构），按需启动专项子代理并行分析，最终汇总为统一的 SEO 健康评分（0-100）与优先级行动计划。支持 24 个子命令，涵盖技术审计、内容评估、外链分析、语义聚类、漂移监控等完整 SEO 工作流。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。