🧭 Decision Guide
Why trending now: README将关注点放在AI搜索,并列出AI-referred traffic同比增长527%、GEO服务市场预计2031年达73亿美元;结合项目已有10,404颗星和当日进入weekly Trending,受关注原因可由这些材料解释,但无法进一步确认具体上榜驱动。
Try it if you
-
你已有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。
Skip it if you
-
你的环境没有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”。
Requirements
- Python 3.8+;Debian/Ubuntu还需要python3-venv。
- Claude Code CLI、Git。
- 可选uv;安装器检测到uv时会使用它加速依赖安装。
- 可选Playwright,用于截图。
- Windows安装需要Git for Windows提供的Git Bash。
First step (verbatim from README)
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
Watch out
-
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命令。
Not stated in the README
- README未说明Claude Code CLI的最低版本、认证方式或是否需要额外模型/API凭据。
- README未说明支持的具体Debian、Ubuntu、macOS版本及Python依赖的精确版本。
- README未给出完整审计的运行时长、并发限制、目标网站规模或失败重试行为。
- README未说明网站内容、客户数据和~/.geo-prospects/数据是否会发送到外部服务。
- README未提供GEO Score与AI引用结果的独立基准、测试集或准确率数据。
- 项目没有Release版本,README也未说明如何锁定某个提交以进行可重复部署。
💡 Deep Analysis
6
No
I maintain a LocalBusiness website on Windows and need to check AI crawlers, robots.txt, brand mentions, and LocalBusiness Schema. My environment currently has only PowerShell/CMD and no Git Bash. Is this project suitable for installation right now?
No, not in the current environment: the project’s Windows prerequisite is Git Bash rather than PowerShell or CMD, so the installation is blocked before the website audit begins.
- Requirements lists Git, and the project insights explicitly state that Windows users need Git Bash and cannot run the installer directly from PowerShell or CMD.
- Your business objectives are otherwise covered:
/geo crawlerschecks AI crawler access,/geo brandsscans brand mentions, and/geo schemaanalyzes structured data. - The Architecture section provides
local-business.json, and the Use Cases section includesLocal Businesses — Get found by AI assistants. - Even after adding Git Bash, brand scanning can be affected by third-party platform access restrictions; the README does not promise complete results for Windows or dynamically rendered sites.
- Windows / Requirements: Windows users need `Git Bash` and cannot use `PowerShell` or `CMD` directly
- Commands: `/geo crawlers`, `/geo brands`, `/geo schema`
- Architecture: `local-business.json`
- Use Cases: `Local Businesses — Get found by AI assistants`
Yes
We already have Git, Python 3.8+, and Claude Code on macOS/Linux, and we care about ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews. Is this project suitable for obtaining an initial AI-visibility baseline?
Yes: the stated environment and target platforms are explicitly covered, and the project provides a 60-second snapshot command that fits an initial visibility baseline.
- The Requirements section lists Python 3.8+, Claude Code CLI, and Git; the installer places dependencies in
~/.claude/skills/geo/.venv/without touching system Python. - The Commands table defines
/geo quickas a60-second GEO visibility snapshot, making it a better starting point than a full audit for a baseline. - The README positions the tool for ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews while maintaining traditional SEO foundations.
- The output is an audit and rule-driven score, not an official ranking or traffic guarantee from those platforms; the project insights also state that GEO Score cannot guarantee actual citations.
- 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
Yes
I maintain an article website and primarily use Claude Code. I want to restructure articles so they are more likely to be cited by ChatGPT, Perplexity, and other AI search systems, while checking author E-E-A-T. Should I use this project?
Yes: the project treats AI citability and E-E-A-T as dedicated checks, and Claude Code is its native execution environment.
- The Use Cases section explicitly includes
Content Creators — Optimize content for AI citations. /geo citabilityanalyzes whether content blocks are self-contained, fact-rich, and directly answer questions; the README identifies 134–167 words as a target range for AI-citable passages./geo contentprovides content-quality and E-E-A-T assessment, whilearticle-author.jsonsupports Article + Person structured data.- However, the project outputs scores and recommendations rather than citation predictions. The README also does not say that it automatically rewrites articles, verifies factual sources, or submits content directly to ChatGPT, Perplexity, or other platforms.
- 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
Yes
I maintain a SaaS website and want to check whether product pages are understandable and citable by ChatGPT and Perplexity while generating SoftwareApplication, Organization, and Article/Person structured data. Can this project cover that workflow?
Yes: the project combines SaaS entity recognition, citability scoring, E-E-A-T checks, and matching JSON-LD templates, covering the main parts of this workflow.
- The Use Cases section explicitly lists
SaaS Companies — Improve entity recognition across AI platforms. /geo citabilityevaluates content blocks for self-contained wording, factual density, and direct answers; the README gives a 134–167-word range for passages likely to be cited by AI./geo contenthandles content quality and E-E-A-T, while/geo schemaanalyzes and generates structured data.- The
schema/directory includessoftware-saas.json,organization.json, andarticle-author.json, covering product, organization, and author entities. However, templates do not prove business facts are accurate and do not guarantee that ChatGPT or Perplexity will cite the pages.
- 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
It depends
I maintain an e-commerce website whose product information depends on JavaScript rendering. I want to check Product Schema, crawlability, and AI shopping-recommendation readiness, and I also need screenshots to validate dynamic pages. Is this project reliable enough by itself?
It depends: the project covers e-commerce Product Schema, technical SEO, and platform optimization, but Playwright is optional and the project explicitly warns that JavaScript-heavy pages may produce incomplete analysis.
- The Use Cases section includes
E-commerce — Optimize product pages for AI shopping recommendations. - The Architecture section provides
product-ecommerce.json;/geo schemacan analyze and generate structured data, while/geo technicalcovers technical SEO foundations. - Requirements lists
Optional: Playwright (for screenshots); the project insights state that results may be incomplete when Playwright is missing or a target site depends on complex JavaScript. - It can therefore serve as an audit entry point, but the README does not prove that it fully validates post-rendered DOM, product variants, prices, or inventory.
- 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
It depends
We are a GEO agency already using Claude Code. We need to run full GEO+SEO audits for client websites and deliver charted PDF reports, proposals, and monthly delta reports. Is this project suitable as a replacement for our current audit-delivery workflow?
It depends: the project is well suited to connecting audits, reports, and a lightweight client pipeline inside Claude Code, but the README does not establish that it can handle large-scale batch processing or serve as a full CRM.
/geo auditperforms a full GEO+SEO audit with parallel subagents; the architecture lists 13 specialized skills and 5 parallel agents./geo report,/geo report-pdf,/geo proposal, and/geo comparecover Markdown reports, charted PDFs, proposals, and monthly delta reports.- Prospect, proposal, and report data are stored under
~/.geo-prospects/, and the uninstaller does not remove that directory. - The README does not state concurrency limits, batch capabilities, per-site runtime, model-call cost, or team access controls, so it should not automatically replace a mature agency platform.
- 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
✨ Highlights
-
13 sub-skills cover citations, crawlers, brands, and reports
-
5 parallel agents synthesize a 0-100 GEO Score
-
Supports ChatGPT, Perplexity, and Google AIO analysis
-
MIT-licensed, with 10,404 stars and 1,580 forks
🔧 Engineering
-
/geo audit runs parallel AI visibility and technical SEO audits
-
/geo citability evaluates AI citation readiness by content block
-
/geo crawlers checks robots.txt access for 14+ AI crawlers
-
/geo report-pdf generates professional PDF reports with charts
⚠️ Risks
-
It requires Claude Code CLI, but the README lists no version
-
The README provides a curl-to-bash one-command installer
-
There are 0 releases, so no Release version is available to pin
-
Uninstall does not remove runtime data under ~/.geo-prospects/
👥 For who?
-
GEO agencies auditing client websites with Claude Code
-
Marketing teams needing visibility in ChatGPT and Google AI Overviews
-
SaaS teams maintaining E-E-A-T content and JSON-LD
-
Developers using Debian/Ubuntu with Python 3.8+