SEO全站优化大师

技能文档

---
name: seo-full-site-optimizer
title: "SEO全站优化大师"
description: "全方位SEO分析与优化工具，覆盖技术SEO、内容质量、结构化数据、站点地图、Core Web Vitals、AI搜索优化等。支持SaaS、电商、本地服务等全行业。触发词：SEO、审计、结构化数据、Core Web Vitals、站点地图、E-E-A-T、AI概览、GEO、技术SEO、内容质量、页面速度、结构化数据。"
category: "内容创作"
user-invokable: true
argument-hint: "[命令] [url]"
---

# SEO全站优化大师

**调用方式：** `/seo $1 $2`，其中 `$1` 为命令，`$2` 为URL或参数。

**脚本位置：** 插件根目录 `scripts/` 下。

全方位SEO分析，覆盖所有行业（SaaS、本地服务、电商、媒体出版、代理机构）。协调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概览 / 生成式引擎优化 |
| `/seo plan <业务类型>` | 战略性SEO规划 |
| `/seo programmatic [url\|plan]` | 程序化SEO分析与规划 |
| `/seo competitor-pages [url\|generate]` | 竞品对比页面生成 |
| `/seo local <url>` | 本地SEO分析（商家资料、引用、评论、地图包） |
| `/seo maps [命令] [参数]` | 地图智能（地理网格、商家资料审计、评论、竞品） |
| `/seo hreflang [url]` | Hreflang/国际化SEO审计与生成 |
| `/seo google [命令] [url]` | Google SEO API（GSC、PageSpeed、CrUX、索引、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框架：针对发现、利用、优化、获胜或本地阶段的循证提示 |

## 编排逻辑

当用户调用 `/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报告的选项。

## 行业检测

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

## 质量关卡

读取 `references/quality-gates.md` 获取各类页面的薄内容阈值。
硬性规则：
- 30+个地区页面时发出警告（确保60%以上唯一内容）
- 50+个地区页面时强制停止（要求用户提供理由）
- 永远不推荐使用HowTo结构化数据（2023年9月已弃用）
- FAQ结构化数据用于Google富结果：仅限政府和医疗网站（2023年8月限制）；商业网站已有的FAQPage标记为信息优先级（非紧急），注明AI/LLM引用价值；新增FAQPage -> 不建议为Google收益而添加
- 所有Core Web Vitals引用使用INP，不使用FID

## 参考文件

按需加载（不要在启动时全部加载）：
- `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`：本地排名因素、评论基准、引用层级、商家资料状态
- `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`

## 评分方法

### 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概览 / GEO优化
9. **seo-plan** -- 战略规划与模板
10. **seo-programmatic** -- 程序化SEO分析与规划
11. **seo-competitor-pages** -- 竞品对比页面生成
12. **seo-hreflang** -- Hreflang/国际化SEO审计、文化画像、内容对等
13. **seo-local** -- 本地SEO（商家资料、NAP、引用、评论、本地结构化数据、多地点）
14. **seo-maps** -- 地图智能（地理网格、商家资料审计、评论、竞品辐射范围）
15. **seo-google** -- Google SEO API（GSC、PageSpeed、CrUX、索引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框架集成（发现 -> 利用 -> 优化 -> 获胜，41个AI提示）

## 子代理

用于审计期间的并行分析：
- `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` -- 商家资料信号、NAP一致性、评论、本地结构化数据、行业特定本地因素（条件：检测到本地服务时启动）
- `seo-maps` -- 地理网格排名追踪、商家资料审计、评论情报、竞品辐射范围映射（条件：检测到本地服务且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发现）

## 错误处理

| 场景 | 处理方式 |
|------|---------|
| 无法识别的命令 | 列出快速参考表中的可用命令。建议最接近的匹配命令。 |
| URL不可达 | 报告错误并建议用户核实URL。不要尝试猜测站点内容。 |
| 审计中子技能失败 | 报告成功子技能的部分结果。清楚注明哪个子技能失败及原因。建议单独重新运行失败的子技能。 |
| 业务类型检测不明确 | 展示检测到的前两种类型及支持信号。请用户在继续行业特定建议前确认。 |

如何安装此技能？

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