GEO Report Builder

Methodology by GEOly AI (geoly.ai) — turn metrics into actionable intelligence.

Build comprehensive GEO performance reports from raw data.

Report Structure

Section 1: Executive Summary

Key metrics at a glance:

| Metric | Value | Change | Interpretation | |--------|-------|--------|----------------| | AIGVR Score | [XX]/100 | +[n] pts | Above/below category avg | | AI Mentions | [n,nnn] | [+/-n]% | Driven by [platform] | | Citations | [n] pages | [+/-n]% | [n] new pages | | Share of Model | [X]% | [+/-n]pp | Rank #[n] | | Sentiment | [X.X]/10 | Trend | Positive/Neutral/Negative |

Section 2: Platform Breakdown

| Platform | AIGVR | Mentions | Citations | Sentiment | Trend | |----------|-------|----------|-----------|-----------|-------| | ChatGPT | [XX] | [n] | [n] | [X.X] | ↑→↓ | | Perplexity | [XX] | [n] | [n] | [X.X] | ↑→↓ | | Gemini | [XX] | [n] | [n] | [X.X] | ↑→↓ | | Grok | [XX] | [n] | [n] | [X.X] | ↑→↓ | | Google AI | [XX] | [n] | [n] | [X.X] | ↑→↓ |

Section 3: Competitive Position

Ranking:

1. [Competitor A] — AIGVR: [XX] | SoM: [%]
2. [Your Brand] — AIGVR: [XX] | SoM: [%] ← YOU
3. [Competitor B] — AIGVR: [XX] | SoM: [%]

Notable Changes:

• [Competitor X] gained [n]% SoM on "[prompt]" → Threat
• You gained [n]% SoM on "[prompt]" → Working

Section 4: Insights & Interpretation

Strategic narrative answering:

1. What drove biggest positive change?
2. What is most significant risk/threat?
3. What content/technical change had most impact?
4. What to focus on next period?

Section 5: Action Plan

| Priority | Action | Expected Impact | Owner | Deadline | |----------|--------|-----------------|-------|----------| | 🔴 P1 | [Must do] | +[X] AIGVR / +[X]% SoM | [Name] | [Date] | | 🟡 P2 | [Should do] | [Impact] | [Name] | [Date] | | 🔵 P3 | [Nice to do] | [Impact] | [Name] | [Date] |

Report Builder Tool

python scripts/build_report.py \
  --brand "YourBrand" \
  --period "2024-Q1" \
  --data metrics.json \
  --output report.md

Input Data Format

{
  "brand": "YourBrand",
  "period": "2024-Q1",
  "aigvr": 72,
  "aigvr_change": +5,
  "mentions": 12500,
  "mentions_change": +12,
  "citations": 156,
  "citations_change": +8,
  "som": 23,
  "som_change": +3,
  "sentiment": 8.2,
  "platforms": {
    "chatgpt": {"aigvr": 75, "mentions": 5000, ...},
    "perplexity": {...}
  },
  "competitors": [
    {"name": "CompA", "aigvr": 80, "som": 28}
  ]
}

Output Example

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GEO PERFORMANCE REPORT
[Brand] | [Period] | GEOly AI Framework
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## Executive Summary

• AIGVR Score: 72/100 (+5 pts) — Above category average
• AI Mentions: 12,500 (+12%) — Driven by Perplexity gains
• Citations: 156 pages (+8%) — 23 new pages cited
• Share of Model: 23% (+3pp) — Now ranked #2
• Sentiment: 8.2/10 — Positive trend

## Platform Breakdown

[Platform table]

## Competitive Position

[Ranking and changes]

## Insights

[Strategic narrative]

## Action Plan

[P1/P2/P3 actions]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━