geo-seo-claude：用Claude Code做GEO与SEO网站审计
给Claude Code用的网站GEO审计技能，兼顾SEO，能把AI引用、爬虫和报告一次查完。
GitHub zubair-trabzada/geo-seo-claude 更新 2026-09-08 分支 main 星标 10.4K 分叉 1.6K
Python GEO与SEO Claude Code CLI macOS/Linux/Windows Git Bash

🧭 决策指南

为什么现在热： README将关注点放在AI搜索，并列出AI-referred traffic同比增长527%、GEO服务市场预计2031年达73亿美元；结合项目已有10,404颗星和当日进入weekly Trending，受关注原因可由这些材料解释，但无法进一步确认具体上榜驱动。

适合，如果你

  • 你已有Claude Code CLI，想检查网站在ChatGPT、Perplexity和Google AIO中的可见性。
    README“Requirements”和“Platform-Specific Optimization”列出Claude Code CLI及这三个平台。
  • 你需要一次运行覆盖AI引用、robots.txt、llms.txt、E-E-A-T和Schema Markup的审计。
    README“Full Audit Flow”说明/geo audit会启动5个并行子代理，覆盖这些分析项。
  • 你是GEO机构，需要Markdown或PDF形式的客户交付报告。
    README“Commands”列出/geo report和/geo report-pdf，并在架构中列出geo-report与geo-report-pdf。

不适合，如果你

  • 你的环境没有Claude Code CLI，或不能安装Python 3.8+依赖。
    README“Requirements”明确要求Python 3.8+、Git和Claude Code CLI。
  • 你只能在PowerShell或Command Prompt中安装Windows版本。
    README“Windows (Git Bash)”明确写明不要使用PowerShell或Command Prompt。
  • 你要求有正式Release或稳定版本号来锁定部署版本。
    项目元数据显示版本发布为0，最新版本为“No releases”。

前置条件

  • Python 3.8+；Debian/Ubuntu还需要python3-venv。
  • Claude Code CLI、Git。
  • 可选uv；安装器检测到uv时会使用它加速依赖安装。
  • 可选Playwright，用于截图。
  • Windows安装需要Git for Windows提供的Git Bash。

第一步命令（README 原文）

curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash

要注意

  • Windows命令必须在Git Bash运行，README明确禁止PowerShell和Command Prompt。
    README“Windows (Git Bash)”的安装说明。
  • 卸载技能后，~/.geo-prospects/中的prospects、proposals和reports仍会保留。
    README“Data Storage”说明该目录不会被卸载器删除。
  • Playwright属于可选依赖，但README只说明其用于截图，未给出安装命令。
    README“Requirements”将Playwright列为Optional，并注明for screenshots。
  • 一键安装会从raw.githubusercontent.com获取install.sh并交给bash执行。
    README“Quick Start”中的One-Command Install命令。

材料未说明

  • README未说明Claude Code CLI的最低版本、认证方式或是否需要额外模型/API凭据。
  • README未说明支持的具体Debian、Ubuntu、macOS版本及Python依赖的精确版本。
  • README未给出完整审计的运行时长、并发限制、目标网站规模或失败重试行为。
  • README未说明网站内容、客户数据和~/.geo-prospects/数据是否会发送到外部服务。
  • README未提供GEO Score与AI引用结果的独立基准、测试集或准确率数据。
  • 项目没有Release版本，README也未说明如何锁定某个提交以进行可重复部署。

💡 深度解析

6
不适合 我在 Windows 上维护 LocalBusiness 网站，目标是检查 AI 爬虫、robots.txt、品牌提及和 LocalBusiness Schema；但我的环境只有 PowerShell/CMD，没有 Git Bash，这个项目现在适合安装吗？
适合读者： 从 PowerShell/CMD 转向 Windows Git Bash、需要审计本地商家网站的开发者

不适合当前环境：项目的 Windows 使用前提是 Git Bash，而不是 PowerShell 或 CMD；缺少 Git Bash 会先阻塞安装，而不是网站审计本身的问题。

  • Requirements 说明项目需要 Git；项目洞察进一步明确 Windows 用户需要 Git Bash，不能直接使用 PowerShell 或 CMD。
  • 你的业务目标本身有对应功能：/geo crawlers 检查 AI crawler access，/geo brands 扫描品牌提及，/geo schema 分析结构化数据。
  • Architecture 提供 local-business.json，Use Cases 也明确包含 Local Businesses — Get found by AI assistants。
  • 但即使补齐 Git Bash，品牌扫描仍可能受第三方平台访问限制影响；README 没有承诺 Windows 与动态网站的结果完整性。
  • Windows / Requirements：Windows 用户需要 `Git Bash`，不能直接使用 `PowerShell` 或 `CMD`
  • Commands：`/geo crawlers`、`/geo brands`、`/geo schema`
  • Architecture：`local-business.json`
  • Use Cases：`Local Businesses — Get found by AI assistants`
材料未说明：README 摘要未提供 Windows Git Bash 的完整安装命令或兼容性矩阵。；README 未说明本地商家品牌扫描是否需要额外 API、登录凭据或地区配置。
适合 我们在 macOS/Linux 上已经安装了 Git、Python 3.8+ 和 Claude Code，重点关注 ChatGPT、Claude、Perplexity、Gemini 与 Google AI Overviews；如果我们想先获得一次 AI 可见性基线，这个项目是否适合？
适合读者： 在 macOS/Linux 上使用 Claude Code、Python 3.8+，负责提升企业网站 AI 搜索可见性的营销团队

适合：这些运行环境和目标平台正是 README 明确覆盖的范围，而且项目提供 60 秒快照命令，适合先建立 AI 可见性基线。

  • Requirements 明确列出 Python 3.8+、Claude Code CLI 和 Git；安装器把依赖放入 ~/.claude/skills/geo/.venv/，不修改系统 Python。
  • Commands 中的 /geo quick 用于 60-second GEO visibility snapshot，比完整审计更适合作为初始入口。
  • README 的定位是优化 ChatGPT、Claude、Perplexity、Gemini 和 Google AI Overviews，同时保留传统 SEO 基础。
  • 结果是审计和规则驱动评分，不是这些平台的官方排名或流量保证；项目洞察也明确说明 GEO Score 不能保证实际引用。
  • Requirements：`Python 3.8+`、`Claude Code CLI`、`Git`
  • Isolated install：`Your system Python is not touched`
  • Commands：`/geo quick | 60-second GEO visibility snapshot`
  • README opening：`ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews`
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
材料未说明：README 未说明 `/geo quick` 实际调用哪些模型、抓取多少页面或如何定义 60 秒。；README 未说明结果是否能稳定复现特定地区、用户和查询下的 AI 答案。
适合 我维护一个文章网站，主要使用 Claude Code，想把文章改成更容易被 ChatGPT、Perplexity 和其他 AI 搜索引用的结构，并检查作者 E-E-A-T；我应该使用这个项目吗？
适合读者： 内容创作者，使用 Claude Code 维护文章网站，重点优化 AI 引用段落和作者 E-E-A-T 信息

适合：项目把 AI 可引用性和 E-E-A-T 作为独立检查对象，且 Claude Code 是它的直接运行入口。

  • Use Cases 明确包含 Content Creators — Optimize content for AI citations。
  • /geo citability 会分析内容块是否自包含、事实密集、直接回答问题；README 将 134–167 词列为适合 AI 引用的段落区间。
  • /geo content 提供内容质量与 E-E-A-T 评估，article-author.json 用于 Article + Person 结构化数据。
  • 但项目输出的是评分和建议，不是引用结果预测；README 也没有说明它能自动改写文章、验证事实来源，或直接提交内容到 ChatGPT、Perplexity 等平台。
  • Use Cases：`Content Creators — Optimize content for AI citations`
  • Key Features / Citability Scoring：`self-contained, fact-rich, and directly answer questions`
  • Commands：`/geo citability`、`/geo content`
  • Architecture：`article-author.json | Article + Person schema (E-E-A-T)`
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
材料未说明：README 未说明可引用性评分是否支持非英文文章或多语言混排内容。；README 未说明作者身份、引用来源和事实准确性是否会通过外部数据库自动核验。
适合 我维护一个 SaaS 网站，想检查产品页是否便于 ChatGPT 和 Perplexity 理解与引用，同时需要生成 SoftwareApplication、Organization 和 Article/Person 结构化数据；这个项目能覆盖我的工作吗？
适合读者： 负责 SaaS 产品页和组织实体信息的内容工程师，需要同时处理 SoftwareApplication Schema、E-E-A-T 与 AI 引用准备度

适合：项目同时提供 SaaS 实体识别、内容可引用性评分、E-E-A-T 检查和对应 JSON-LD 模板，覆盖你的主要任务。

  • Use Cases 明确列出 SaaS Companies — Improve entity recognition across AI platforms。
  • /geo citability 会按内容块评估是否自包含、事实密集并直接回答问题；README 给出适合 AI 引用的 134–167 词区间。
  • /geo content 负责内容质量与 E-E-A-T，/geo schema 负责结构化数据分析与生成。
  • schema/ 包含 software-saas.json、organization.json 和 article-author.json，因此能覆盖产品、组织与作者实体。不过这些模板不会自动证明业务事实准确，也不会保证 ChatGPT 或 Perplexity 实际引用页面。
  • Use Cases：`SaaS Companies — Improve entity recognition across AI platforms`
  • Key Features / Citability Scoring：`134-167 words, self-contained, fact-rich`
  • Commands：`/geo citability`、`/geo content`、`/geo schema`
  • Architecture：`software-saas.json`、`organization.json`、`article-author.json`
git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install.sh
材料未说明：README 未说明 Schema 生成器是否校验字段值、URL、价格和产品事实。；README 未说明 `/geo citability` 是否支持自定义行业词汇、品牌术语或内容语言。
视情况 我负责一个依赖 JavaScript 渲染商品信息的电商网站，想检查 Product Schema、页面可抓取性以及 AI 购物推荐适配；我还需要截图验证动态页面，这个项目是否足够可靠？
适合读者： 使用 Playwright 依赖 JavaScript 渲染的电商网站开发者，希望分析 Product Schema 和 AI 购物推荐可见性

视情况：项目覆盖电商 Product Schema、技术 SEO 和 AI 平台优化，但 README 把 Playwright 标为可选依赖，并明确动态 JavaScript 页面可能造成分析不完整。

  • Use Cases 包含 E-commerce — Optimize product pages for AI shopping recommendations。
  • Architecture 提供 product-ecommerce.json，/geo schema 可分析和生成结构化数据，/geo technical 可检查技术 SEO 基础。
  • Requirements 将 Playwright 标为 Optional: Playwright (for screenshots)；项目洞察说明未安装或目标站点依赖复杂 JavaScript 时，结果可能不完整。
  • 因此它可以作为审计入口，但不能仅凭 README 证明能完整执行渲染后 DOM、商品变体、价格或库存验证。
  • Use Cases：`E-commerce — Optimize product pages for AI shopping recommendations`
  • Architecture：`product-ecommerce.json`
  • Commands：`/geo schema`、`/geo technical`
  • Requirements：`Optional: Playwright (for screenshots)`
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
材料未说明：README 未说明 Playwright 的具体版本、浏览器安装方式和动态渲染页面的覆盖率。；README 未说明 Product Schema 是否检查变体、库存、价格有效期和多语言商品数据。
视情况 我们是一家 GEO 代理机构，已经在用 Claude Code，需要为客户网站批量执行完整 GEO+SEO 审计，并交付带图表的 PDF 报告、提案和月度变化报告；这个项目适合替代我们现有的审计交付流程吗？
适合读者： 需要为多个客户交付 GEO 审计、Markdown/PDF 报告和提案的 GEO/SEO 代理机构

视情况：它很适合把 Claude Code 中的审计、报告和轻量客户管线串起来，但 README 没有证明它能承担大规模批处理或完整 CRM 的职责。

  • /geo audit 会执行完整 GEO+SEO 审计，并使用并行子代理；项目架构列出 13 个专用技能和 5 个并行代理。
  • /geo report、/geo report-pdf、/geo proposal 和 /geo compare 覆盖 Markdown、PDF、提案及月度对比交付。
  • Prospect、proposal 和 report 数据写入 ~/.geo-prospects/，卸载程序不会删除该目录。
  • 但 README 未提供并发上限、批量运行能力、单站耗时、模型调用成本或团队协作权限，因此不能据此替代成熟的代理机构平台。
  • Commands：`/geo audit`、`/geo report`、`/geo report-pdf`
  • Architecture：`13 specialized sub-skills`、`5 parallel subagents`
  • Data Storage：`~/.geo-prospects/`；`This directory is not removed by the uninstaller`
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
材料未说明：README 未说明一次运行可处理多少个网站或是否支持无人值守批量审计。；README 未说明 Claude 模型调用成本、报告生成失败率和多人协作权限。

✨ 核心亮点

  • 13个子技能覆盖引用、爬虫、品牌与报告
  • 5个并行代理汇总0-100分GEO Score
  • 支持ChatGPT、Perplexity与Google AIO分析
  • MIT许可，已有10,404颗星与1,580个Fork

🔧 工程化

  • /geo audit并行执行AI可见性与技术SEO审计
  • /geo citability按内容块评估AI引用准备度
  • /geo crawlers检查14+个AI爬虫的robots.txt访问
  • /geo report-pdf生成含图表的专业PDF报告

⚠️ 风险

  • 依赖Claude Code CLI，README未列出其版本
  • README提供curl管道bash的一键安装方式
  • 0个版本发布，暂无Release可供版本锁定
  • 卸载不会删除~/.geo-prospects/运行数据

👥 适合谁？

  • 用Claude Code做客户网站审计的GEO机构
  • 需要ChatGPT和Google AI Overviews可见性的营销团队
  • 维护E-E-A-T内容与JSON-LD的SaaS团队
  • 使用Debian/Ubuntu与Python 3.8+的开发者