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

1. Takes a brand name + search prompts
2. Queries AI engines via their APIs or web interfaces
3. Extracts: mentions, citations, sentiment, positioning
4. Scores visibility (0-100) per engine and overall
5. Generates optimization recommendations

Engines Supported

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.