GEO Tracker
Track how AI engines mention (or ignore) a brand. Query multiple AI-powered search engines, extract brand mentions, score visibility, and generate actionable optimization reports.
Quick Start
Single Query Check
python3 scripts/geo_query.py --brand "EZsite.ai" --query "best AI website builder" --engines chatgpt,perplexity,gemini
Full Audit (batch prompts)
python3 scripts/geo_audit.py --brand "EZsite.ai" --prompts references/prompts.txt --engines all --output report.md
Competitor Comparison
python3 scripts/geo_query.py --brand "EZsite.ai" --competitors "Wix,Squarespace,Framer" --query "best website builder for small business"
Dependencies
Install required Python packages (one-time):
pip3 install openai anthropic google-generativeai
Or create a virtual environment:
python3 -m venv venv
source venv/bin/activate
pip install openai anthropic google-generativeai
Set API keys as environment variables:
export OPENAI_API_KEY="sk-..."
export PERPLEXITY_API_KEY="..."
export GOOGLE_API_KEY="..."
export ANTHROPIC_API_KEY="sk-ant-..."
How It Works
- Takes a brand name + search prompts
- Queries AI engines via their APIs or web interfaces
- Extracts: mentions, citations, sentiment, positioning
- Scores visibility (0-100) per engine and overall
- Generates optimization recommendations
Engines Supported
| Engine | Method | API Key Env Var |
|---|---|---|
| ChatGPT | OpenAI API | OPENAI_API_KEY |
| Perplexity | Perplexity API | PERPLEXITY_API_KEY |
| Gemini | Google AI API | GOOGLE_API_KEY |
| Claude | Anthropic API | ANTHROPIC_API_KEY |
| Google AI Overview | web_search tool | (none) |
At minimum, configure one API key. More engines = better coverage.
Visibility Score
- 0-20: Invisible — AI doesn't know the brand
- 21-40: Low — occasional mentions, not recommended
- 41-60: Moderate — mentioned but not top choice
- 61-80: Strong — frequently cited/recommended
- 81-100: Dominant — top recommendation across engines
Output Format
Reports include:
- Per-engine mention count and context
- Visibility score breakdown
- Competitor comparison matrix
- Top optimization recommendations
- Source prompts that triggered (or missed) mentions
Prompt Library
Edit references/prompts.txt — one prompt per line. These are the queries sent to AI engines.
Example prompts for a website builder brand:
best AI website builder
how to build a website without coding
website builder comparison 2025
best website builder for small business
AI-powered web design tools
Optimization Tips Reference
See references/geo-optimization.md for content optimization strategies to improve AI visibility.
Scheduling
Use OpenClaw cron to run daily/weekly audits:
Schedule a daily GEO audit for EZsite.ai at 9am
The agent will run the audit and report findings.