> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geomaestros.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Weekly Analysis Report
> An AI-powered strategic briefing that turns raw tracking data into prioritized recommendations, market opportunities, and community engagement targets.
The Weekly Analysis Report is your AI-powered strategy briefing. It takes all the tracking data collected over the past week - every AI response, every competitor mention, every citation - and distills it into actionable recommendations, market opportunities, and community engagement targets.
Think of it as your weekly strategy meeting, powered by data.
## Why It Exists
You track dozens (or hundreds) of keywords across multiple AI platforms every week. That produces a mountain of raw data that no human can review manually. The Weekly Analysis does this for you:
* **Finds patterns** across hundreds of AI responses
* **Identifies gaps** where competitors are winning and you are not
* **Discovers new topics** you should be creating content about
* **Surfaces community threads** that AI models are citing as sources
It turns raw tracking data into a prioritized to-do list.
***
## How to Generate a Report
### Navigate to Weekly Analysis
Open your workspace and select **Weekly Analysis** from the sidebar.
### Click Generate Report
The system will begin analyzing all your tracking data from the past week.
### Wait for processing
Report generation typically takes 2-5 minutes depending on data volume.
### Explore your findings
Once complete, click the report to explore recommendations, opportunities, and engagement targets across three tabs.
You need at least 20 tracked AI responses (evidence) from the past 7 days to generate a report. If you have not run enough tracking, the system will let you know what is needed.
***
## Report Header and Summary
At the top of every report, you will see:
| Metric | What It Means |
| ---------------------- | -------------------------------------------------------- |
| **Insights Analyzed** | How many AI responses were processed for wins and losses |
| **Keywords Tracked** | How many of your tracked keywords had data this week |
| **Evidence Collected** | Total AI responses captured across all platforms |
Below these numbers, **Key Findings** gives you a plain-language summary of the most important discoveries.
***
## Tab 1: Recommendations
This is your prioritized action list. The system analyzes all your tracking data, clusters it into themes, and generates specific recommendations with detailed playbooks.
### Recommendation Categories
| Category | What It Covers |
| ------------------------- | --------------------------------------------------------------------------------------- |
| **Content Creation** | Opportunities to create new content that fills gaps - blog posts, guides, landing pages |
| **Competitor Response** | Strategic responses to areas where competitors are consistently winning |
| **Citation Improvement** | Tactics to get your content cited more often in AI responses |
| **Platform Optimization** | Platform-specific optimizations such as improving your Google Business Profile |
### What Each Recommendation Shows
* **Priority badge** - High, Medium, or Low
* **Title** - A specific action to take
* **Description** - Why this matters and what the current problem is
* **Expected Impact** - Concrete projected outcome
* **Related Keywords** - Which tracked keywords this recommendation addresses
* **Suggested Action Plan** - Expand any recommendation to reveal a step-by-step implementation playbook
### Tracking Your Progress
Use the status dropdown on each recommendation to track implementation:
* **To Do** - Have not started yet (default)
* **In Progress** - Currently working on it
* **Completed** - Done (records the completion date)
* **Dismissed** - Not relevant or not worth pursuing
Treat recommendations as a shared task board for your team. Update statuses as you work through them so everyone can see progress at a glance.
***
## Tab 2: Semantic Opportunities
This tab answers the question: **"What topics should I be competing on?"**
It analyzes the competitive landscape across all your tracked prompts and identifies topic clusters where there is an opportunity to gain visibility.
### The Opportunity Score (0-100)
Each opportunity gets a composite score based on four factors. A higher score means a bigger opportunity with more room to grow.
| Factor | Weight | What It Measures |
| ------------------------- | ------ | --------------------------------------------------------------------------- |
| **Win Gap** | 40% | How much room you have to improve. Lower current win rate = higher score |
| **Saturation** | 30% | How uncrowded the topic is. Fewer competitors = higher score |
| **Search Demand** | 20% | Whether people actually search for this topic. Higher demand = higher score |
| **Competitive Intensity** | 10% | Whether competition validates demand. The sweet spot is 3-6 competitors |
### Score Ranges
| Score | Assessment |
| ------------ | ---------------------------------------------------------------- |
| **80+** | Exceptional opportunity - High gap, low competition, good demand |
| **60-79** | Strong opportunity - Worth pursuing actively |
| **40-59** | Moderate opportunity - Consider based on available resources |
| **Below 40** | Low priority - Probably not worth the effort right now |
### Priority Categories
Every opportunity is classified into one of four strategic categories:
| Priority | Opportunity | Competition | Strategy |
| ---------------------------- | ----------- | ------------- | -------------------------------------------- |
| **P1: Fight For It** | High | Low to Medium | Your best bets. Prioritize these |
| **P2: Crowded But Valuable** | High | High | Worth pursuing, but expect heavy competition |
| **P3: Maybe Later** | Low | Low to Medium | Park these for when you have spare capacity |
| **P4: Avoid** | Low | High | Low reward, high effort. Skip for now |
### What Each Opportunity Card Shows
* **Main Topic** - The core theme
* **Opportunity Score** - Color-coded badge
* **Priority and Saturation badges** - Quick classification at a glance
* **Your Coverage vs. Competitor Coverage** - Side-by-side comparison
* **Win Rate** - Your wins divided by total queries for this topic
* **Unique Competitors** - How many different brands are competing
* **Related Subtopics** - Specific keywords within this theme
* **Top Competitors** - Names and mention counts of the biggest players
Switch between **Grid View** for detailed cards and **Market Battlefield View** for a visual scatter plot showing where all your opportunities cluster across competition and opportunity dimensions.
***
## Tab 3: Conversation Opportunities
This tab answers the question: **"Where are AI models getting their information, and can I influence those sources?"**
When AI platforms answer a query, they sometimes cite community threads from Reddit, Quora, and other platforms. If your brand engages in those threads, future AI responses may include your perspective.
### Summary Dashboard
| Stat | What It Means |
| ----------------------- | ------------------------------------------------------------------------ |
| **Threads Cited by AI** | Total community threads that AI models are referencing for your keywords |
| **Unreviewed** | New threads you have not looked at yet |
| **Acted On** | Threads where you have already engaged |
| **Avg. Relevance** | Average relevance score across all discovered threads |
### Relevance Score (0-100)
Each thread gets a relevance score based on three factors:
| Factor | Weight | What It Measures |
| ---------------------- | ------ | ------------------------------------------------------- |
| **Citation Count** | 40% | How many times AI models cited this thread |
| **Platform Diversity** | 30% | How many different AI platforms cite it |
| **Keyword Coverage** | 30% | How many of your tracked keywords triggered this thread |
**Score thresholds:**
* **70+** (green) - Highly relevant, prioritize engagement
* **50-69** (blue) - Worth reviewing
* **30-49** (amber) - Moderate relevance
* **Below 30** (gray) - Low priority
### What Each Thread Shows
At a glance, you see the relevance score, thread title, platform, freshness indicator, engagement potential rating, and citation count.
Expand any thread to see:
* The exact text that AI models extracted
* Which of your tracked keywords triggered this citation
* Which AI platforms are citing it
* A specific, platform-appropriate engagement suggestion
* A direct link to open the thread and engage
### Tracking Your Engagement
Each thread follows a workflow:
1. **New** - Just discovered
2. **Reviewed** - You have evaluated it
3. **In Progress** - You are working on engaging
4. **Acted On** - You have posted or responded
5. **Ignored** - Not relevant to your strategy
You can update statuses individually or use bulk actions to manage multiple threads at once.
***
## How the Three Tabs Work Together
The three tabs form a complete strategy cycle:
1. Check **Semantic Opportunities** to understand the competitive landscape
2. Review **Recommendations** for specific action items aligned with those opportunities
3. Browse **Conversation Opportunities** to find quick wins - threads where engaging today could influence AI responses tomorrow
4. Track progress using status dropdowns across all three tabs
Reports require at least 20 pieces of evidence from the past 7 days. If your tracking runs have not collected enough data yet, continue running tracking and try generating a report in a few days.