GEO-SEO Claude

https://github.com/zubair-trabzada/geo-seo-claude
Admin
GEO-SEO Claude is a Generative Engine Optimization and SEO analysis toolkit for Claude Code that...
Tokens:118,651
Snippets:832
Trust Score:8.2
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
### Setup and run scripts (fetch_page, citability_scorer, brand_scanner, llmstxt_generator, crm_dashboard, webapp)

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/CLAUDE.md

Setup commands and script invocations for the geo-seo-claude repository. Scripts print JSON to stdout for skills/agents to parse; requires Python with requirements.txt installed (beautifulsoup4, requests, lxml, playwright, Pillow, flask, rich, validators).

```bash
python3 -m venv .venv && . .venv/bin/activate && pip install -r requirements.txt
python3 -m playwright install chromium   # fetch_page.py uses Playwright for SSR/JS checks

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>
python3 scripts/crm_dashboard.py          # rich CLI over ~/.geo-prospects
python3 scripts/webapp/app.py             # CRM web UI at http://localhost:5050
```

--------------------------------

### Example brand.json configuration

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/white-label/README.md

Example configuration file. Copy brand.example.json to brand.json and edit. Omitted fields keep defaults; colors are merged key-by-key. Keys starting with underscore are ignored.

```json
{
  "name": "Your Agency Inc.",
  "website": "youragency.com",
  "phone": "555-123-4567",
  "contact_name": "Your Name",
  "colors": {
    "primary": "#19C3B2",
    "text_accent": "#19C3B2"
  }
}
```

--------------------------------

### Manual install for macOS/Linux

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Manual installation for macOS and Linux. Clones the repository, changes into the directory, and runs the install script.

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

--------------------------------

### Verify skill with /geo quick command

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Run this command in Claude Code to verify the skill is installed. A successful run starts a 60-second GEO visibility snapshot; otherwise, restart Claude Code.

```text
/geo quick https://example.com
```

--------------------------------

### One-liner install for macOS/Linux

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

One-liner installer for macOS and Linux. Downloads and runs the install script directly from the repository.

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

--------------------------------

### Install on Windows via Git Bash

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Installation for Windows using Git Bash. PowerShell and Command Prompt are not supported. Provides both one-liner and manual methods.

```bash
# One-liner (run from Git Bash)
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash

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

--------------------------------

### Recommended JSON-LD Template Example (Schema Type 2)

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/agents/geo-schema.md

Second example JSON-LD template for a recommended schema type, with placeholder values.

```json
{
  [Complete template]
}
```

--------------------------------

### GEO Proposal Command Examples

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-proposal/SKILL.md

Example invocations of the /geo proposal command with different arguments.

```bash
/geo proposal electron-srl.com
```

```bash
/geo proposal electron-srl.com --tier standard --client-name "Electron Srl"
```

```bash
/geo proposal ~/.geo-prospects/audits/electron-srl.com-2026-03-12.md
```

--------------------------------

### Install Python dependencies manually

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Run this from the cloned repo or the skill directory if the installer reports failed Python dependencies.

```bash
python3 -m pip install --user -r requirements.txt
```

--------------------------------

### Prospect JSON Record Example

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/skills/geo-prospect/SKILL.md

Example JSON record for a single prospect, showing all fields including id, company, domain, contact info, status, geo_score, audit details, and notes.

```json
{
  "id": "PRO-001",
  "company": "Electron Srl",
  "domain": "electron-srl.com",
  "contact_email": "info@electron-srl.com",
  "contact_name": "",
  "industry": "Educational Equipment Manufacturing",
  "country": "Italy",
  "status": "qualified",
  "geo_score": 32,
  "audit_date": "2026-03-12",
  "audit_file": "~/.geo-prospects/audits/electron-srl.com-2026-03-12.md",
  "proposal_file": "~/.geo-prospects/proposals/electron-srl.com-proposal.md",
  "monthly_value": 0,
  "contract_start": null,
  "contract_months": 0,
  "notes": [
    {
      "date": "2026-03-12",
      "text": "Initial GEO quick scan. Score 32/100 - Critical tier. Strong candidate for GEO services."
    }
  ],
  "created_at": "2026-03-12",
  "updated_at": "2026-03-12"
}
```

--------------------------------

### GEO Audit Commands - Quick Start

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/geo/SKILL.md

Run a full GEO audit, check crawler visibility, score citability, generate llms.txt, get a quick snapshot, or create a report using the /geo commands. Each command targets a specific function and takes a website URL as an argument.

```bash
# Full GEO audit of a website
/geo audit https://example.com

# Check if AI bots can see your site
/geo crawlers https://example.com

# Score a specific page for AI citability
/geo citability https://example.com/blog/best-article

# Generate an llms.txt file for your site
/geo llmstxt https://example.com

# Get a 60-second visibility snapshot
/geo quick https://example.com

# Generate a client-ready report
/geo report https://example.com
```

--------------------------------

### Analyze or generate llms.txt: /geo llmstxt https://example.com

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/commands-reference.md

Runs the /geo llmstxt command against a domain root URL. It fetches existing llms.txt and llms-full.txt files; if none exist, it generates a new one by crawling the sitemap and homepage. Output is either GEO-LLMSTXT-ANALYSIS.md (analysis mode) or a ready-to-deploy llms.txt and GEO-LLMSTXT-GENERATION.md (generation mode).

```bash
/geo llmstxt https://example.com
```

--------------------------------

### Run brand_config.py to print merged brand dict

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/white-label/README.md

Command-line invocation to test the configuration. Prints the merged brand dictionary.

```bash
python brand_config.py brand.json    # prints the merged brand dict
```

--------------------------------

### Install Playwright chromium manually

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/docs/getting-started.md

Use this command if Playwright was skipped during install, causing screenshot steps to fail.

```bash
python3 -m playwright install chromium
```

--------------------------------

### Recommended JSON-LD Template Example (Schema Type 1)

Source: https://github.com/zubair-trabzada/geo-seo-claude/blob/main/agents/geo-schema.md

Example JSON-LD template for a recommended schema type, with placeholder values. Implementation note: add to <head> inside a <script type="application/ld+json"> tag.

```json
{
  "@context": "https://schema.org",
  "@type": "[Type]",
  [Complete template with placeholder values]
}
```
Tokens:
Raw