> ## 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 prompts across multiple AI platforms. 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

<Steps>
  ### Navigate to Weekly Analysis

  Open your workspace and select **Reports** in the sidebar, then **Weekly Analysis**.

  ### 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 conversations, opportunities and action items across four tabs. The report opens on the Conversations tab.
</Steps>

<Note>
  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.
</Note>

***

## 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 prompts had data this week      |
| **Evidence Collected** | Total AI responses captured across all platforms         |
| **Total Cost**         | What this report cost to generate                        |

Below these numbers, **Key Findings** gives you a plain-language summary of the most important discoveries.

An **Export CSV** button in the header downloads every recommendation in the report as a spreadsheet.

***

## Tab 1: Conversations

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 prompts |
| **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 prompts 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 prompts 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. **Unreviewed** - 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
6. **Archived** - Closed out and hidden from the default view

You can update statuses individually or use bulk actions to manage multiple threads at once.

***

## Tab 2: LinkedIn article

Each report picks the single strongest finding of the week and turns it into a LinkedIn article
you can edit and publish.

The tab scores every candidate, action plan recommendations, semantic opportunities and
conversation opportunities, and surfaces the one with the highest score, along with why it
scored highest, the grounding facts behind it, the named entities to include, and the pages on
your own site the article should link to.

From there you can:

* **Generate draft**, write a first draft from that finding, then edit it inline
* **Regenerate**, start the draft again if the angle is not right
* **Save**, then **Mark approved**, then **Mark as published** with the published URL
* Watch **T+14** and **T+60 citations** to see whether AI engines started citing the article

Every article ever drafted for the workspace is listed underneath, newest first.

<Note>
  Some weeks there is no article. If the recommender does not find a finding strong enough to
  ground one, the tab says so and tries again next week.
</Note>

***

## Tab 3: 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 prompts within this theme
* **Top Competitors** - Names and mention counts of the biggest players

<Tip>
  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.
</Tip>

***

## Tab 4: Action Plan

This is your prioritized action list. The system analyzes all your tracking data, clusters it into themes, and generates specific recommendations with detailed playbooks.

Recommendations in the Conversation Engagement category are not shown here, they appear inline on the threads they apply to, over on the Conversations tab.

### 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                       |
| **Conversation Engagement** | Community threads (Reddit, Quora, forums) that AI cites, where posting could improve your visibility |

### 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 prompts this recommendation addresses (shown as a "Keywords:" chip)
* **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

<Tip>
  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.
</Tip>

***

## How the Four Tabs Work Together

The tabs form a complete strategy cycle:

1. Start on **Conversations**, it opens by default, to find threads where engaging today could influence AI answers tomorrow
2. Check **Semantic Opportunities** to understand the wider competitive landscape
3. Work the **Action Plan** for specific action items aligned with those opportunities
4. Use the **LinkedIn article** tab to turn the strongest finding of the week into published content
5. Track progress using the status dropdowns, which are shared across the tabs

<Warning>
  Reports require at least 20 pieces of evidence from the past 7 days. If your tracking runs have not collected enough data yet, run more tracking and try generating a report in a few days.
</Warning>
