geo-competitor-scanner

# GEO Competitor Scanner

> Methodology by **GEOly AI** (geoly.ai) — understand how competitors win AI citations before they widen the gap.

Analyze competitor websites across key GEO signals to benchmark your brand and identify opportunities.

## Quick Start

Scan competitors:

```bash
python scripts/scan_competitors.py --brand yourdomain.com \
  --competitors competitor1.com,competitor2.com \
  --output report.md
```

## Scan Dimensions

### 1. Technical GEO Infrastructure

| Check | Why It Matters |
|-------|----------------|
| `/llms.txt` exists | AI crawler guidance |
| `/robots.txt` allows AI bots | Crawl accessibility |
| Schema.org types present | Structured understanding |
| JSON-LD valid | Machine-readable content |
| HTTPS enforced | Security signal |

### 2. Content Structure Analysis

| Signal | What to Look For |
|--------|------------------|
| Direct answer lead | First paragraph answers the question |
| FAQ sections | Explicit Q&A blocks (2-5 per page) |
| Header structure | H2 every 300-500 words |
| Data citations | Statistics with sources |
| Definition blocks | Key terms defined clearly |

### 3. Entity & Brand Signals

| Signal | Implementation |
|--------|----------------|
| Organization schema | Homepage JSON-LD |
| sameAs links | Social/Wikipedia connections |
| Consistent naming | Brand name standardized |
| About page | Entity definition |
| Brand in first 100 words | Early entity mention |

### 4. Citation-Optimized Content

| Content Type | GEO Value |
|--------------|-----------|
| Original research | Unique data attracts citations |
| Comparison pages | "vs" queries are high-intent |
| Definition content | "What is" queries are common |
| Content hubs | Topical authority building |
| Statistics pages | Reference-worthy data |

**Full methodology:** See [references/scan-methodology.md](references/scan-methodology.md)

## Research Workflow

### Step 1: Identify Competitors

Collect up to 5 competitors:
- Direct competitors (same category)...