seo

SEO：通用 SEO 分析技能

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

脚本： 位于插件根目录的 scripts/ 目录中。

面向所有行业（SaaS、本地服务、电商、出版商、代理机构）的全面 SEO 分析。协调 24 个子技能（21 个核心技能 + 1 个框架集成 + 2 个扩展镜像）和 18 个子 Agent。还可以单独安装一个可选的 Firecrawl 扩展（请参阅下文“可选扩展”）。

快速参考

命令	功能
/seo audit <url>	全面的网站审计，并行委派给子 Agent
/seo page <url>	深入分析单个页面
/seo sitemap <url or generate>	分析或生成 XML 站点地图
/seo schema <url>	检测、验证并生成 Schema.org 标记
/seo images <url or optimize>	图片 SEO：页面审计、SERP 分析、文件优化
/seo technical <url>	技术 SEO 审计（9 个类别）
/seo content <url>	E-E-A-T 和内容质量分析
/seo content-brief <topic or url>	生成详细的 SEO 内容简报，包含目标关键词、大纲和内链
/seo geo <url>	AI 概览 / 生成式引擎优化
/seo plan <business-type>	制定战略 SEO 计划
/seo programmatic [url|plan]	程序化 SEO 分析与规划
/seo competitor-pages [url|generate]	生成竞争对手对比页面
/seo local <url>	本地 SEO 分析（GBP、引文、评价、地图包）
/seo maps [command] [args]	地图情报（地理网格、GBP 审计、评价、竞争对手）
/seo hreflang [url]	Hreflang/i18n SEO 审计与生成
/seo google [command] [url]	Google SEO API（GSC、PageSpeed、CrUX、Indexing、GA4）
/seo backlinks <url>	反向链接档案分析（免费：Moz、Bing、CC；高级：DataForSEO）
/seo cluster <seed-keyword>	基于 SERP 的语义聚类与内容架构
/seo sxo <url>	搜索体验优化：页面类型分析、用户故事、用户画像
/seo drift baseline <url>	捕获 SEO 基线以监控变化
/seo drift compare <url>	将当前状态与存储的基线进行比较
/seo drift history <url>	查看随时间变化的漂移历史
/seo ecommerce <url>	电商 SEO：商品架构标记、市场情报
/seo firecrawl [command] <url>	全站爬取与站点映射（扩展）
/seo dataforseo [command]	通过 DataForSEO 获取实时 SEO 数据（扩展）
/seo image-gen [use-case] <description>	为 SEO 资源生成 AI 图片（扩展）
/seo flow [stage] [url|topic]	FLOW 框架：为 Find、Leverage、Optimize、Win 或 Local 阶段提供以证据为导向的提示词

编排逻辑

当用户调用 /seo audit 时，并行委派给子 Agent：

1. 检测业务类型（SaaS、本地、电商、出版商、代理机构、其他）
2. 启动子 Agent：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 agent
4. 如果检测到本地业务，也启动 seo-local agent
5. 如果检测到本地业务，且 DataForSEO MCP 可用，也启动 seo-maps agent
6. 如果检测到反向链接 API（python scripts/backlinks_auth.py --check），也启动 seo-backlinks agent
7. 如果 Firecrawl MCP 可用，在分析前使用 firecrawl_map 发现网站的所有 URL
8. 如果检测到内容策略信号（博客、支柱页面、主题集群），也启动 seo-cluster agent
9. 如果检测到电商业务，也启动 seo-ecommerce agent
10. 如果此 URL 存在漂移基线（python scripts/drift_history.py <url>），也启动 seo-drift agent
11. 完整审计中始终包含 seo-sxo（搜索体验适用于所有网站）
12. 收集结果并生成统一报告，包含 SEO 健康评分（0-100）
13. 使用 10 项原则框架进行综合分析（见下文“综合分析方法论”）——按 PERCEIVE → ANALYZE → VALIDATE → ACT 的顺序推进，再将发现归入 Critical / High / Medium / Low
14. 创建按优先级排序的行动计划，明确依赖关系顺序，并为每条建议提供可证伪性
15. 提供 PDF 报告选项：“生成专业的 PDF 报告？使用 /seo google report full”

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

综合分析方法论

审计不只是列出发现——而是将发现综合为连贯的策略。seo-skills 使用由四个阶段组成的 10 项原则思维框架：PERCEIVE（观察外部 · 观察内部 · 倾听）、 ANALYZE（思考 · 横向联系 · 系统联系）、VALIDATE（感受 · 接受）、ACT（创造 · 成长）。

完整审计（/seo audit、/seo page）会走完每个阶段，然后输出行动计划。范围较窄的命令（/seo schema、/seo images 等）在输出前至少会经过 THINK + ACCEPT（先遵循健全的第一原则，并明确可证伪性）。Critical / High / Medium / Low 优先级分类是验证的输出结果，不能替代验证。

完整方法论及各项原则与 SEO 的对应关系：references/thinking-framework.md。

每条输出的建议都应包含：

• 所依据的第一原则观察（THINK）
• 与其他建议的依赖关系／解除阻塞关系（CONNECT-system）
• 明确说明“如何判断此建议未奏效？”的检查项（ACCEPT）
• 用户无需重新运行审计即可监控的先行指标（GROW）

行业检测

根据首页信号检测业务类型：

• SaaS：定价页面、/features、/integrations、/docs、“免费试用”、“注册”
• 本地服务：电话号码、地址、服务区域、“服务于［城市］”、Google Maps 嵌入 --> 自动建议使用 /seo local 进行深入分析
• 电商：/products、/collections、/cart、“加入购物车”、产品结构化数据
• 出版商：/blog、/articles、/topics、文章结构化数据、作者页面、发布日期
• 代理机构：/case-studies、/portfolio、/industries、“我们的作品”、客户徽标

质量门槛

按页面类型的薄内容阈值请阅读 references/quality-gates.md。 硬性规则：

• 位置页面达到 30 个或以上时发出 WARNING（确保 60% 以上内容具有独特性）
• 位置页面达到 50 个或以上时 HARD STOP（要求用户说明理由）
• 切勿建议使用 HowTo 结构化数据（已于 2023 年 9 月弃用）
• Google 搜索结果富媒体 FAQ 结构化数据：仅政府和医疗保健网站适用（2023 年 8 月的限制）；商业网站上现有的 FAQPage -> 标记为 Info 优先级（而非 Critical），并注明其对 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：本地排名因素、评论基准、引用来源层级、GBP 状态
• references/local-schema-types.md：LocalBusiness 子类型、特定行业的架构和引用来源

Maps 专用参考资料（由 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 个月内修复）
• 低：锦上添花（列入待办）

子技能

此技能统筹 24 个子技能（21 个核心技能 + 1 个框架集成 + 2 个扩展镜像）。统筹器本身（seo）是 skills/ 中的第 25 个技能，但不会统筹自身，因此不在下方列出。

1. seo-audit -- 并行委派的完整网站审计
2. seo-page -- 深度单页分析
3. seo-technical -- 技术 SEO（9 个类别）
4. seo-content -- E-E-A-T 和内容质量
5. seo-content-brief -- 详细的 SEO 内容简报生成（由 puneetindersingh 贡献）
6. seo-schema -- 架构标记检测与生成
7. seo-images -- 图片优化、SERP 分析、文件优化
8. seo-sitemap -- 站点地图分析与生成
9. seo-geo -- AI Overviews / GEO 优化
10. seo-plan -- 使用模板进行战略规划
11. seo-programmatic -- 程序化 SEO 分析与规划
12. seo-competitor-pages -- 竞品对比页面生成
13. seo-hreflang -- Hreflang/i18n SEO 审计、文化档案、内容一致性
14. seo-local -- 本地 SEO（GBP、NAP、引用、评论、本地架构、多地点）
15. seo-maps -- Maps 情报（地理网格、GBP 审计、评论、竞品覆盖范围）
16. seo-google -- Google SEO API（GSC、PageSpeed、CrUX、Indexing API、GA4）
17. seo-backlinks -- 反向链接档案分析（免费：Moz、Bing、CC；高级：DataForSEO）
18. seo-cluster -- 基于 SERP 的语义聚类（由 Lutfiya Miller 贡献）
19. seo-sxo -- 搜索体验优化（由 Florian Schmitz 贡献）
20. seo-drift -- SEO 漂移监控（由 Dan Colta 贡献）
21. seo-ecommerce -- 电商 SEO 情报（由 Matej Marjanovic 贡献）
22. seo-dataforseo -- 通过 DataForSEO MCP 获取实时 SEO 数据（扩展镜像）
23. seo-image-gen -- 通过 Gemini 为 SEO 资源生成 AI 图片（扩展镜像）
24. seo-flow -- FLOW 框架集成（查找 -> 利用 -> 优化 -> 获胜，41 个 AI 提示词，CC BY 4.0）

可选扩展

以下扩展位于 extensions/，而非 skills/，需要通过单独的安装程序激活（参阅各扩展的 install.sh/install.ps1）：

• seo-firecrawl -- 通过 Firecrawl MCP 进行全站爬取和站点映射。通过 extensions/firecrawl/install.sh（Unix）或 extensions/firecrawl/install.ps1 （Windows）安装。安装后，通过 /seo firecrawl <command> 调用。

子 Agent

用于审计期间的并行分析：

• 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 一致性、评价、本地 Schema、行业特定的本地因素（条件触发：检测到本地服务时启动）
• 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 -- Product Schema、市场情报（条件触发：检测到电子商务时启动）
• seo-flow -- FLOW 框架提示词（条件触发：为内容策略工作流启动）
• seo-dataforseo -- 实时 SERP、关键词、反向链接、本地 SEO 数据（扩展，可选）
• seo-image-gen -- SEO 图片审计和生成计划（扩展，可选）

错误处理

场景	操作
无法识别的命令	从快速参考表中列出可用命令。建议最接近的匹配命令。
URL 无法访问	报告错误并建议用户核实 URL。不要尝试猜测网站内容。
审计期间子技能失败	报告成功子技能的部分结果。明确说明哪个子技能失败及原因。建议单独重新运行失败的子技能。
无法明确判断业务类型	展示检测结果排名前两位的类型及其支持信号。请用户确认后再提供行业特定建议。