GEO-SEO Claude（AI 搜索可见度审查工具包）

# GEO-SEO Claude：安装说明

这个工具包里是 Mindket 写的安装说明，不包含技能、子智能体、Python 脚本、Schema 模板或安装脚本。这些要从 Zubair Trabzada 的仓库安装：https://github.com/zubair-trabzada/geo-seo-claude

许可证：MIT，Copyright (c) 2026 Zubair Trabzada。全文见 https://github.com/zubair-trabzada/geo-seo-claude/blob/main/LICENSE

这些说明的来源：README（https://github.com/zubair-trabzada/geo-seo-claude/blob/main/README.md），CLAUDE.md，安装脚本 install.sh、install-win.sh 和 uninstall.sh，requirements.txt，geo/SKILL.md，https://github.com/zubair-trabzada/geo-seo-claude/tree/main/skills 下的各个子技能，docs/getting-started.md 和 docs/commands-reference.md。Mindket 读过这些安装脚本，在 brand_scanner.py 里查看了它会访问哪些网站，所有命令都照抄，一条也没有运行过。有一行 Windows 命令填入了安装脚本打印出的 Python 命令，setup/claude-code-windows.md 里写明了这一点。

## 它是什么

一套 Claude Code 工具包，检查网站在 AI 搜索（ChatGPT、Claude、Perplexity、Gemini 和 Google AI Overviews）中的可见度，同时做常规的 SEO 检查。仓库把这叫作 GEO，即生成式引擎优化（generative engine optimization）。你输入 /geo 和一个子命令，Claude 负责检查并写出结果。

它包含一个总调度技能（geo）、skills 文件夹里的 15 个子技能、完整审查时同时运行的 5 个子智能体、五个 Python 脚本、一个管理代理业务数据的小型 Flask 应用、六个 JSON-LD 模板，以及生成 PDF 报告用的文件。

## 工具包里的文件

- setup/claude-code-mac-linux.md：macOS 和 Linux 的安装脚本，可以克隆安装，也可以一条命令安装
- setup/claude-code-windows.md：Windows 的安装脚本，在 Git Bash 里运行
- setup/first-audit.md：检查安装是否成功、各个 /geo 命令、每个命令写出什么文件、PDF 报告和代理业务命令
- setup/update-remove.md：/geo update、卸载脚本，以及卸载后留下的东西

## 先准备好这些

- Claude Code。工具包通过它加载，没有别的使用方式。
- Python 3.10 或更新版本。安装脚本会查找它，找不到就停下。
- Git，用来克隆仓库。没有它，安装脚本会停下，一键安装方式也要用它来获取文件。
- 可选：uv，macOS 和 Linux 的安装脚本会用它加快安装。还有用于截图的 Playwright，也是可选的。
- 一个要检查的公开网站。README 里没有提到任何账号或 API 密钥。

## 装到了哪里

- ~/.claude/skills/geo/：总调度技能、脚本、Schema 模板和报告模板
- ~/.claude/skills/geo-*/：15 个子技能
- ~/.claude/agents/geo-*.md：5 个子智能体
- macOS 和 Linux：位于 ~/.claude/skills/geo/.venv 的 Python 虚拟环境，装有 requirements.txt 里的依赖包
- Windows：安装脚本用 pip --user 把依赖包装进你自己的 Python，不建虚拟环境
- ~/.geo-prospects/：只有用了代理业务命令才会出现，卸载脚本会保留它

## 你的数据

审查的页面从你指定的网站抓取。脚本输出 JSON 给 Claude 读取。brand_scanner.py 还会调用 Wikipedia 和 Wikidata 的 API，品牌技能会让 Claude 用它的网页抓取工具，在 YouTube、Reddit、Wikipedia、LinkedIn 和其他网站上查找这个品牌。报告写在你运行 Claude Code 的文件夹里。你输入的内容和 Claude 读取的页面，会像任何 Claude 工作一样发给 Claude 的服务商。

## 对不上的地方

README 和各个文件有几处说法不一致，依赖某一处之前请先核对：

- README 说有 13 个子技能，geo/SKILL.md 说 14 个。仓库的 skills 文件夹里有 15 个，CLAUDE.md 也说 15 个。
- README 提到 PDF 报告用一个 ReportLab 脚本生成，但仓库里没有这个脚本。geo-report-pdf 的 SKILL.md 用的是 pandoc 和 Chrome，Chrome 写的是 macOS 上的路径（见 setup/first-audit.md）。
- docs/getting-started.md 说安装脚本用 pip install --user。实际上 install.sh 会建虚拟环境，只有 install-win.sh 用 pip --user。

README.md  4 KB
setup/claude-code-mac-linux.md  3 KB
setup/claude-code-windows.md  3 KB
setup/first-audit.md  4 KB
setup/update-remove.md  3 KB