geo-seo-claude: GEO and SEO website audits with Claude Code
A Claude Code skill for website GEO audits that also covers SEO, AI citations, crawlers, and reports.
GitHub zubair-trabzada/geo-seo-claude Updated 2026-09-08 Branch main Stars 10.4K Forks 1.6K
Python GEO and SEO Claude Code CLI macOS/Linux/Windows Git Bash

🧭 Decision Guide

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?
For: A developer moving from PowerShell/CMD to Windows Git Bash who needs to audit a local-business website

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 crawlers checks AI crawler access, /geo brands scans brand mentions, and /geo schema analyzes structured data.
  • The Architecture section provides local-business.json, and the Use Cases section includes Local 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`
Not stated in the README:The provided README excerpt does not include the complete Windows Git Bash installation command or a compatibility matrix.;It does not state whether local-business brand scanning requires extra APIs, credentials, or regional configuration.
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?
For: A marketing team on macOS/Linux using Claude Code and Python 3.8+ to improve an enterprise website's AI-search visibility

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 quick as a 60-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
Not stated in the README:The README does not state which models `/geo quick` calls, how many pages it fetches, or how the 60-second duration is defined.;It does not state whether results are reproducible for AI answers tied to a particular region, user, or query.
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?
For: A content creator using Claude Code to maintain an article site, focused on AI-citable passages and author E-E-A-T information

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 citability analyzes 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 content provides content-quality and E-E-A-T assessment, while article-author.json supports 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
Not stated in the README:The README does not state whether citability scoring supports non-English or multilingual content.;It does not state whether author identity, sources, and factual accuracy are automatically checked against external databases.
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?
For: A content engineer responsible for SaaS product pages and organization entities, needing SoftwareApplication Schema, E-E-A-T, and AI-citation readiness

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 citability evaluates 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 content handles content quality and E-E-A-T, while /geo schema analyzes and generates structured data.
  • The schema/ directory includes software-saas.json, organization.json, and article-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
Not stated in the README:The README does not state whether the Schema generator validates field values, URLs, prices, or product facts.;It does not state whether `/geo citability` supports custom industry vocabulary, brand terminology, or content languages.
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?
For: An e-commerce developer working with a JavaScript-rendered site who wants to analyze Product Schema and AI shopping visibility using Playwright

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 schema can analyze and generate structured data, while /geo technical covers 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
Not stated in the README:The README does not state the Playwright version, browser installation method, or coverage for dynamically rendered pages.;It does not state whether Product Schema checks variants, inventory, price validity periods, or multilingual product data.
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?
For: A GEO/SEO agency that must deliver audits, Markdown/PDF reports, and proposals for multiple clients

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 audit performs 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 compare cover 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
Not stated in the README:The README does not state how many websites one run can process or whether unattended batch auditing is supported.;It does not state Claude model-call costs, report-generation failure rates, or multi-user access controls.

✨ 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+