想在 Claude Code 里用 SEO 审计功能的话，优先推荐从插件市场安装；要是你需要审查脚本内容、或者要固定某个版本用，再选手动克隆的方式就行。动手之前先确认好：已经装了 Claude Code CLI、Git，还有 3.10 以上版本的 Python；至于 Playwright，只有要渲染 SPA 或者保存截图的时候才需要装。

安装前要检查哪些条件？

• 终端里能正常运行 git --version 和 python3 --version 命令。
• Claude Code 已经登录成功，插件命令也能正常打开。
• 安装目录有写入权限，磁盘可以创建独立的 Python 虚拟环境。

插件市场安装法：两条命令搞定接入

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

装完之后重载一下 Claude Code，再输入 /seo 就能查看帮助了。正常情况下，官方演示里提到的 audit、page、technical、schema、geo 等入口，都会在命令面板里显示出来。

手动安装的文件都存在哪？

macOS 或者 Linux 系统，可以直接执行下面的 HTTPS 克隆与安装命令；Windows 系统完成同样的克隆操作后，运行 powershell -ExecutionPolicy Bypass -File claude-seoinstall.ps1 就行。要是是企业设备，限制了脚本执行权限，一定要先让管理员审查完仓库内容再操作，别通过关闭安全策略绕过限制。

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

主技能文件位于 ~/.claude/skills/seo/ 目录，专项技能在 ~/.claude/skills/seo-*/ 路径下，代理文件会放到 ~/.claude/agents/ 里，命令启动器与虚拟环境则保存在 SEO 技能目录中。安装脚本会创建隔离环境并安装 Python 依赖，避免污染系统解释器。

核心审计功能不需要 Google API Key；只有 Search Console、PageSpeed 这类可选数据源，才需要额外授权。凭据要写入 ~/.config/claude-seo/ 路径，文件权限保持为 0600，千万别放到项目目录、聊天记录或者代码仓库里。

怎么确认安装真的成功了？

1. 运行 /seo doctor 命令，确认依赖和路径检查都能通过。
2. 用 /seo page https://example.com 做一次小范围测试。
3. 确认终端会显示分析过程，并且生成可读取的报告结果，没有路径或模块相关的错误。

命令找不到怎么办？

常见原因是 Claude Code 没重载、Python 版本太低，或者目标目录没有权限。可以先运行只读的 /seo doctor 命令，再核对技能和代理目录，记得保留报错原文，方便定位问题。只有同时满足三个条件才算安装完成：命令能显示帮助、doctor 检查无关键错误、小测试能产出分析结果；要是需要处理前端动态页面，补装 Playwright 后复测就行。