I Built a Simple AI Visibility Tracker in Python. Here’s What Breaks When You Scale It

I Built a Simple AI Visibility Tracker in Python. Here’s What Breaks When You Scale It AI visibility tracking sounds like a fairly simple programming problem. Ask ChatGPT a question. Check whether a brand appears in the answer. Save the result. Repeat tomorrow. And honestly, at first, it is that simple. You can build a primitive AI visibility tracker in a few lines of Python. from openai import OpenAI from datetime import datetime client = OpenAI() brand = "Acme" prompts = [ "What are the best project management tools?", "What are good alternatives to Trello?", "What project management software is best for small businesses?", "Which project management tools have AI features?", "What tools can remote teams use to organize projects?" ] results = [] for prompt in prompts: response = client.responses.create( model="gpt-5.4-mini", input=prompt ) answer = response.output_text results.append({ "prompt": prompt, "mentioned": brand.lower() in answer.lower(), "response": answer, "checked_at": datetime.utcnow().isoformat() }) visibility = ( sum(r["mentioned"] for r in results) / len(results) ) * 100 print(f"{brand} visibility: {visibility:.1f}%") If Acme appears in two of five responses, we could call that 40% visibility. Done. Well... not quite. I recently worked through this problem while building the AI visibility tracking system behind CrawlSpider, and the interesting part wasn't making the LLM API call. It was everything that happened after that. The innocent-looking nested loop Conceptually, an AI visibility tracker looks something like this: for each brand: for each prompt: for each model: ask the model save the response find the brand find competitors calculate metrics That looks harmless. But consider: 100 brands × 50 prompts × 3 models × daily scans That's 15,000 requests every day. Or 450,000 model responses every month. Move to 1,000 brands and you're dealing with millions. And suddenly this: for prompt in prompts: call_llm(prompt) isn't really the architecture anymore. You need a queue The first thing that breaks is the simple loop. What happens if request #8,742 fails? What happens when an API starts returning rate-limit errors? What if one provider slows down? What if your worker crashes halfway through a batch? You don't want to restart everything. So the architecture starts becoming something like: Scheduler ↓ Scan Generator ↓ Job Queue ↓ Worker Pool ↓ LLM Provider ↓ Response Store Now you need: - retries - exponential backoff - concurrency controls - job states - idempotency - dead-letter handling - rate-limit management - monitoring We've moved surprisingly far away from our original Python script. Then brand in response breaks Our prototype has another wonderfully naive line: brand.lower() in answer.lower() Try that with: brand = "Apple" Did the model mention Apple Inc.? Or an apple? What about abbreviations? Product names? Parent companies? And simply knowing that a brand appeared isn't particularly interesting. Suppose the response says: For enterprise teams I'd consider Acme or Monday.com, while smaller teams might prefer Trello. Now I probably want something closer to: { "target_brand": { "mentioned": true, "position": 1 }, "competitors": [ {"name": "Monday.com", "position": 2}, {"name": "Trello", "position": 3} ] } The tracker has quietly turned into an entity extraction and classification system too. The real product is history Here's another realization I had while working on this. A single AI response isn't particularly valuable. Change is valuable. Imagine seeing this: "Best project management software for small businesses?" Week 1 Acme not mentioned Week 2 Acme #5 Week 3 Acme #3 Week 4 Acme #2 That's interesting. But now every observation potentially needs: brand_id prompt_id model_id model_version timestamp raw_response brand_mentioned brand_position competitors sentiment citations token_usage latency status Multiply that by millions of responses. You're not storing API results anymore. You're building a historical analytics dataset. Multiple models make things more interesting Then you decide that monitoring one AI model isn't enough. Maybe you want: providers = [ "openai", "anthropic", "google" ] Each has different APIs, response structures, rate limits, model identifiers, errors, citations and pricing. Eventually you want an abstraction like: ┌── OpenAI Adapter Prompt Engine ───┼── Anthropic Adapter └── Google Adapter ↓ Normalized Response Otherwise provider-specific logic ends up everywhere. Scheduling becomes a system of its own Then users ask for: Prompt A → Daily Prompt B → Weekly Prompt C → Daily Prompt D → Manual Now something has to determine what is due. And prevent duplicate runs. And recover failed jobs. And calculate the next run. And make sure one huge account doesn't consume the entire worker pool. At this point the "AI visibility tracker" is really a distributed job-processing and analytics application that happens to call LLMs. AI responses aren't deterministic either There's another subtle problem. Run: What are the best tools for X? today and your brand might appear. Run the exact same prompt tomorrow and it might not. That doesn't necessarily mean the brand suddenly became less visible. LLM responses vary. So when a dashboard says: Visibility Last week: 42% This week: 38% what does that actually mean? Is something changing? Or are we observing normal model variation? This makes prompt consistency, sample size, model versions and historical comparison surprisingly important. API cost isn't the only scaling problem It's natural to focus on token costs. Those certainly matter when you're running hundreds of thousands or millions of requests. But I found the more interesting cost to be engineering complexity. At scale you're paying for much more than inference: LLM inference + queues + workers + databases + storage + scheduling + retries + observability + analytics + provider maintenance + engineering time And every new dimension multiplies the workload: brands × prompts × models × scan frequency × time That's the equation I'd pay attention to when designing one of these systems. We had a useful head start One reason we were able to build this into CrawlSpider is that we weren't starting completely from zero. I'd previously built pieces of this kind of infrastructure for other projects. InfoCaptor had given us experience with analytics, visualization and AI-driven workflows. CrawlSpider's existing internal-linking system already dealt with crawling, page analysis, background processing and large collections of URLs. Other projects had already forced us to solve problems around scheduled jobs, APIs, queues and asynchronous processing. The AI visibility tracker became less about inventing every component and more about assembling those existing patterns around a new workflow: Brand ↓ Prompts ↓ Models ↓ Scheduled scans ↓ Responses ↓ Mentions + competitors ↓ Historical metrics ↓ Dashboard That reuse turned out to be extremely valuable. The interesting lesson Could you build an AI visibility tracker yourself? Absolutely. In fact, I think building the five-prompt Python version is a great weekend project. The core algorithm can fit on one screen. But that's also what makes this problem interesting. There is a huge gap between: "Call an LLM and see if my brand appears." and: "Reliably monitor thousands of brands across multiple models every day and explain how their visibility is changing." The first is an API call. The second is a platform. I wrote a much deeper breakdown of the architecture, scaling math, infrastructure and costs while documenting how we approached this at CrawlSpider: How to Build an AI Visibility Tracker From Scratch If you're building something similar, I'd be interested in hearing how you're approaching the scheduling, normalization and non-determinism problems. PS: I also built a AI Adoption visualization Dashboard , check out! I also maintain LLM cutoff dates for major providers https://www.crawlspider.com/llm-knowledge-cutoff-dates/ Lastly there are 50+ brands monitored for their AI Visibility Top comments (0)