Open Source · MIT License · v0.1

Know where your brand
stands in AI responses

RanktheBot scans ChatGPT with hundreds of real queries, scores your brand's visibility 0–100, and shows you exactly how you stack up against competitors — from your terminal.

$ git clone https://github.com/nikkos/rankthebot.git && pip3 install -e rankthebot/
0–100
Visibility score
65+
Queries per scan
~$1
Cost per full scan
100%
Local — no data shared

How it works

Three commands to your
AI visibility score

RanktheBot handles query expansion, multi-run scanning, and weighted scoring automatically. You just read the results.

Step 01
🔑

Connect your API key

Authenticate with your OpenAI key. It stays local in ~/.rankthebot/config.json — never sent anywhere else.

$ rankthebot auth connect --openai
Step 02
🔍

Expand your query set

Provide one topic, get dozens of query variants across 4 user personas — small business owner, developer, enterprise buyer, and agency.

$ rankthebot queries expand "CRM software"
Step 03
📊

Scan & get your score

Runs 3× per query to account for LLM variability, extracts brand mentions with position and sentiment, and produces a 0–100 score.

$ rankthebot report visibility --brand "acme"

Features

Everything you need to
track AI search presence

Built for marketers, SEOs, and growth teams who need to understand the AI search landscape before their competitors do.

🧠

Smart query expansion

Turn a single keyword into 65+ real-world ChatGPT queries. RanktheBot simulates how actual buyers phrase questions — across industries, roles, and intents — so you see the full picture, not just one angle.

GPT-4o powered
🔄

Multi-run scanning

AI responses are non-deterministic. Running each query 3 times and averaging results gives you a statistically reliable visibility score — not a fluke snapshot that changes on the next refresh.

3× per query
📈

Position-weighted scoring

Not all mentions are equal. A first-position mention scores highest; each subsequent position decays by ~18%. The 0–100 score reflects how prominently — and how early — your brand appears.

0–100 score
🏆

Competitor benchmarking

See every brand that appears in your query set, ranked by AI visibility. Identify which competitors dominate AI responses and find the gaps you can win. Export to CSV for Google Sheets.

CSV export

Quick start

Up and running in minutes

Requires Python 3.9+ and an OpenAI API key. Works on Mac, Linux, and Windows (WSL).

rankthebot — zsh
$git clone https://github.com/nikkos/rankthebot.git
Cloning into 'rankthebot'...
remote: Enumerating objects: 142, done.
✓ Done.
$cd rankthebot && pip3 install -e .
Installing dependencies...
✓ rankthebot installed successfully.
$rankthebot --help
✓ Ready. Run rankthebot auth connect --openai to begin.
$rankthebot auth connect --openai
Enter your OpenAI API key:
sk-••••••••••••••••••••••••••••••••
✓ API key saved to ~/.rankthebot/config.json
✓ Connection verified — GPT-4o is reachable.
# Key stored locally — never committed to git
$rankthebot queries expand "CRM software"
Generating query variants...
✓ 65 queries generated across 4 personas:
  • 18 queries — Small business owner
  • 15 queries — Developer
  • 17 queries — Enterprise buyer
  • 15 queries — Agency
# Run 'rankthebot scan --dry-run' to preview
$rankthebot scan
Scanning 65 queries × 3 runs = 195 total requests...
Using GPT-4o for responses, GPT-4o-mini for extraction.
 [██████████████████░░░░░] 78% — query 51/65
✓ Scan complete. Estimated cost: $1.12
✓ Results stored in local SQLite database.
$rankthebot report visibility --brand "hubspot"
AI Visibility Score: 74 / 100
Mentioned in: 48 / 65 queries
Avg position: 1.8 | Sentiment: +0.62
$rankthebot report competitors --output results.csv
✓ Competitor report saved to results.csv

Stay in the loop

AI search is moving fast.
Don't fall behind.

Get monthly updates on RanktheBot releases, AI visibility benchmarks, and practical tips to improve how your brand appears in ChatGPT responses.

No spam, ever. Unsubscribe any time.

✓ You're in — check your inbox to confirm.

Start tracking your
AI visibility today

Free, open-source, and runs entirely on your machine.
Your API key and data never leave your computer.