zubair-trabzada/geo-seo-claude
GitHub: zubair-trabzada/geo-seo-claude
一个运行在 Claude Code 中的 GEO 审计技能插件,帮助网站针对 ChatGPT、Perplexity、Google AI Overviews 等 AI 搜索引擎进行全面的可引用性分析和优化建议输出。
Stars: 7922 | Forks: 1285
GEO 优先,SEO 辅助。 为 AI 驱动的搜索引擎优化网站
(ChatGPT、Claude、Perplexity、Gemini、Google AI Overviews),同时保持传统的 SEO 基础。
AI 搜索正在吞噬传统搜索。此工具旨在优化流量的去向,而非流量的过去。
## 为什么 GEO 很重要 (2026)
| 指标 | 数值 |
|--------|-------|
| GEO 服务市场规模 | 8.5 亿美元以上(预计到 2031 年将达到 73 亿美元) |
| AI 引荐流量增长 | 同比增长 +527% |
| AI 流量转化率与自然流量对比 | 高 4.4 倍 |
| Gartner:到 2028 年搜索流量下降 | -50% |
| 品牌提及与 AI 反向链接对比 | 相关性高 3 倍 |
| 投资于 GEO 的营销人员 | 仅占 23% |
## 快速入门
### 一键安装 (macOS/Linux)
```
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
```
### 手动安装
```
git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install.sh
```
### Windows (Git Bash)
需要安装包含 Git Bash 的 [Git for Windows](https://git-scm.com/downloads)。
```
# Option 1: 一键安装(在 Git Bash 中运行,而不是 PowerShell/CMD)
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash
# Option 2: 手动安装
git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install-win.sh
```
### 环境要求
- Python 3.8+(在 Debian/Ubuntu 上还需要 `python3-venv`)
- Claude Code CLI
- Git
- 可选:[`uv`](https://docs.astral.sh/uv/) — 如果存在,安装程序将使用它来更快地安装依赖项
- 可选:Playwright(用于截图)
### 隔离安装
Python 依赖项将安装到位于
`~/.claude/skills/geo/.venv/` 的专用虚拟环境中。您的系统 Python **不会**受到影响,卸载该技能时会连同其他文件一起移除该虚拟环境。
技能和代理文件直接引用该虚拟环境,因此无论您的 `PATH` 中的 `python3` 解析为什么,该工具都能正常运行。
## 命令
打开 Claude Code 并使用以下命令:
| 命令 | 功能 |
|---------|-------------|
| `/geo audit
` | 使用并行子代理进行完整的 GEO + SEO 审计 |
| `/geo quick ` | 60 秒 GEO 可见性快照 |
| `/geo citability ` | 评估内容的 AI 引用准备度 |
| `/geo crawlers ` | 检查 AI 爬虫访问权限 (robots.txt) |
| `/geo llmstxt ` | 分析或生成 llms.txt |
| `/geo brands ` | 扫描 AI 引用平台上的品牌提及 |
| `/geo platforms ` | 针对特定平台的优化 |
| `/geo schema ` | 结构化数据分析与生成 |
| `/geo technical ` | 技术 SEO 审计 |
| `/geo content ` | 内容质量与 E-E-A-T 评估 |
| `/geo report ` | 生成可直接交付给客户的 GEO 报告 |
| `/geo report-pdf` | 生成包含图表和可视化内容的专业 PDF 报告 |
## 架构
```
geo-seo-claude/
├── geo/ # Main skill orchestrator
│ └── SKILL.md # Primary skill file with commands & routing
├── skills/ # 13 specialized sub-skills
│ ├── geo-audit/ # Full audit orchestration & scoring
│ ├── geo-citability/ # AI citation readiness scoring
│ ├── geo-crawlers/ # AI crawler access analysis
│ ├── geo-llmstxt/ # llms.txt standard analysis & generation
│ ├── geo-brand-mentions/ # Brand presence on AI-cited platforms
│ ├── geo-platform-optimizer/ # Platform-specific AI search optimization
│ ├── geo-schema/ # Structured data for AI discoverability
│ ├── geo-technical/ # Technical SEO foundations
│ ├── geo-content/ # Content quality & E-E-A-T
│ ├── geo-report/ # Client-ready markdown report generation
│ ├── geo-report-pdf/ # Professional PDF report with charts
│ ├── geo-prospect/ # CRM-lite prospect pipeline management
│ ├── geo-proposal/ # Auto-generate client proposals
│ └── geo-compare/ # Monthly delta tracking & progress reports
├── agents/ # 5 parallel subagents
│ ├── geo-ai-visibility.md # GEO audit, citability, crawlers, brands
│ ├── geo-platform-analysis.md # Platform-specific optimization
│ ├── geo-technical.md # Technical SEO analysis
│ ├── geo-content.md # Content & E-E-A-T analysis
│ └── geo-schema.md # Schema markup analysis
├── scripts/ # Python utilities
│ ├── fetch_page.py # Page fetching & parsing
│ ├── citability_scorer.py # AI citability scoring engine
│ ├── brand_scanner.py # Brand mention detection
│ ├── llmstxt_generator.py # llms.txt validation & generation
│ └── generate_pdf_report.py # PDF report generator (ReportLab)
├── schema/ # JSON-LD templates
│ ├── organization.json # Organization schema (with sameAs)
│ ├── local-business.json # LocalBusiness schema
│ ├── article-author.json # Article + Person schema (E-E-A-T)
│ ├── software-saas.json # SoftwareApplication schema
│ ├── product-ecommerce.json # Product schema with offers
│ └── website-searchaction.json # WebSite + SearchAction schema
├── install.sh # One-command installer
├── uninstall.sh # Uninstaller
├── requirements.txt # Python dependencies
└── README.md # This file
```
## 数据存储
CRM 和报告技能(`/geo prospect`、`/geo proposal`、`/geo compare`)将运行时数据存储在 Claude Code 目录之外:
```
~/.geo-prospects/
├── prospects.json # Client/prospect pipeline data
├── proposals/ # Generated proposal documents
│ └── -proposal-.md
└── reports/ # Monthly delta reports
└── -monthly-.md
```
此目录**不会**被卸载程序移除 —— 如果您不再需要您的潜在客户数据,请手动删除它。
## 工作原理
### 完整审计流程
当您运行 `/geo audit https://example.com` 时:
1. **发现** — 获取主页,检测业务类型,抓取站点地图
2. **并行分析** — 同时启动 5 个子代理:
- AI 可见性(可引用性、爬虫、llms.txt、品牌提及)
- 平台分析(ChatGPT、Perplexity、Google AIO 准备情况)
- 技术 SEO(Core Web Vitals、SSR、安全性、移动端)
- 内容质量(E-E-A-T、可读性、新鲜度)
- Schema 标记(检测、验证、生成)
3. **综合** — 汇总评分,生成综合 GEO 评分 (0-100)
4. **报告** — 输出包含快速见效方案的优先行动计划
### 评分方法
| 类别 | 权重 |
|----------|--------|
| AI 可引用性与可见性 | 25% |
| 品牌权威信号 | 20% |
| 内容质量与 E-E-A-T | 20% |
| 技术基础 | 15% |
| 结构化数据 | 10% |
| 平台优化 | 10% |
## 核心特性
### 可引用性评分
分析内容块对 AI 引用的准备度。最适合 AI 引用的段落长度为 134-167 个单词,具有独立性、内容丰富且能直接回答问题。
### AI 爬虫分析
检查 robots.txt 中是否存在 14 种以上的 AI 爬虫(GPTBot、ClaudeBot、PerplexityBot 等),并提供具体的允许/屏蔽建议。
### 品牌提及扫描
品牌提及与 AI 可见性的相关性比反向链接高 3 倍。可扫描 YouTube、Reddit、Wikipedia、LinkedIn 以及其他 7 个以上的平台。
### 特定平台优化
只有 11% 的域名能同时被 ChatGPT 和 Google AI Overviews 在同一查询中引用。提供针对每个平台的定制建议。
### llms.txt 生成
生成新兴的 llms.txt 标准文件,帮助 AI 爬虫了解您的网站结构。
### 可交付给客户的报告
以 markdown 或 PDF 格式生成专业的 GEO 报告。PDF 报告包括评分仪表盘、条形图、平台就绪情况可视化、颜色编码表格和优先行动计划 —— 可直接交付给客户。
## 使用场景
- **GEO 代理商** — 运行客户审计并生成可交付成果
- **营销团队** — 监控并提升 AI 搜索可见性
- **内容创作者** — 优化内容以获得 AI 引用
- **本地企业** — 让 AI 助手发现您的业务
- **SaaS 公司** — 改善各 AI 平台上的实体识别
- **电子商务** — 针对 AI 购物推荐优化产品页面
## 卸载
```
./uninstall.sh
```
或者手动卸载:
```
rm -rf ~/.claude/skills/geo ~/.claude/skills/geo-* ~/.claude/agents/geo-*.md
```
## 想将其转化为一项业务吗?
该工具是免费的。学习如何通过它盈利正是社区存在的意义。
**[加入 AI 研讨社区 →](https://skool.com/aiworkshop)**
在这里您将获得:
- **视频操作指南** — 分步设置、运行审计、解读结果
- **客户获取手册** — 如何寻找潜在客户、推介 GEO 服务并达成交易
- **在线答疑时间** — 带上您的审计结果,获取直接帮助
- **GEO 代理商定价与模板** — 提案文档、陌生拓展话术、入职工作流
GEO 代理商每月收费 2000 至 12000 美元。此工具负责执行审计。社区则教您如何将其销售出去。
## 许可证
MIT License
## 贡献
欢迎贡献代码!
为 AI 搜索时代而构建。标签:AI搜索引擎, AI爬虫分析, ChatGPT, Claude Code, Gemini, GEO, Google AI Overviews, PDF报告生成, Perplexity, Playwright, Promptflow, Python, Schema Markup, SEO优化, SEO工具, 可引用性评分, 品牌权威性, 应用安全, 搜索引擎优化, 数字营销, 无后门, 特征检测, 生成式引擎优化, 网站优化, 网站分析, 网络安全研究, 逆向工具