# B2B Competitor Teardown — AI Battlecard Generator (`noniner/b2b-competitor-teardown`) Actor

Give a competitor domain; get a full AI battlecard — positioning, tech stack, pricing, recent moves, strengths, weaknesses and exactly how to win against them.

- **URL**: https://apify.com/noniner/b2b-competitor-teardown.md
- **Developed by:** [Fredrik Hansson](https://apify.com/noniner) (community)
- **Categories:** AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $300.00 / 1,000 competitor teardowns

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## B2B Competitor Teardown — AI Battlecard Generator

**Give it a competitor's domain. Get back a finished, one-page sales battlecard** — how they position themselves, their tech stack, their pricing, their recent moves, their strengths and weaknesses, and exactly how to win against them. It orchestrates four research Actors and lets an AI assemble the teardown, so you skip the manual competitive-intelligence grind and go straight to the talk track.

You bring the competitor. It hands back a battlecard your reps can paste into the CRM.

***

### The flow

```
   competitor domain                    4 research organs                    AI battlecard
  (e.g. notion.so)      →      firmographics · tech stack ·        →      positioning · strengths ·
                               pricing · recent news                      weaknesses · how to win ·
                                                                          objections · landmines
```

1. **Paste competitor domains** into `domains` (one per line).
2. **Tell it what you sell** in `yourOffering` (recommended) so "how to win", objection handling and landmine questions are framed to beat them on your behalf.
3. **Run it.** Each competitor comes back as a structured record *and* a ready-to-paste `battlecardMarkdown` doc.

***

### What you get per competitor

1. **`oneLineSummary`** — the whole competitor in one punchy sentence.
2. **`positioning`** — how *they* position themselves (their own message).
3. **`whatTheyDo`** / **`targetCustomers`** — the factual core, grounded in firmographic data.
4. **`techStackSummary`** — what they run (from the tech organ), or `null` if unknown.
5. **`pricingSummary`** — their published pricing and plans (from the pricing organ), or `null`.
6. **`strengths`** / **`weaknesses`** — concrete, evidence-based bullets.
7. **`recentMoves`** — recent headlines about them (launches, funding, pivots), `[]` if none.
8. **`differentiators`** — what sets them apart in their market.
9. **`howToWin`** — concrete talking points to beat them, framed vs *your* offering.
10. **`objectionHandling`** — likely pro-competitor objections, each with a crisp rebuttal.
11. **`landminesToSet`** — sharp discovery questions that expose their weaknesses.
12. **`battlecardMarkdown`** — the whole thing assembled as a clean one-page markdown doc, ready for a CRM, Slack or your sales wiki.

Every statement is grounded only in what the research organs actually returned — the AI never invents pricing, customers or news.

***

### Three ways people use it

- **Sales battlecards / win rate** — arm every AE with a "competitor teardown" and a tested talk track for "how to beat <competitor>". Objection handling and landmine discovery questions turn a competitive deal into a winnable one.
- **Product & strategy competitive analysis** — track how rivals position themselves, what they charge, which tech they run and what they just shipped. Market positioning on one page, refreshed on demand.
- **Competitive intelligence at scale** — feed a whole list of competitors and get a battlecard for each in one run, indexed by domain, ready to drop into your CRM or enablement hub.

***

### How the orchestration works

This is a super-actor: it runs four specialist Actors as "organs" (best-effort — if one returns nothing, the teardown degrades gracefully and still ships), then an OpenAI model synthesizes the battlecard from whatever came back.

| Organ | Actor (via `Actor.call`) | What it contributes |
|---|---|---|
| Firmographics | [`noniner/ai-company-enrichment`](https://apify.com/noniner/ai-company-enrichment) | What they do, target customers, industry, size |
| Technographics | [`noniner/b2b-tech-stack-detector`](https://apify.com/noniner/b2b-tech-stack-detector) | Detected technology stack |
| Pricing | [`noniner/b2b-pricing-extractor`](https://apify.com/noniner/b2b-pricing-extractor) | Published pricing and plans |
| Recent moves | [`noniner/google-news-scraper`](https://apify.com/noniner/google-news-scraper) | Recent headlines about the competitor |

Each organ runs **once across all domains** and its results are indexed by domain, so a 25-competitor run is just a handful of sub-runs, not 100.

***

### Input

| Field | Type | Notes |
|---|---|---|
| `domains` | array | **Required.** Competitor domains, website URLs or emails (domain is extracted). One per line. |
| `yourOffering` | string | **Recommended.** What YOU sell — frames `howToWin`, `objectionHandling` and `landminesToSet` to beat each competitor. |
| `maxResults` | integer | Max competitors to tear down. Default `25`, max `500`. One charge per competitor. |
| `maxConcurrency` | integer | Competitors synthesized in parallel in the AI stage. Default `3`, max `8`. |
| `model` | string | OpenAI model. Default `gpt-4o-mini`. |
| `useEnrichment` | boolean | Use the firmographic organ. Default `true`. |
| `useTechStack` | boolean | Use the technographic organ. Default `true`. |
| `usePricing` | boolean | Use the pricing organ. Default `true`. |
| `useNews` | boolean | Use the recent-news organ. Default `true`. |

#### Minimal input example

```json
{
  "domains": ["notion.so", "asana.com"],
  "yourOffering": "We sell a project management tool built for engineering teams."
}
```

***

### Output example

```json
{
  "domain": "notion.so",
  "companyName": "Notion",
  "oneLineSummary": "An all-in-one connected workspace for notes, docs, wikis and lightweight project management, aimed at teams that want flexibility over structure.",
  "positioning": "Positions itself as the single flexible workspace that replaces a stack of separate tools, emphasizing customizable building blocks over rigid, purpose-built software.",
  "targetCustomers": "Startups, product and knowledge-work teams, and individuals who want a highly customizable workspace.",
  "whatTheyDo": "Provides a block-based workspace combining docs, wikis, databases and basic project views.",
  "techStackSummary": "Runs a modern web stack with its own real-time collaboration layer.",
  "pricingSummary": null,
  "strengths": [
    "Extremely flexible, customizable building blocks",
    "Strong brand and bottom-up adoption among startups",
    "One tool spanning docs, wikis and light project tracking"
  ],
  "weaknesses": [
    "Flexibility means teams must build their own structure",
    "Not a dedicated engineering project tool (no sprints, boards tuned for dev)",
    "Can get slow and messy at scale"
  ],
  "recentMoves": [],
  "differentiators": ["All-in-one workspace rather than a single-purpose PM tool"],
  "howToWin": [
    "Lead with purpose-built engineering workflows (sprints, cycles, dependencies) vs blank-canvas setup",
    "Show time-to-value: structured out of the box vs 'build it yourself' in Notion",
    "Target teams frustrated that Notion slows down as their project data grows"
  ],
  "objectionHandling": [
    {
      "objection": "We already run everything in Notion.",
      "response": "Keep Notion for docs — we plug into it and give engineering the structured sprint and dependency tracking Notion isn't built for."
    }
  ],
  "landminesToSet": [
    "Ask how long it took to set up and maintain their project structure in Notion.",
    "Ask what happens to performance once a database has thousands of rows."
  ],
  "battlecardMarkdown": "# Battlecard — Notion\n**Domain:** notion.so\n\n> An all-in-one connected workspace...\n\n## How they position themselves\nPositions itself as the single flexible workspace...\n\n## Strengths\n- Extremely flexible building blocks\n...\n## How to win against them\n- Lead with purpose-built engineering workflows\n...",
  "sourcesUsed": ["ai-company-enrichment", "b2b-tech-stack-detector"]
}
```

`techStackSummary` / `pricingSummary` are `null` when that organ returns no data; `recentMoves` is `[]` when no news is found. `sourcesUsed` always reflects which organs actually contributed.

***

### Pay-per-event pricing

| Event | Price | Charged when |
|---|---|---|
| `competitor-teardown` | **$0.30** | Once per competitor successfully analyzed into a battlecard. |

One charge bundles up to **four orchestrated sub-actor runs** (firmographics, tech stack, pricing, recent news) **plus the OpenAI synthesis** into a finished one-page battlecard. The Actor logs its OpenAI token usage and estimated AI cost per competitor at the end of every run, so the event price always stays safely above the model cost.

***

### Setup

The AI layer calls the OpenAI API. Set the environment variable / secret **`OPENAI_API_KEY`** on the Actor. It's required — without it the run stops before synthesis. The orchestrated organs run under your Apify account.

***

### Use it from an AI agent (Apify MCP server)

This Actor is available through the [Apify MCP server](https://mcp.apify.com), so AI agents (Claude, ChatGPT, or anything that speaks MCP) can call it as a tool — hand it `domains` and `yourOffering`, and read back a full battlecard per competitor — with no custom integration code.

***

### Run it locally

```bash
npm install
## put your input in storage/key_value_stores/default/INPUT.json
export OPENAI_API_KEY=sk-...   # required for the AI battlecard
apify run -p
```

***

### Related actors

- [B2B Pricing Extractor](https://apify.com/noniner/b2b-pricing-extractor) — Pull a competitor's published pricing, plans and tiers from their site.
- [B2B Competitor Monitor](https://apify.com/noniner/b2b-competitor-monitor) — Watch competitors for changes to pricing, messaging and product over time.
- [B2B Tech Stack Detector](https://apify.com/noniner/b2b-tech-stack-detector) — Detect the technology stack and buying signals behind any domain.
- [B2B Intent Radar](https://apify.com/noniner/b2b-intent-radar) — Surface in-market buying intent signals for your target accounts.

***

Built by the No Niner team.

# Actor input Schema

## `domains` (type: `array`):

Competitor domains, website URLs or emails (the domain is extracted). One per line — these are the competitors you want torn down.

## `datasetId` (type: `string`):

Optional. Read the domains from a previous Actor run's dataset — for no-code chaining via the Integrations tab.

## `datasetField` (type: `string`):

Which dataset field holds the domain/URL. Leave blank to auto-detect (domain, website, companyDomain, url, companyUrl).

## `yourOffering` (type: `string`):

Describe YOUR product. If set, the 'how to win' talking points, objection handling and landmine questions are framed to beat each competitor relative to your offering.

## `maxResults` (type: `integer`):

Max competitors to tear down. One pay-per-event charge per competitor analyzed.

## `maxConcurrency` (type: `integer`):

How many competitors to synthesize in parallel in the AI battlecard stage.

## `model` (type: `string`):

Override the model (default gpt-4o-mini).

## `useEnrichment` (type: `boolean`):

Call noniner/ai-company-enrichment for firmographics (what they do, target customers, size).

## `useTechStack` (type: `boolean`):

Call noniner/b2b-tech-stack-detector for the detected technology stack.

## `usePricing` (type: `boolean`):

Call noniner/b2b-pricing-extractor for the competitor's published pricing and plans.

## `useNews` (type: `boolean`):

Call noniner/google-news-scraper for recent competitor moves (headlines + snippets).

## Actor input object example

```json
{
  "domains": [
    "notion.so",
    "asana.com"
  ],
  "maxResults": 25,
  "maxConcurrency": 3,
  "model": "gpt-4o-mini",
  "useEnrichment": true,
  "useTechStack": true,
  "usePricing": true,
  "useNews": true
}
```

# Actor output Schema

## `battlecards` (type: `string`):

All competitor battlecards in the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "domains": [
        "notion.so",
        "asana.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("noniner/b2b-competitor-teardown").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "domains": [
        "notion.so",
        "asana.com",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("noniner/b2b-competitor-teardown").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "domains": [
    "notion.so",
    "asana.com"
  ]
}' |
apify call noniner/b2b-competitor-teardown --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,noniner/b2b-competitor-teardown"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/D8hAJEYAv3CwUIYbE/builds/gCAJWdPUsj4yb24Nw/openapi.json