geo-seo-claude 怎么安装？GEO 与 SEO 审计工具使用教程

搜「geo-seo-claude 怎么安装」的时候，先认准维护者仓库是 zubair-trabzada/geo-seo-claude。这是个第三方 Claude Code Skill，不是 Anthropic 官方出的组件。装之前先跑这几个命令查环境：git --version、python3 --version、claude --version；得确保有 Git、3.8 以上版本的 Python，还有能用的 Claude Code。

macOS 或 Linux 怎么装更稳？

README 里给了一键安装脚本，但我带新手的时候更建议先克隆仓库、看完脚本内容再执行，步骤是：

git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install.sh

安装脚本会把主入口装到 ~/.claude/skills/geo 目录，各个专项 Skill 放在 ~/.claude/skills/geo-*，5 个 Agent 放到 ~/.claude/agents；macOS 和 Linux 系统还会在 geo/.venv 里建虚拟隔离环境。要是用 Windows，得在 Git Bash 里运行 ./install-win.sh，别拿这个 Bash 脚本给 PowerShell 执行。

需要 API Key 或环境变量吗？

核心的公开网页审计功能没有要求必填 API Key，也别自己把密钥写到业务项目根目录的 .env 里。Playwright 只影响截图功能，可以之后再装；要生成 PDF 报告的话，还得额外装 pandoc 和 Chrome。另外安装脚本里还留着旧版 Claude Code 的安装提示，Claude Code 本体的安装要以 Anthropic 最新的官方文档为准。

怎样确认安装成功？

新开一个 Claude Code 会话，先跑 /geo quick https://example.com 试试。要是能返回内联快照，就说明入口已经被识别到了；再跑 /geo audit https://example.com，执行成功的话，当前工作目录里应该会多出一个 GEO-AUDIT-REPORT.md 文件。

完整审计最多会抓 50 页，单页超时时间是 30 秒，而且会遵守 robots.txt 规则；要是审计大型站点，建议先拿小站点或者核心栏目试跑。另外快照只会在会话里显示，不会生成文件，别因为「目录里没出新报告」就误以为安装失败了。

命令没出现怎么办？

• 先检查 ~/.claude/skills/geo/SKILL.md 这个文件存不存在。
• 确认 Python、Git 和 Claude Code 都已经加到 PATH 里，然后重开新会话再试。
• 要是虚拟环境创建失败，可以补装系统的 venv 模块，或者按照脚本提示用 uv 来装。
• 如果是目标站点拒绝访问、需要登录或者被 robots.txt 禁止访问，就换个公开测试页试试，先排除安装本身的问题。

安装成功检查清单

1. 主 Skill、专项目录和对应的 Agent 文件都存在。
2. /geo quick 命令能正常返回结果。
3. 跑完整审计能正常生成报告文件。
4. 报告里的分数只用来做诊断排序，不能当成收录或者引用的保证。