> ## 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 Battlecard Generator

> Build a per-competitor AI visibility battlecard covering wins, gaps, and talking points, saved to Notion or Google Docs for sales enablement.

Sales teams already have product battlecards. This workflow builds the AI-visibility equivalent: where a specific competitor is winning the AI-answer conversation, where you're winning it, and what that means for how a rep should talk about the competitive landscape.

<Info>
  **Tools used in this workflow**

  | Tool                          | Required?             | Used for                                          |
  | ----------------------------- | --------------------- | ------------------------------------------------- |
  | Scrunch MCP                   | Required              | Competitive presence, position, and citation data |
  | Notion MCP or Google Docs MCP | Required (choose one) | Saving the battlecard for sales to reference      |
</Info>

***

<Tabs>
  <Tab title="Notion">
    Replace the bracketed values, then paste the whole thing into Claude.

    ```text theme={null}
    For [brand name] in Scrunch, build a battlecard against [competitor name] and save it to Notion.

    Step 1 — Get the competitive picture:
    Get the competitor ID for [competitor name]. Pull presence and position metrics for both [brand name] and [competitor name] over the last 30 days.

    Where they're winning: pull prompt variants filtered to competitor_present = [competitor name]'s ID and brand_present = false. Sort by observation count. Take the top 5.

    Where we're winning: pull prompt variants filtered to brand_present = true and competitor_present = false (for this competitor). Sort by observation count. Take the top 5.

    Check sentiment for both brands over the same period.

    Step 2 — Build the battlecard in Notion:
    Create a page titled "[brand name] vs. [competitor name] — AI Visibility Battlecard" with:
    - **Overall standing**: presence rate and rank for both brands
    - **Where they're winning**: the 5 prompts from Step 1, with a one-line note on what to say if this comes up ("We're not currently cited on this specific question, but our strength is...")
    - **Where we're winning**: the 5 prompts from Step 1, framed as proof points a rep can cite directly
    - **Sentiment comparison**: how each brand is described when mentioned
    - **Talking point summary**: 2-3 sentences a rep can use verbatim when a prospect brings up this competitor

    Step 3 — Confirm:
    Give me the Notion page link and the one most important talking point from it.
    ```

    **What you get:** A Notion battlecard with concrete, sourced examples on both sides of the competitive comparison — not just "we're ahead" or "they're ahead," but the specific prompts and platforms behind that claim.
  </Tab>

  <Tab title="Google Docs">
    Replace the bracketed values, then paste the whole thing into Claude.

    ```text theme={null}
    For [brand name] in Scrunch, build a battlecard against [competitor name] and save it to Google Docs.

    Step 1 — Get the competitive picture:
    Get the competitor ID for [competitor name]. Pull presence and position metrics for both [brand name] and [competitor name] over the last 30 days.

    Where they're winning: pull prompt variants filtered to competitor_present = [competitor name]'s ID and brand_present = false. Sort by observation count. Take the top 5.

    Where we're winning: pull prompt variants filtered to brand_present = true and competitor_present = false (for this competitor). Sort by observation count. Take the top 5.

    Check sentiment for both brands over the same period.

    Step 2 — Build the battlecard in Google Docs:
    Create a document titled "[brand name] vs. [competitor name] — AI Visibility Battlecard" with:
    - **Overall standing**: presence rate and rank for both brands
    - **Where they're winning**: the 5 prompts from Step 1, with a one-line note on what to say if this comes up ("We're not currently cited on this specific question, but our strength is...")
    - **Where we're winning**: the 5 prompts from Step 1, framed as proof points a rep can cite directly
    - **Sentiment comparison**: how each brand is described when mentioned
    - **Talking point summary**: 2-3 sentences a rep can use verbatim when a prospect brings up this competitor

    Step 3 — Confirm:
    Give me the Google Docs link and the one most important talking point from it.
    ```

    **What you get:** A Google Docs battlecard with concrete, sourced examples on both sides of the competitive comparison — not just "we're ahead" or "they're ahead," but the specific prompts and platforms behind that claim.
  </Tab>
</Tabs>

***

## Tips

<AccordionGroup>
  <Accordion title="Building a battlecard for every tracked competitor">
    Run this once per competitor rather than trying to cover all of them in one document — a battlecard that's specific to one rival is more usable in the moment than a single sprawling document covering five.
  </Accordion>

  <Accordion title="Keeping battlecards current">
    Re-run this quarterly, or immediately after a Competitor Share of Voice report shows a meaningful rank change against that specific competitor. A battlecard with 6-month-old data is worse than no battlecard — reps will repeat stale claims.
  </Accordion>

  <Accordion title="What to do when you're behind on every dimension">
    If a competitor is winning on presence, position, and sentiment, don't force a "where we're winning" section that isn't true — say so directly and reframe the talking points around differentiation that isn't visibility-based (pricing, service, specific features) instead.
  </Accordion>

  <Accordion title="Sharing this outside the sales team">
    The same structure works as an input to the content team — "where they're winning" is effectively a prioritized content gap list specific to one competitor, and pairs directly with the Content Brief Handoff to Design workflow.
  </Accordion>
</AccordionGroup>

***

<CardGroup cols={2}>
  <Card title="Competitor Share of Voice, Ranked" icon="chart-bar" href="/mcp/workflows/competitor-share-of-voice">
    Run this first to decide which competitor deserves a battlecard.
  </Card>

  <Card title="Live Competitor Tracker Spreadsheet" icon="table" href="/mcp/workflows/competitor-tracker-spreadsheet">
    Track the underlying numbers over time instead of a point-in-time battlecard.
  </Card>
</CardGroup>
