Skip to main content

Quick Start

Get up and running with AEO/GEO Analytics in 5 minutes. This guide walks you through your first complete workflow: generate, save, execute, and analyze queries.

Prerequisites​

Before starting, ensure you have:

  • ✅ Completed Installation
  • ✅ Configured API Keys
  • ✅ Application running at http://localhost:3000

Step 1: Generate Queries with AI​

Let's use Claude to generate realistic consumer queries.

Navigate to Generate Page​

  1. Open http://localhost:3000/dashboard/generate
  2. You'll see the Query Generation form

Configure Generation Parameters​

Fill in the form:

Industry: home-improvement (select from dropdown)

Focus Area (optional): DIY plumbing repairs

Personas: Select all three

  • ☑️ Consumer
  • ☑️ Professional
  • ☑️ Beginner

Journey Stages: Select all three

  • ☑️ Awareness
  • ☑️ Consideration
  • ☑️ Decision

Query Count: 20 (use slider)

Problem-Focused: ☑️ Enabled (checkbox)

Generate Queries​

Click Generate Queries button.

Wait 5-10 seconds while Claude generates realistic queries...

Review Results​

You should see 20 generated queries like:

✓ How do I fix a leaking faucet in my kitchen?
✓ What tools do I need to replace a bathroom sink drain?
✓ Should I hire a plumber or DIY my garbage disposal replacement?
✓ How much does it cost to replace a toilet?
... 16 more queries

Each query includes:

  • Persona: Who would ask this
  • Journey Stage: Where they are in decision process
  • Category: Type of query (how-to, comparison, etc.)
  • Intent: What they're trying to accomplish

Step 2: Save to Query Library​

Now let's save these queries for reuse.

Fill Save Form​

Below the generated queries:

Query Set Name: Home Improvement - Plumbing DIY

Description: Consumer queries about DIY plumbing repairs and when to call professionals

Tags: plumbing, diy, home-repair (comma-separated)

Save Query Set​

Click Save to Library button.

Success message appears: "Query set saved successfully!"

Step 3: Execute Queries​

Let's run these queries across LLM providers.

Click Execute button (or go to /dashboard/execute?setId=...)

You'll see:

  • 📘 Blue banner: "Query Set Loaded: Home Improvement - Plumbing DIY"
  • All 20 queries pre-loaded in batch mode
  • Provider selection

Select Providers​

Choose which LLM providers to test (select at least one):

☑️ Claude - Best citation quality ☐ GPT-4 - Balanced responses ☐ Gemini - Free tier ☐ Perplexity - Search-optimized

tip

Start with one provider for your first test to save costs. You can run the same queries again later with different providers.

Execute Batch​

Click Execute Batch Queries button.

Watch real-time progress:

  • Query 1/20: Executing... ✓ Done
  • Query 2/20: Executing... ✓ Done
  • ...

Execution takes ~30-60 seconds for 20 queries.

View Results Summary​

After completion, you'll see:

✅ Batch Execution Complete

Completed Queries: 20/20
Total Responses: 20
Total Citations: 156
Total Cost: $0.06
Execution Time: 47.3 seconds

Click View Analytics to see detailed results.

Step 4: Analyze Citations​

Let's explore what domains got cited.

Go to http://localhost:3000/dashboard/analytics

Overview Metrics​

You'll see top-level stats:

Total Queries: 20 Total Responses: 20 Total Citations: 156 Average Citations per Response: 7.8

Top Cited Domains​

Scroll to "Top Cited Domains" section:

1. familyhandyman.com - 23 citations (14.7%)
2. thisoldhouse.com - 19 citations (12.2%)
3. homedepot.com - 15 citations (9.6%)
4. youtube.com - 12 citations (7.7%)
5. angieslist.com - 11 citations (7.1%)

Key Insight: These are the domains Claude cited most when answering DIY plumbing queries. If you're in this space, these are your competitors for AI visibility.

Domain Deep Dive​

Click on familyhandyman.com to see:

  • Which queries triggered citations
  • Specific URLs cited
  • Citation context from responses
  • Comparison across providers (if you used multiple)

Query History​

Click Queries tab to see all 20 executed queries with:

  • Response text (truncated)
  • Citation count per query
  • Cost per query
  • Execution time

Step 5: Identify Opportunities​

Based on your first test run, you can now:

Content Gaps​

Look for queries where:

  • Few citations (2-3) → Opportunity to create definitive content
  • No citations of your domain → Content gap to fill
  • Competitor citations only → Need better SEO/AEO

Citation Patterns​

Notice which content types get cited:

  • How-to guides
  • Product comparison pages
  • Expert advice articles
  • Video tutorials (YouTube)
  • Tool/product listings

Next Queries to Test​

Generate new query sets for:

  • Different focus areas (e.g., "bathroom remodeling", "outdoor projects")
  • Different industries entirely
  • Competitor brand names
  • Your own brand name

Complete Workflow Summary​

You just completed the full AEO/GEO Analytics workflow:

Generate → Save → Execute → Analyze
   ↓         ↓        ↓         ↓
  20      Query    Batch     Citation
queries   Set    execution   analysis

Time: ~5 minutes Cost: $0.03-0.06 (depending on provider) Insights: Citation patterns, competitor analysis, content opportunities

What's Next?​

Explore More Features​

Try Different Configurations​

  • Generate 50-100 queries for comprehensive analysis
  • Test multiple providers to compare citation patterns
  • Focus on competitor brands to benchmark visibility
  • Test your own brand to measure current AEO performance

Systematic Testing​

Create a testing schedule:

Weekly: Generate and execute 20-50 queries in your industry Monthly: Compare trends over time Quarterly: Comprehensive competitor analysis (100+ queries)

Common First-Time Issues​

No Citations Extracted​

Problem: Execution succeeds but "Total Citations: 0"

Solution:

  • Some providers cite less than others
  • Try Claude or Perplexity (highest citation rates)
  • Use problem-focused queries (how-to, what is, compare)

Query Generation Fails​

Problem: "Failed to generate queries" error

Solution:

  • Verify ANTHROPIC_API_KEY in .env.local
  • Check Claude API dashboard for quota/billing
  • Restart dev server after adding key

Execution Timeout​

Problem: Batch execution hangs or times out

Solution:

  • Reduce query count to 10-20 for testing
  • Check provider API status
  • Try one provider at a time
  • Ensure stable internet connection

Tips for Best Results​

Query Generation​

✅ Do:

  • Be specific with focus area ("kitchen remodeling" vs "home improvement")
  • Use problem-focused queries (checked by default)
  • Generate 20-50 queries per test
  • Include all personas and journey stages

❌ Don't:

  • Use vague industries ("business" → "SaaS accounting software")
  • Generate 1-5 queries (not enough signal)
  • Skip saving to library (you'll want to re-run later)

Execution​

✅ Do:

  • Start with one provider for testing
  • Run same queries across multiple providers for comparison
  • Use batch mode (much faster than individual queries)
  • Review results before generating new queries

❌ Don't:

  • Execute 100 queries across 4 providers without reviewing costs
  • Run same query set multiple times without analysis
  • Skip the analytics step

Analysis​

✅ Do:

  • Focus on top 5-10 cited domains
  • Click into domain details for specific URLs
  • Look for citation patterns (what types of content get cited)
  • Export data for further analysis

❌ Don't:

  • Focus only on your own domain (learn from competitors)
  • Ignore low-citation queries (opportunity areas!)
  • Skip documenting insights for your team

Success Metrics​

After your first 100 queries, you should be able to answer:

  1. Top 5 domains cited in your industry for problem-solving queries
  2. Content types that get cited most (guides, comparisons, tools)
  3. Citation gaps where few or no sources are cited (opportunities)
  4. Your current position (if testing queries with your brand name)
  5. Provider differences in citation behavior (Claude vs GPT-4 vs others)

Next Steps​

Ready to dive deeper? Continue to:

Need Help?​

Congratulations! You've completed your first AEO/GEO Analytics workflow. 🎉