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 Claude Code Skill

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工具, 可引用性评分, 品牌权威性, 应用安全, 搜索引擎优化, 数字营销, 无后门, 特征检测, 生成式引擎优化, 网站优化, 网站分析, 网络安全研究, 逆向工具