# GEO/AEO Tracker

> Open-source, local-first dashboard that tracks how 5 AI models (ChatGPT, Perplexity, Gemini, Copilot and Google AI Mode) mention your brand. Self-hosted, MIT licensed, bring your own API keys.

## Project

- [GitHub repository](https://github.com/danishashko/geo-aeo-tracker): source code, issues and releases
- [README](https://github.com/danishashko/geo-aeo-tracker/blob/main/README.md): features, architecture, quick start and deployment
- [AGENTS.md](https://github.com/danishashko/geo-aeo-tracker/blob/main/AGENTS.md): instructions for coding agents working in the repository
- [License](https://github.com/danishashko/geo-aeo-tracker/blob/main/LICENSE): MIT

## Live demo

- [Demo dashboard](https://geo-aeo-tracker-wine.vercel.app/demo): read-only preview with sample data
- [Full product description](https://geo-aeo-tracker-wine.vercel.app/llms-full.txt): features, quick start, environment variables, API routes and tech stack

## API routes

- [POST /api/scrape](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/scrape/route.ts): Bright Data AI Scrapers, query AI models for brand mentions
- [POST /api/analyze](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/analyze/route.ts): OpenRouter LLM inference, battlecards, niche queries
- [POST /api/audit](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/audit/route.ts): AEO site audit: llms.txt, schema, BLUF, heading checks
- [POST /api/sro-analyze](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/sro-analyze/route.ts): SRO final analysis, synthesizes all data into score + recommendations
- [POST /api/serp](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/serp/route.ts): Bright Data SERP, organic search results for a keyword
- [POST /api/site-context](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/site-context/route.ts): Homepage scrape + context extraction via OpenRouter
- [POST /api/unlocker](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/unlocker/route.ts): Bright Data Web Unlocker, single or batch URL scraping
- [POST /api/brightdata-platforms](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/brightdata-platforms/route.ts): 5-platform AI citation polling via Bright Data datasets
- [POST /api/bulk-sro](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/bulk-sro/route.ts): SSE streaming, bulk SRO analysis across multiple keywords
- [POST /api/rank-signal](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/rank-signal/route.ts): SSE streaming, Rank Signal paired A/B trials for one signal (GET returns signals and allowed judge models)
- [GET/PUT/DELETE /api/state](https://github.com/danishashko/geo-aeo-tracker/blob/main/app/api/state/route.ts): Cloud KV store proxy, reads/writes to Supabase using service-role key (disabled when cloud not configured)

## Optional

- [Sitemap](https://geo-aeo-tracker-wine.vercel.app/sitemap.xml)