Mindket

GEO-SEO Claude

Newversion 2 · updated
Star11.6k

Overview

Zubair Trabzada’s free toolkit for Claude Code. Type /geo audit with a site address and Claude checks how visible that site is to AI search, next to the usual SEO basics. It scores the site, writes a report and lists the fixes.

GEO-SEO Claude is an open-source project on GitHub in the Marketing & SEO category, listed by Mindket. It is free. This is version 2, last updated on . Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip.

At a glance

Runs in
  • Claude Code on macOS or Linux: install.sh
  • Claude Code on Windows: install-win.sh, run from Git Bash and not from PowerShell
  • Any public website. The skills tell Claude to check robots.txt first
  • Not for Cursor, Codex or a chat window. The README documents none of them
Start with
git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install.sh

Platform

Claude CodeCoding agent
macOSOperating system
LinuxOperating system
WindowsOperating system
ClaudeAI chat
CursorCode editor

And 1 more in Where to use it

About

What it is

GEO-SEO Claude is Zubair Trabzada’s toolkit for Claude Code. You type /geo audit and a site address. Claude then checks whether ChatGPT, Perplexity, Gemini and Google’s AI answers can find, read and quote that site. A full audit sends five subagents out side by side. It ends in one score from 0 to 100 and a ranked list of fixes. The ordinary SEO basics are checked too.

  1. You run the installer once
  2. You type /geo audit with your site address
  3. Claude fetches pages and runs five subagents
  4. Claude scores the site and writes GEO-AUDIT-REPORT.md
  5. You apply the fixes and upload any files yourself

Who it suits

Site owners and marketers who want an AI search checkup, and freelancers or small agencies who want a report to hand a client. Extra commands track prospects, write proposals and compare month with month. Its audits read public pages, write files into the folder where you run Claude Code and publish nothing. The agency commands keep their data in ~/.geo-prospects.

Where to use it

Claude Code is the only home, on macOS, Linux and Windows. Windows needs Git Bash.

  • Claude Code on macOS or Linux: install.sh
  • Claude Code on Windows: install-win.sh, run from Git Bash and not from PowerShell
  • Any public website. The skills tell Claude to check robots.txt first
  • Not for Cursor, Codex or a chat window. The README documents none of them

How to set it up

Get it saves a zip of Mindket’s setup notes in your downloads folder, with a page for each system. The toolkit itself installs from the maker’s repository.

What you need first
NeedDetail
Claude CodeThe toolkit loads through it. The installer asks before going on without it
Python 3.10 or newerThe installer stops without it. On Debian or Ubuntu, add python3-venv
GitTo clone the repository. The installer stops without it
PlaywrightOptional, for screenshots. The installer asks
pandoc and ChromeOnly for the PDF report. The skill names Chrome at a macOS path
An accountNone. No API key is named in the README
  1. Check your tools first. You need Python 3.10 or newer, Git and Claude Code. On Windows, also Git Bash.
  2. Clone it and run the installer. It copies the skills into ~/.claude and installs the Python packages.
  3. Restart Claude Code and test it. The maker’s docs say Claude Code reads skills at startup, so a session that was already open will not see them.
git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install.sh

On Windows, run these lines in Git Bash and use the other installer:

git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install-win.sh

For macOS and Linux, the README also gives a one-command route. It runs the script from GitHub without you reading it first, so the clone route above is the safer first choice.

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

The installer asks questions only in a terminal. There it asks whether to go on without Claude Code and whether to add Playwright. Run through curl, it goes on without asking and skips Playwright.

How to use it

Open Claude Code in any folder and type /geo with a subcommand and a site address. Claude fetches the pages, runs the checks and, for most commands, writes a file into that folder. You read it and decide what to change.

The commands to start with
CommandWhat Claude doesWhat you get
/geo quick <url>A 60-second visibility snapshotAn answer in the chat, no file
/geo audit <url>The full audit with five subagentsGEO-AUDIT-REPORT.md
/geo crawlers <url>Checks robots.txt and page tags for AI crawlersGEO-CRAWLER-ACCESS.md
/geo citability <url>Scores how quotable a page isGEO-CITABILITY-SCORE.md
/geo llmstxt <url>Checks or writes an llms.txt filellms.txt, which you upload to your site root
/geo schema <url>Finds and writes structured dataGEO-SCHEMA-REPORT.md and JSON-LD
/geo brands <url>Looks for the brand on sites AI citesGEO-BRAND-MENTIONS.md
/geo report <url>Turns the audit into a client reportGEO-CLIENT-REPORT.md

The skills cap an audit at 50 pages, wait one second between requests and give each page 30 seconds. Claude does the fetching and scoring. You apply the fixes and upload any file it writes.

Example

You run a small software site and want a first checkup before you change anything.

/geo audit https://yoursite.com

After several minutes Claude writes GEO-AUDIT-REPORT.md into your folder, with a GEO score from 0 to 100, the issues by severity, quick wins and a 30-day action plan.

The score is a weighted average of six areas. AI citability counts for 25% and brand authority for 20%.

For newcomers and experts

If you are new. GEO means optimizing for the answers AI tools write, not for a list of links. Start with /geo quick, then /geo crawlers. The crawler check reads your robots.txt, then the robots tags and headers of a few pages. The score is the toolkit’s own weighted estimate. It is not a count of how often ChatGPT names you.

For experts. The six areas and their weights, from geo/SKILL.md:

How the GEO score is weighted
AreaWeightMeasured by
AI citability and visibility25%Passage scoring, answer block quality, AI crawler access
Brand authority signals20%Mentions on Reddit, YouTube, Wikipedia and LinkedIn
Content quality and E-E-A-T20%Expertise signals, original data, author credentials
Technical foundations15%Server rendering, Core Web Vitals, crawlability, mobile, security
Structured data10%Schema completeness, JSON-LD validation
Platform optimization10%Readiness for Google AI Overviews, ChatGPT and Perplexity

The scripts print JSON, and you can run them yourself from a clone once its packages are in. These lines are CLAUDE.md’s, the first one setting up the packages:

python3 -m venv .venv && . .venv/bin/activate && pip install -r requirements.txt
python3 scripts/fetch_page.py <url>
python3 scripts/citability_scorer.py <url>
python3 scripts/brand_scanner.py "<brand name>"
python3 scripts/llmstxt_generator.py <url>

Good to know

The toolkit is free and MIT licensed. Its files do not always agree with each other.

  • Windows: install-win.sh installs the packages into your own Python with pip --user and makes no virtual environment. It also leaves the python3 commands in the skills as written, so a step that names python3 may fail where Git Bash has no python3
  • The PDF report needs pandoc and Chrome at a macOS path. The README’s ReportLab script is not in the repository
  • Counts differ: the README says 13 sub-skills, geo/SKILL.md says 14, and the repository holds 15
  • Market figures in the README are the maker’s own editorial text. The toolkit does not measure them
  • Updates: /geo update copies the latest files over the installed ones, so edits you made to an installed skill are lost. It does not redo the installer’s Python setup, so running the installer again from a fresh clone is the surer update
  • Removing: ./uninstall.sh or the README’s rm line. The folder ~/.geo-prospects, with your prospect data, stays until you delete it
  • Data: the brand check calls the Wikipedia and Wikidata APIs and has Claude look the brand up on other sites. Page text and your prompts go to Claude’s provider as in any Claude work
  • Maker: Zubair Trabzada. The setup notes in the zip are Mindket’s

README and files

README
# GEO-SEO Claude: setup notes

This kit holds setup notes written by Mindket. It does not contain the skills, the subagents, the Python scripts, the schema templates or the installers. Those install from Zubair Trabzada’s repository: https://github.com/zubair-trabzada/geo-seo-claude

License: MIT, Copyright (c) 2026 Zubair Trabzada. Full text: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/LICENSE

The pages these notes came from: the README (https://github.com/zubair-trabzada/geo-seo-claude/blob/main/README.md), CLAUDE.md, the installers install.sh, install-win.sh and uninstall.sh, requirements.txt, geo/SKILL.md, the sub-skills under https://github.com/zubair-trabzada/geo-seo-claude/tree/main/skills, docs/getting-started.md and docs/commands-reference.md. Mindket read the installers, looked in brand_scanner.py for the sites it calls, copied every command and ran none of them. One Windows line fills in the Python command the installer prints, and setup/claude-code-windows.md says so.

## What it is

A toolkit for Claude Code that checks a website for visibility in AI search (ChatGPT, Claude, Perplexity, Gemini and Google AI Overviews), with the ordinary SEO checks beside it. The repository calls this GEO, short for generative engine optimization. You type /geo and a subcommand. Claude does the checking and writes the result.

It ships as one orchestrator skill (geo), 15 sub-skills in the skills folder, 5 subagents that run side by side during a full audit, five Python scripts, a small Flask app for the agency data, six JSON-LD templates and the files for a PDF report.

## Files in this kit

- setup/claude-code-mac-linux.md: the installer for macOS and Linux, by clone or by one command
- setup/claude-code-windows.md: the Windows installer, run from Git Bash
- setup/first-audit.md: checking the install, the /geo commands, what each writes, the PDF report and the agency commands
- setup/update-remove.md: /geo update, the uninstaller and the leftovers it keeps

## What you need first

- Claude Code. The toolkit loads through it and has no other home.
- Python 3.10 or newer. The installers look for it and stop without it.
- Git, to clone the repository. The installers stop without it, and the one-command route uses it to fetch the files.
- Optional: uv, which the macOS and Linux installer uses for a faster install, and Playwright for screenshots.
- A public website to check. No account or API key is named anywhere in the README.

## What installs where

- ~/.claude/skills/geo/: the orchestrator skill, the scripts, the schema templates and the report templates
- ~/.claude/skills/geo-*/: the 15 sub-skills
- ~/.claude/agents/geo-*.md: the 5 subagents
- macOS and Linux: a Python virtual environment at ~/.claude/skills/geo/.venv, with the packages from requirements.txt
- Windows: the installer puts the packages in your own Python with pip --user and makes no virtual environment
- ~/.geo-prospects/: appears only if you use the agency commands, and the uninstaller keeps it

## Your data

The audit pages are fetched from the site you name. The scripts print JSON for Claude to read. brand_scanner.py also calls the Wikipedia and Wikidata APIs, and the brand skill has Claude look a brand up on YouTube, Reddit, Wikipedia, LinkedIn and other sites through its web fetch tool. Reports are written to the folder where you ran Claude Code. What you type and the pages Claude reads go to Claude’s provider as in any other Claude work.

## Things that do not match

The README and the files disagree in a few places, so check before you rely on one:

- The README counts 13 sub-skills and geo/SKILL.md says 14. The repository’s skills folder holds 15, and CLAUDE.md says 15.
- The README names a ReportLab script for the PDF report. The repository has no such script. geo-report-pdf’s SKILL.md uses pandoc and Chrome, with Chrome at a macOS path (setup/first-audit.md).
- docs/getting-started.md says the installer uses pip install --user. install.sh makes a virtual environment, and only install-win.sh uses pip --user.
Files
README.md  4 KB
setup/claude-code-mac-linux.md  3 KB
setup/claude-code-windows.md  3 KB
setup/first-audit.md  4 KB
setup/update-remove.md  3 KB

5 files, 16 KB, downloaded as a zip.

What’s new

  • Version 2 · 2026-11-09

    Updated by Mindket to the current version of this kit.

  • Version 1 · 2026-11-07

Reviews

No ratings yet

Write a review

No reviews yet.

What people say

Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search and on Trendshift. Mindket doesn’t write or check them. Open one to read it where it was posted.

Searched

More from Mindket

See all from Mindket

Huashu Design

alchaincyf · Skill

Turns a one-line request in your AI agent into a finished design: a launch animation, a clickable app prototype, an editable slide deck, an infographic or a se…

New29.4k

Guizang PPT Skill

op7418 · Skill

Skill that makes single-file HTML slide decks, slide illustrations and platform covers in two visual styles, with a presenter mode for rehearsal. For speakers…

New29.8k

Claude Code Skills & Plugins

alirezarezvani · Skill

Adds 411 ready-made skills for Claude Code and other coding agents, grouped by role from engineering and product to marketing, finance and compliance. Installs…

New29.8k

Similar in Marketing & SEO

See all in Marketing & SEO

Pixel Art XL

nerijs · Kit

A pixel art style add-on for Stable Diffusion XL that turns text prompts into pixel-style images, with an optional LCM LoRA for faster runs. For game makers, d…

New

Licon MSR for LTX-2.5

LiconStudio · Kit

Keeps characters, clothing, objects and backgrounds consistent in generated video by feeding the model up to five reference images. A LoRA for LTX-2.5 in Comfy…

New

Flux.2-Klein-9B-MatchingPose

nhathoangfoto · Kit

A LoRA for FLUX.2 Klein 9B that puts a character into the pose shown by a mannequin reference while keeping the character's face and style. For artists and des…

New