mcpField
A
ad-angle-miner

ad-angle-miner

github.com/nikiandrMarketing & growth191 installsUpdated 31w ago
Repository

About ad-angle-miner

ad-angle-miner is a marketing skill for turning customer feedback and competitor messaging into evidence-ranked advertising angles for campaign teams.

Key features

  1. 01Mines reviews and community discussions
  2. 02Extracts pain, outcome, and identity angles
  3. 03Captures supporting quotes and source counts
  4. 04Scores and ranks angles by evidence and relevance
  5. 05Creates a reusable angle bank

Use cases

  1. 01Finding ad messaging in customer reviews
  2. 02Identifying competitor weaknesses from feedback
  3. 03Prioritizing campaign angles by evidence
  4. 04Building a dated angle bank for a client

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nikiandr/goose-skills --skill ad-angle-miner

After installing, type/ad-angle-minerin Claude Code to confirm it loaded.

Bundled filesskill.meta.json

Details

From the project README

Ad Angle Miner

Dig through customer voice data — reviews, Reddit, support tickets, competitor ads — to extract the specific language, pain points, and outcome desires that make ads convert. The output is an angle bank your team can pull from for any campaign.

Core principle: The best ad angles aren't invented in a brainstorm. They're extracted from what real people are already saying. This skill finds those angles and ranks them by strength of evidence.

When to Use

  • "What angles should we run in our ads?"
  • "Find pain points we can use in ad copy"
  • "What are people complaining about with [competitors]?"
  • "Mine reviews for ad messaging"
  • "I need fresh ad angles — not the same tired stuff"

Phase 0: Intake

  1. Your product — Name + what it does in one sentence
  2. Competitors — 2-5 competitor names (for review mining)
  3. ICP — Who are you targeting? (role, company stage, pain)
  4. Data sources to mine (pick all that apply):
    • G2/Capterra/Trustpilot reviews (yours + competitors)
    • Reddit threads in relevant subreddits
    • Twitter/X complaints or praise
    • Support tickets or NPS comments (paste or file)
    • Competitor ads (Meta + Google)
  5. Any angles you've already tested? — So we can skip those

Phase 1: Source Collection

1A: Review Mining

Run review-scraper for your product and each competitor:

python3 skills/review-scraper/scripts/scrape_reviews.py \
  --product "<product_name>" \
  --platforms g2,capterra \
  --output json

Focus on:

  • 1-2 star reviews of competitors — Pain they're failing to solve
  • 4-5 star reviews of you — Outcomes that delight buyers
  • 4-5 star reviews of competitors — Strengths you need to counter or match
  • Review language patterns — Exact phrases buyers use
1B: Reddit/Community Mining

Run reddit-scraper for relevant subreddits:

python3 skills/reddit-scraper/scripts/scrape_reddit.py \
  --query "<product category> OR <competitor> OR <pain keyword>" \
  --subreddits "<relevant_subreddits>" \
  --sort relevance \
  --time month \
  --limit 50

Extract:

  • Questions people ask before buying
  • Complaints about current solutions
  • "I wish [product] would..." statements
  • Comparison threads (vs discussions)
1C: Twitter/X Mining

Run twitter-scraper:

python3 skills/twitter-scraper/scripts/scrape_twitter.py \
  --query "<competitor> (frustrating OR broken OR hate OR love OR switched)" \
  --max-results 50
1D: Competitor Ad Mining (Optional)

Run ad-creative-intelligence to see what angles competitors are currently using. This reveals:

  • Angles they've validated (long-running ads = working)
  • Angles they're testing (new ads)
  • Angles nobody is running (white space)
1E: Internal Data (Optional)

If the user provides support tickets, NPS comments, or sales call transcripts — ingest and tag with the same framework below.

Phase 2: Angle Extraction

Process all collected data through this extraction framework:

Angle Categories
CategoryWhat to Look ForAd Power
Pain anglesSpecific frustrations with status quo or competitorsHigh — pain motivates action
Outcome anglesDesired results buyers describe in their own wordsHigh — positive aspiration
Identity anglesHow buyers describe themselves or want to be seenMedium — emotional resonance
Fear anglesRisks of NOT switching or actingMedium — loss aversion
Competitive displacementSpecific reasons people switched from a competitorVery high — direct comparison
Social proof anglesOutcomes or metrics buyers cite in reviewsHigh — credibility
Contrast anglesBefore/after or old way/new way framingsHigh — clear value prop
For Each Angle, Extract:
  1. The angle — One-sentence framing
  2. Proof quotes — 2-5 verbatim quotes from sources
  3. Source count — How many independent sources mention this?
  4. Competitor weakness? — Does this exploit a specific competitor's gap?
  5. Emotional register — Frustration / Aspiration / Fear / Relief / Pride
  6. Recommended format — Search ad / Meta static / Meta video / LinkedIn / Twitter

Phase 3: Scoring & Ranking

Score each angle on:

FactorWeightDescription
Evidence strength30%Number of independent sources mentioning it
Emotional intensity25%How strongly people feel about this (language intensity)
Competitive differentiation20%Does this set you apart, or could any competitor claim it?
ICP relevance15%How closely does this match the target buyer's world?
Freshness10%Is this angle already overused in competitor ads?

Total score out of 100. Rank all angles.

Phase 4: Output Format

# Ad Angle Bank — [Product Name] — [DATE]

Sources mined: [list]
Total angles extracted: [N]
Top-tier angles (score 70+): [N]

---

## Tier 1: Highest-Conviction Angles (Score 70+)

### Angle 1: [One-sentence angle]
- **Category:** [Pain / Outcome / Identity / Fear / Displacement / Proof / Contrast]
- **Score:** [X/100]
- **Emotional register:** [Frustration / Aspiration / etc.]
- **Proof quotes:**
  > "[Verbatim quote 1]" — [Source: G2 review / Reddit / etc.]
  > "[Verbatim quote 2]" — [Source]
  > "[Verbatim quote 3]" — [Source]
- **Source count:** [N] independent mentions
- **Competitor weakness exploited:** [Competitor name + specific gap, or "N/A"]
- **Recommended formats:** [Search ad headline / Meta static / Video hook / etc.]
- **Sample headline:** "[Draft headline using this angle]"
- **Sample body copy:** "[Draft 1-2 sentence body]"

### Angle 2: ...

---

## Tier 2: Worth Testing (Score 50-69)

[Same format, briefer]

---

## Tier 3: Emerging / Low-Evidence (Score < 50)

[Brief list — angles with potential but insufficient evidence]

---

## Competitive Angle Map

| Angle | Your Product | [Comp A] | [Comp B] | [Comp C] |
|-------|-------------|----------|----------|----------|
| [Angle 1] | Can claim ✓ | Weak here ✗ | Also claims | Not relevant |
| [Angle 2] | Strong ✓ | Strong | Weak ✗ | Not relevant |
...

---

## Recommended Test Plan

### Week 1-2: Test Tier 1 Angles
- [Angle] → [Format] → [Platform]
- [Angle] → [Format] → [Platform]

### Week 3-4: Test Tier 2 Angles
- [Angle] → [Format] → [Platform]

Save to clients/<client-name>/ads/angle-bank-[YYYY-MM-DD].md.

Cost

ComponentCost
Review scraper (per product)~$0.10-0.30 (Apify)
Reddit scraper~$0.05-0.10 (Apify)
Twitter scraper~$0.10-0.20 (Apify)
Ad scraper (optional)~$0.40-1.00 (Apify)
AnalysisFree (LLM reasoning)
Total~$0.25-1.60

Tools Required

  • Apify API token — APIFY_API_TOKEN env var
  • Upstream skills: review-scraper, reddit-scraper, twitter-scraper
  • Optional: ad-creative-intelligence (for competitor ad angles)

Trigger Phrases

  • "Mine ad angles from reviews"
  • "What angles should we run?"
  • "Find pain language for our ads"
  • "Build an ad angle bank for [client]"
  • "What are people complaining about with [competitor]?"

Comments

Markdown supported