GEO/AEO Tracker

Open-source, local-first AI visibility intelligence dashboard.
Track your brand across 6 AI models with zero vendor lock-in.

Features · Quick Start · Deploy · API

---

🌐 Built with Bright Data — the world's leading web data platform. GEO/AEO Tracker uses Bright Data's AI Scraper API to reliably collect structured responses from 6 AI models. Get your API key →

---

Why

AI models are replacing traditional search for millions of queries. If your brand isn't visible in ChatGPT, Perplexity, or Gemini responses, you're invisible to a growing audience.

Existing tools charge $200–$500+/month, lock you into closed ecosystems, and store your data on their servers.

GEO/AEO Tracker is the alternative:

• 🔑 BYOK (Bring Your Own Keys): your data never leaves your machine
• 🤖 6 AI models simultaneously: more coverage than paid tools
• 💸 $0/month: self-hosted, open-source, forever free
• 🛡️ Local-first: IndexedDB + localStorage, no external database

Features

📋 12 Feature Tabs

Tab	What it does
⚙️ Project Settings	Brand name, aliases, website, industry, keywords, description
💬 Prompt Hub	Manage tracking prompts with {brand} injection. Run single or batch across models
🎭 Persona Fan-Out	Generate persona-specific prompt variants (CMO, SEO Lead, Founder, etc.)
🔍 Niche Explorer	AI-generated high-intent queries for your niche
📝 Responses	Browse AI responses with brand/competitor highlighting, filters, and search
📊 Visibility Analytics	Score trends over time via Recharts line charts. CSV export
🔗 Citations	Domain-grouped citation frequency analysis
🎯 Citation Opportunities	URLs where competitors get cited but you don't, with outreach briefs
⚔️ Competitor Battlecards	AI-generated side-by-side competitor analysis with strengths/weaknesses
🏥 AEO Audit	Site readiness check: llms.txt, Schema.org, BLUF density, heading structure
⏱️ Automation	Cron / GitHub Actions templates for scheduled runs
📖 Documentation	Searchable 14-section guide covering every feature

🚀 Core Capabilities

• 🤖 Multi-model tracking across ChatGPT, Perplexity, Gemini, Copilot, Google AI Overview, Grok
• 📈 Visibility scoring (0–100): brand mentions, position, frequency, citations, sentiment
• 🔔 Drift alerts: automatic notifications when your score changes significantly
• ⏰ Scheduled auto-runs: configurable interval-based batch scraping
• 📅 Historical comparison: delta tracking across time periods
• 🏢 Multi-workspace: manage multiple brands/projects independently
• 🎨 Dark/light/system theme with a polished sidebar UI

Architecture

Next.js 16.1 + Turbopack
├── app/
│   ├── page.tsx                    # Main dashboard (or demo via env var)
│   ├── demo/page.tsx               # Standalone demo route
│   └── api/
│       ├── scrape/route.ts         # Bright Data AI Scrapers (Node runtime)
│       ├── analyze/route.ts        # OpenRouter LLM analysis (Edge runtime)
│       └── audit/route.ts          # AEO site audit crawler
├── components/
│   ├── sovereign-dashboard.tsx     # Main shell — state, tabs, KPIs
│   └── dashboard/
│       ├── types.ts                # AppState, ScrapeRun, Provider, etc.
│       └── tabs/                   # 12 tab components
├── lib/
│   ├── client/sovereign-store.ts   # IndexedDB + localStorage persistence
│   ├── server/brightdata-scraper.ts # Bright Data API integration
│   └── demo-data.ts               # Deterministic seed data for demo mode
└── scripts/
    ├── test-scraper.js             # API validation script
    └── test-pillar.js              # Feature pillar tests

Key decisions:

• IndexedDB primary store (no size limit) with localStorage as best-effort cache
• Edge runtime for /api/analyze (Kimi K2.5 via OpenRouter) — fast global inference
• Bright Data Web Scraper API for AI model scraping — reliable, structured data
• Zod schema validation on all API routes
• Recharts for analytics visualizations
• Tailwind CSS v4 with CSS custom properties for theming

Quick Start

Prerequisites

• Node.js 18+
• Bright Data API key + AI Scraper dataset IDs
• OpenRouter API key

Install & Run

git clone https://github.com/danishashko/sovereign-aeo-tracker.git
cd sovereign-aeo-tracker
npm install

Create .env in the project root:

BRIGHT_DATA_KEY=your_bright_data_api_key

# AI Scraper dataset IDs (from Bright Data Scrapers Library)
BRIGHT_DATA_DATASET_CHATGPT=gd_xxx
BRIGHT_DATA_DATASET_PERPLEXITY=gd_xxx
BRIGHT_DATA_DATASET_COPILOT=gd_xxx
BRIGHT_DATA_DATASET_GEMINI=gd_xxx
BRIGHT_DATA_DATASET_GOOGLE_AI=gd_xxx
BRIGHT_DATA_DATASET_GROK=gd_xxx

# OpenRouter (powers /api/analyze — battlecards, niche generation)
OPENROUTER_KEY=your_openrouter_api_key

npm run dev

Open http://localhost:3000.

Validate Setup

npm run test:scraper    # Test Bright Data API connection
npm run build           # Full production build check
npm run lint            # ESLint

Deploy to Vercel

✅ The deploy button launches a fully functional production instance. You'll be prompted for your API keys during setup. No demo mode, no restrictions.

1. Click the button above (or run vercel --prod from your clone)
2. Enter your Bright Data and OpenRouter API keys when prompted
3. Done! Your tracker deploys automatically with full production capabilities

🧪 Demo-Only Mode (optional)

Want to deploy a read-only preview with sample data and no API keys?

1. Add env var NEXT_PUBLIC_DEMO_ONLY = true in Vercel → Project Settings → Environment Variables
2. Redeploy. The dashboard will load with pre-generated demo data instead of making live API calls

API Routes

Route	Runtime	Purpose
POST /api/scrape	Node.js	Bright Data AI Scrapers — query AI models for brand mentions
POST /api/analyze	Edge	OpenRouter LLM inference — battlecards, niche queries
POST /api/audit	Node.js	AEO site audit — llms.txt, schema, BLUF, heading checks

All routes include in-memory caching to minimize API costs.

Tech Stack

Layer	Technology
Framework	Next.js 16.1 + Turbopack
Language	TypeScript (strict)
Styling	Tailwind CSS v4 with @theme inline
Charts	Recharts
Validation	Zod
Storage	IndexedDB (idb-keyval) + localStorage
AI Scraping	Bright Data Web Scraper API
LLM Inference	OpenRouter (Kimi K2.5)
Deployment	Vercel

License

MIT — use it, fork it, ship it.

---

Built by Daniel Shashko
_{Powered by Bright Data}