用途
本技能提供跨行业的通用 SEO 分析,适用于 SaaS、本地服务、电商、出版商与代理机构等业务类型。通过 /seo $1 $2 调用,其中 $1 为命令,$2 为 URL 或参数。
主要能力
技能编排 25 个子技能(22 个核心 + 1 个框架集成 + 2 个扩展镜像)与 19 个子代理,可提供整站审计、单页深度分析、技术 SEO、内容质量(E-E-A-T)、结构化数据、站点地图、图片 SEO、GEO(AI 概览 / 生成式引擎优化)、智能体就绪度、战略规划、程序化 SEO、竞品对比页生成、本地 SEO、地图情报、Hreflang/i18n、Google SEO API、外链分析、语义聚类、SXO(搜索体验优化)、漂移监控与电商 SEO 等能力。
部分常用命令:
/seo audit <url>:整站审计,并行委托子代理/seo page <url>:单页深度分析/seo sitemap <url or generate>:分析或生成 XML 站点地图/seo schema <url>:检测、校验并生成 Schema.org 标记/seo images <url or optimize>:图片 SEO/seo technical <url>:技术 SEO 审计(9 个类别)/seo content <url>:E-E-A-T 与内容质量分析/seo content-brief <topic or url>:生成 SEO 内容简报/seo geo <url>:AI 概览 / 生成式引擎优化/seo agentic [audit|fix|lighthouse|refresh] <url>:智能体就绪度/seo plan <business-type>:战略 SEO 规划/seo local <url>:本地 SEO 分析/seo google [command] [url]:Google SEO API(GSC、PageSpeed、CrUX、Indexing、GA4)/seo backlinks <url>:外链档案分析/seo cluster <seed-keyword>:基于 SERP 的语义聚类/seo sxo <url>:搜索体验优化/seo ecommerce <url>:电商 SEO
使用方式
运行时通过 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run <script.py> 调用捆绑的 Python 工具,这是所有技能与代理使用的唯一规范形式。Claude Code 会将 ${CLAUDE_PLUGIN_ROOT} 展开为已安装插件目录;仓库用户运行 ./scripts/claude-seo,手动安装者将规范形式改写为 "$HOME/.claude/skills/seo/scripts/claude-seo"。不要用裸 Python 解释器调用捆绑脚本。
运行时设置:仅在用户明确调用 /seo setup 或明确要求修复依赖时运行,执行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" setup,分别报告核心与 Chromium 状态,不回退到全局或用户级包安装。诊断时执行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" doctor --json。
编排逻辑:执行 /seo audit 时,先检测业务类型,并行生成子代理(seo-technical、seo-content、seo-schema、seo-sitemap、seo-performance、seo-visual、seo-geo、seo-agentic 等);如检测到相关凭据或可用 MCP,可额外生成 seo-google、seo-matomo、seo-local、seo-maps、seo-backlinks、seo-cluster、seo-ecommerce、seo-drift 等子代理;完整审计始终包含 seo-sxo。随后收集结果并生成含 SEO 健康分的统一报告,按 PERCEIVE → ANALYZE → VALIDATE → ACT 方法综合,分入 Critical / High / Medium / Low 优先级桶,并给出排序后的行动计划。
适用场景
适用于需要快速获得跨行业网站 SEO 诊断、内容与结构化数据评估、本地与电商 SEO 分析、AI 搜索与智能体就绪度评估,以及战略规划与内容架构的场景。
限制与说明
- 运行时设置仅在用户明确要求时执行,不得回退到全局或用户级包安装;若命令提示需设置,应建议 /seo setup,不要自行执行 pip install。
- Google 更新历史相关问题应基于捆绑的一手来源账本回答,而非记忆;若账本标记为过期,需在声明推出完成前检查 status.search.google.com。
- 质量门槛(references/quality-gates.md):30+ 位置页触发 WARNING,50+ 位置页触发 HARD STOP;不得推荐 HowTo schema;FAQ schema 相关处理有特定规则。
- 所有 Core Web Vitals 引用使用 INP,不使用 FID。
- 可选扩展(firecrawl、dataforseo、image-gen,以及 ahrefs、bing、matomo、profound、seranking、unlighthouse)位于 extensions/,需单独安装器激活。
- 关于本技能的具体收费、价格与效果数据暂未提供。
参考文件
按需加载(不要启动时全部加载):references/cwv-thresholds.md、references/schema-types.md、references/eeat-framework.md、references/eeat-scoring-guide.md、references/quality-gates.md 等;地图专用引用由 seo-maps 技能加载。
评分方法
SEO 健康分(0-100)为各类别加权汇总:技术 SEO 22%、内容质量 23%、页面 SEO 20%、Schema/结构化数据 10%、性能(CWV)10%、AI 搜索就绪度 10%、图片 5%。优先级:Critical(阻断索引或导致惩罚)、High(显著影响排名,1 周内修复)、Medium(优化机会,1 个月内)、Low(可列入待办)。