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:
- [Competitor A] — AIGVR: [XX] | SoM: [%]
- [Your Brand] — AIGVR: [XX] | SoM: [%] ← YOU
- [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:
- What drove biggest positive change?
- What is most significant risk/threat?
- What content/technical change had most impact?
- 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]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━