> ## Documentation Index
> Fetch the complete documentation index at: https://developers.scrunch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Competitive Intelligence

> MCP prompts to rank competitors by AI share of voice, identify where rivals are displacing your brand, and surface positions you need to protect in AI search.

These prompts compare \[brand name] against every tracked competitor — from a full share of voice ranking to a detailed head-to-head on the specific prompts you're losing.

***

<AccordionGroup>
  <Accordion title="Rank Competitors by Share of Voice">
    Which competitors appear most often across \[brand name]'s tracked prompts — and how dominant are they?

    ```text theme={null}
    For [brand name], first list all configured competitors to get their IDs. Then for each competitor, pull the count of variants where competitor_present = [competitor ID].

    Build a competitor presence ranking: which competitors appear most frequently in AI responses across [brand name]'s tracked prompts? Calculate each competitor's presence rate vs. total variants. Rank them. Flag any competitor appearing in more than 30% of prompts — that's a dominant player worth analyzing further.
    ```
  </Accordion>

  <Accordion title="See Where a Competitor Is Beating You">
    The specific prompts where \[competitor name] shows up and \[brand name] doesn't — direct displacement, ranked by observation count.

    ```text theme={null}
    For [brand name], get the competitor ID for [competitor name] from the competitors list. Then pull variants filtered to:
    - competitor_present = [competitor ID]
    - brand_present = false

    Limit to 50 results. This shows prompts where [competitor name] appears in AI responses but [brand name] does not.

    For this set:
    1. What topics or categories are these? Tag/topic breakdown
    2. Are these branded or unbranded queries?
    3. What is [competitor name] likely doing well that [brand name] isn't for these queries?
    4. Which of these represent the most valuable queries to reclaim — highest observation count, most commercially relevant topics?
    ```
  </Accordion>

  <Accordion title="Build a Full Competitive Displacement Map">
    For every competitor: how many prompts do they win outright vs. share with \[brand name]?

    ```text theme={null}
    For [brand name], list all competitors and get their IDs. For each competitor, run two counts:
    1. competitor_present = true, brand_present = false → competitor wins, brand loses
    2. competitor_present = true, brand_present = true → both appear (co-mentions)

    Build a displacement table showing for each competitor: how many prompts they win outright vs. share. Rank competitors by displacement rate. The top competitors are actively taking visibility that [brand name] should own.
    ```
  </Accordion>

  <Accordion title="Find Your Defensible Positions">
    The prompts where \[brand name] appears and top competitors don't — the territory to protect and expand.

    ```text theme={null}
    For [brand name], pull variants where brand_present = true. Within this set, identify which prompts are non-branded (branded = false) — these are category queries where [brand name] is earning unprompted AI visibility.

    Separately, for the top 3 competitors by presence rate, check their presence on the same prompts using competitor_present filter. Identify prompts where [brand name] appears and those competitors do not — these are [brand name]'s defensible positions.
    ```
  </Accordion>
</AccordionGroup>

***

<CardGroup cols={2}>
  <Card title="Competitor Share of Voice, Ranked" icon="trophy" href="/mcp/workflows/competitor-share-of-voice">
    Full workflow: complete SOV ranking with displacement map and optional Slack post.
  </Card>

  <Card title="Citation Analysis" icon="link" href="/mcp/prompts/citation-analysis">
    See which competitor pages AI is citing — and which of yours aren't getting cited.
  </Card>
</CardGroup>
