🔍 AEO Tracker

Track your brand's dominance in the AI search era. Because if AI doesn't mention you, do you even exist?

🚀 What This Does

Ever wonder how often ChatGPT recommends your product vs. your competitors? Now you can know.

AEO Tracker monitors your Answer Engine Optimization performance by:

• 🎯 Tracking brand mentions across AI responses
• 📊 Analyzing citation sources and domains
• 🤖 Generating strategic questions from your SEO keywords
• 📈 Visualizing your share of voice against competitors

Built in a hackathon. Deployed to production. Zero regrets.

⚡ Quick Start

# Clone and enter
cd convex_hackathon

# Install everything
source venv/bin/activate
pip install -r requirements.txt
npm install

# Configure your keys
echo "CONVEX_URL=your_convex_url" >> .env
echo "OPENAI_API_KEY=your_openai_key" >> .env

# Launch backend
npx convex dev

# Launch frontend (new terminal)
source venv/bin/activate
streamlit run streamlit_app.py

Open http://localhost:8501 and watch the magic happen. ✨

🎨 Features That Slap

Question Intelligence

• 💡 AI-powered question suggestions from SEO keywords
• 🔮 Discover what users actually ask about your space
• 📝 Track unlimited questions across categories

Brand Analytics

• 🏆 Real-time brand mention tracking
• 🔗 Citation source analysis
• 📊 Beautiful share-of-voice visualizations
• 🎯 Compare yourself against every competitor

Built Different

• ⚡ Real-time updates with Convex
• 🌐 Web-native with Streamlit
• 🧠 Powered by OpenAI GPT-5
• 🎨 Clean, modern UI that doesn't suck

🛠 Tech Stack

Backend Magic

• Convex - Serverless backend that just works
• TypeScript for type-safe mutations

Frontend Vibes

• Streamlit - Python web apps in minutes
• Plotly for data viz that pops

AI Superpowers

• OpenAI GPT-5 with web search
• Structured output parsing with Pydantic
• Multi-response aggregation for accuracy

📊 How It Works

1. Input Questions: Add questions users might ask about your space
2. AI Analysis: GPT-5 generates responses with real web citations
3. Parse & Track: Extract brand mentions and citation domains
4. Visualize: See your share of voice vs. competitors

🎯 Use Cases

• Marketing Teams: Track AEO performance like you track SEO
• Founders: Know if AI recommends your product
• Competitive Intel: See who's winning the AI mindshare game
• Content Strategy: Optimize for AI search results

🔥 Built With

Made with ⚡ by a developer who refuses to let competitors dominate the AI narrative.

P.S. - If you're not tracking AEO in 2025, you're already behind.