Ad angle miner

Mine the highest-converting ad angles from customer reviews, Reddit complaints, support tickets, and competitor ads.

How to use it

  1. Hit Copy the whole skill.
  2. Claude: ⋯ → Download .md, then Customize → Skills → Add → Upload skill.
    ChatGPT: make a Project and paste it into Instructions.
    Neither? Paste it at the top of a new chat — it works for that chat.
  3. Describe your job in plain words. The AI follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit gooseworks-ai/goose-skills/skills/ads/composites/ad-angle-miner#main ~/.claude/skills/ad-angle-miner

For one project only, change the path to .claude/skills/ad-angle-miner.

Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Show the full text301 lines
ad-angle-miner/SKILL.md301 lines10.3 KBpushed 39d agoRawView on GitHub

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"

Prerequisites

  • Environment variable: APIFY_API_TOKEN — required for review scraping and Reddit scraping
  • GooseWorks or a direct ScrapeCreators key — for structured social comments and ad-library evidence
  • Web search access — for review sources and verification fallbacks

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
    • Social comments on creator, competitor, or brand posts
    • 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 (Apify)

Use the Apify Amazon Reviews Scraper (or web_search for G2/Capterra/TrustRadius reviews).

Option 1: Amazon product reviews via Apify

Start a run of the web_wanderer/amazon-reviews-extractor actor:

POST https://api.apify.com/v2/acts/web_wanderer~amazon-reviews-extractor/runs?token=$APIFY_API_TOKEN
Content-Type: application/json

{
  "products": [
    "https://www.amazon.com/dp/PRODUCT_ASIN"
  ],
  "maxReviews": 100
}

Poll until the run finishes:

GET https://api.apify.com/v2/acts/web_wanderer~amazon-reviews-extractor/runs/{RUN_ID}?token=$APIFY_API_TOKEN

When status is SUCCEEDED, fetch results:

GET https://api.apify.com/v2/datasets/{DATASET_ID}/items?token=$APIFY_API_TOKEN

Output fields: Each review has rating (1-5), reviewTitle, reviewText, reviewDate, verifiedPurchase (bool), productAsin, productTitle, helpfulVoteCount.

Option 2: G2/Capterra/TrustRadius reviews via web_search

For B2B products, run web searches to find review content:

web_search: "<product_name> reviews site:g2.com"
web_search: "<product_name> reviews site:capterra.com"
web_search: "<product_name> reviews site:trustradius.com"
web_search: "<competitor_name> reviews site:g2.com"

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 (Apify)

Use the trudax/reddit-scraper-lite actor to search Reddit for relevant threads:

Search by keyword:

POST https://api.apify.com/v2/acts/trudax~reddit-scraper-lite/runs?token=$APIFY_API_TOKEN
Content-Type: application/json

{
  "searches": [
    "<product category> OR <competitor> OR <pain keyword>"
  ],
  "maxItems": 50
}

Browse a specific subreddit:

POST https://api.apify.com/v2/acts/trudax~reddit-scraper-lite/runs?token=$APIFY_API_TOKEN
Content-Type: application/json

{
  "startUrls": [
    {"url": "https://www.reddit.com/r/SUBREDDIT_NAME/hot/"}
  ],
  "maxItems": 50
}

Poll until complete:

GET https://api.apify.com/v2/acts/trudax~reddit-scraper-lite/runs/{RUN_ID}?token=$APIFY_API_TOKEN

Fetch results when status is SUCCEEDED:

GET https://api.apify.com/v2/datasets/{DATASET_ID}/items?token=$APIFY_API_TOKEN

Output fields: Each item has dataType ("post" or "comment"), title (posts only), body, communityName, upVotes, numberOfComments (posts), url, createdAt.

Extract:

  • Questions people ask before buying
  • Complaints about current solutions
  • "I wish [product] would..." statements
  • Comparison threads (vs discussions)

1C: Social Post and Comment Mining

Use scrapecreators-api to collect relevant X posts plus Instagram, TikTok, YouTube, or Facebook posts where the audience is discussing the problem. Run comment-mining on the highest-signal threads. Use web search only as a fallback:

web_search: "<competitor> (frustrating OR broken OR hate) site:x.com"
web_search: "<competitor> (love OR switched to OR replaced) site:x.com"
web_search: "<product category> (recommendation OR alternative OR looking for) site:twitter.com"
web_search: "<competitor> site:x.com" (for general sentiment)

Run 3-5 queries covering:

  • Competitor complaints and frustrations
  • Product category praise / switching stories
  • "What do you use for X?" buying-intent threads

1D: Competitor Ad Mining

Use competitor-ad-intelligence for structured Meta and Google ad-library collection. Use web search only to verify an advertiser or fill a documented gap:

web_search: "<competitor_name> site:facebook.com/ads/library"
web_search: "<competitor_name> facebook ads library"
web_search: "<competitor_name> ad creative examples"

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

Category What to Look For Ad Power
Pain angles Specific frustrations with status quo or competitors High — pain motivates action
Outcome angles Desired results buyers describe in their own words High — positive aspiration
Identity angles How buyers describe themselves or want to be seen Medium — emotional resonance
Fear angles Risks of NOT switching or acting Medium — loss aversion
Competitive displacement Specific reasons people switched from a competitor Very high — direct comparison
Social proof angles Outcomes or metrics buyers cite in reviews High — credibility
Contrast angles Before/after or old way/new way framings High — 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:

Factor Weight Description
Evidence strength 30% Number of independent sources mentioning it
Emotional intensity 25% How strongly people feel about this (language intensity)
Competitive differentiation 20% Does this set you apart, or could any competitor claim it?
ICP relevance 15% How closely does this match the target buyer's world?
Freshness 10% 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 angle-bank-[YYYY-MM-DD].md in the current working directory (or user-specified path).

Tools Required

  • Environment variable: APIFY_API_TOKEN — for Apify actors (review scraper, Reddit scraper)
  • comment-mining — customer language from social and ad comment threads
  • competitor-ad-intelligence — structured ad-library research through ScrapeCreators
  • Web search — built into your AI agent for verification and review sources

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]?"
1---
2name: ad-angle-miner
3description: >
4 Mine the highest-converting ad angles from customer reviews, Reddit complaints,
5 support tickets, and competitor ads. Extracts actual pain language, competitor
6 weaknesses, and outcome phrases that real buyers use. Outputs a ranked angle bank
7 with proof quotes and recommended ad formats per angle.
8tags: [ads]
9---
10 
11# Ad Angle Miner
12 
13Dig 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.
14 
15**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.
16 
17## When to Use
18 
19- "What angles should we run in our ads?"
20- "Find pain points we can use in ad copy"
21- "What are people complaining about with [competitors]?"
22- "Mine reviews for ad messaging"
23- "I need fresh ad angles — not the same tired stuff"
24 
25## Prerequisites
26 
27- **Environment variable:** `APIFY_API_TOKEN` — required for review scraping and Reddit scraping
28- **GooseWorks or a direct ScrapeCreators key** — for structured social comments and ad-library evidence
29- **Web search access** — for review sources and verification fallbacks
30 
31## Phase 0: Intake
32 
331. **Your product** — Name + what it does in one sentence
342. **Competitors** — 2-5 competitor names (for review mining)
353. **ICP** — Who are you targeting? (role, company stage, pain)
364. **Data sources to mine** (pick all that apply):
37 - G2/Capterra/Trustpilot reviews (yours + competitors)
38 - Reddit threads in relevant subreddits
39 - Twitter/X complaints or praise
40 - Social comments on creator, competitor, or brand posts
41 - Support tickets or NPS comments (paste or file)
42 - Competitor ads (Meta + Google)
435. **Any angles you've already tested?** — So we can skip those
44 
45## Phase 1: Source Collection
46 
47### 1A: Review Mining (Apify)
48 
49Use the Apify Amazon Reviews Scraper (or web_search for G2/Capterra/TrustRadius reviews).
50 
51**Option 1: Amazon product reviews via Apify**
52 
53Start a run of the `web_wanderer/amazon-reviews-extractor` actor:
54 
55```
56POST https://api.apify.com/v2/acts/web_wanderer~amazon-reviews-extractor/runs?token=$APIFY_API_TOKEN
57Content-Type: application/json
58 
59{
60 "products": [
61 "https://www.amazon.com/dp/PRODUCT_ASIN"
62 ],
63 "maxReviews": 100
64}
65```
66 
67Poll until the run finishes:
68 
69```
70GET https://api.apify.com/v2/acts/web_wanderer~amazon-reviews-extractor/runs/{RUN_ID}?token=$APIFY_API_TOKEN
71```
72 
73When `status` is `SUCCEEDED`, fetch results:
74 
75```
76GET https://api.apify.com/v2/datasets/{DATASET_ID}/items?token=$APIFY_API_TOKEN
77```
78 
79**Output fields:** Each review has `rating` (1-5), `reviewTitle`, `reviewText`, `reviewDate`, `verifiedPurchase` (bool), `productAsin`, `productTitle`, `helpfulVoteCount`.
80 
81**Option 2: G2/Capterra/TrustRadius reviews via web_search**
82 
83For B2B products, run web searches to find review content:
84 
85```
86web_search: "<product_name> reviews site:g2.com"
87web_search: "<product_name> reviews site:capterra.com"
88web_search: "<product_name> reviews site:trustradius.com"
89web_search: "<competitor_name> reviews site:g2.com"
90```
91 
92Focus on:
93- **1-2 star reviews of competitors** — Pain they're failing to solve
94- **4-5 star reviews of you** — Outcomes that delight buyers
95- **4-5 star reviews of competitors** — Strengths you need to counter or match
96- **Review language patterns** — Exact phrases buyers use
97 
98### 1B: Reddit/Community Mining (Apify)
99 
100Use the `trudax/reddit-scraper-lite` actor to search Reddit for relevant threads:
101 
102**Search by keyword:**
103```
104POST https://api.apify.com/v2/acts/trudax~reddit-scraper-lite/runs?token=$APIFY_API_TOKEN
105Content-Type: application/json
106 
107{
108 "searches": [
109 "<product category> OR <competitor> OR <pain keyword>"
110 ],
111 "maxItems": 50
112}
113```
114 
115**Browse a specific subreddit:**
116```
117POST https://api.apify.com/v2/acts/trudax~reddit-scraper-lite/runs?token=$APIFY_API_TOKEN
118Content-Type: application/json
119 
120{
121 "startUrls": [
122 {"url": "https://www.reddit.com/r/SUBREDDIT_NAME/hot/"}
123 ],
124 "maxItems": 50
125}
126```
127 
128Poll until complete:
129 
130```
131GET https://api.apify.com/v2/acts/trudax~reddit-scraper-lite/runs/{RUN_ID}?token=$APIFY_API_TOKEN
132```
133 
134Fetch results when `status` is `SUCCEEDED`:
135 
136```
137GET https://api.apify.com/v2/datasets/{DATASET_ID}/items?token=$APIFY_API_TOKEN
138```
139 
140**Output fields:** Each item has `dataType` ("post" or "comment"), `title` (posts only), `body`, `communityName`, `upVotes`, `numberOfComments` (posts), `url`, `createdAt`.
141 
142Extract:
143- Questions people ask before buying
144- Complaints about current solutions
145- "I wish [product] would..." statements
146- Comparison threads (vs discussions)
147 
148### 1C: Social Post and Comment Mining
149 
150Use `scrapecreators-api` to collect relevant X posts plus Instagram, TikTok, YouTube, or Facebook posts where the audience is discussing the problem. Run `comment-mining` on the highest-signal threads. Use web search only as a fallback:
151 
152```
153web_search: "<competitor> (frustrating OR broken OR hate) site:x.com"
154web_search: "<competitor> (love OR switched to OR replaced) site:x.com"
155web_search: "<product category> (recommendation OR alternative OR looking for) site:twitter.com"
156web_search: "<competitor> site:x.com" (for general sentiment)
157```
158 
159Run 3-5 queries covering:
160- Competitor complaints and frustrations
161- Product category praise / switching stories
162- "What do you use for X?" buying-intent threads
163 
164### 1D: Competitor Ad Mining
165 
166Use `competitor-ad-intelligence` for structured Meta and Google ad-library collection. Use web search only to verify an advertiser or fill a documented gap:
167 
168```
169web_search: "<competitor_name> site:facebook.com/ads/library"
170web_search: "<competitor_name> facebook ads library"
171web_search: "<competitor_name> ad creative examples"
172```
173 
174This reveals:
175- Angles they've validated (long-running ads = working)
176- Angles they're testing (new ads)
177- Angles nobody is running (white space)
178 
179### 1E: Internal Data (Optional)
180 
181If the user provides support tickets, NPS comments, or sales call transcripts — ingest and tag with the same framework below.
182 
183## Phase 2: Angle Extraction
184 
185Process all collected data through this extraction framework:
186 
187### Angle Categories
188 
189| Category | What to Look For | Ad Power |
190|----------|-----------------|----------|
191| **Pain angles** | Specific frustrations with status quo or competitors | High — pain motivates action |
192| **Outcome angles** | Desired results buyers describe in their own words | High — positive aspiration |
193| **Identity angles** | How buyers describe themselves or want to be seen | Medium — emotional resonance |
194| **Fear angles** | Risks of NOT switching or acting | Medium — loss aversion |
195| **Competitive displacement** | Specific reasons people switched from a competitor | Very high — direct comparison |
196| **Social proof angles** | Outcomes or metrics buyers cite in reviews | High — credibility |
197| **Contrast angles** | Before/after or old way/new way framings | High — clear value prop |
198 
199### For Each Angle, Extract:
200 
2011. **The angle** — One-sentence framing
2022. **Proof quotes** — 2-5 verbatim quotes from sources
2033. **Source count** — How many independent sources mention this?
2044. **Competitor weakness?** — Does this exploit a specific competitor's gap?
2055. **Emotional register** — Frustration / Aspiration / Fear / Relief / Pride
2066. **Recommended format** — Search ad / Meta static / Meta video / LinkedIn / Twitter
207 
208## Phase 3: Scoring & Ranking
209 
210Score each angle on:
211 
212| Factor | Weight | Description |
213|--------|--------|-------------|
214| **Evidence strength** | 30% | Number of independent sources mentioning it |
215| **Emotional intensity** | 25% | How strongly people feel about this (language intensity) |
216| **Competitive differentiation** | 20% | Does this set you apart, or could any competitor claim it? |
217| **ICP relevance** | 15% | How closely does this match the target buyer's world? |
218| **Freshness** | 10% | Is this angle already overused in competitor ads? |
219 
220**Total score out of 100. Rank all angles.**
221 
222## Phase 4: Output Format
223 
224```markdown
225# Ad Angle Bank — [Product Name] — [DATE]
226 
227Sources mined: [list]
228Total angles extracted: [N]
229Top-tier angles (score 70+): [N]
230 
231---
232 
233## Tier 1: Highest-Conviction Angles (Score 70+)
234 
235### Angle 1: [One-sentence angle]
236- **Category:** [Pain / Outcome / Identity / Fear / Displacement / Proof / Contrast]
237- **Score:** [X/100]
238- **Emotional register:** [Frustration / Aspiration / etc.]
239- **Proof quotes:**
240 > "[Verbatim quote 1]" — [Source: G2 review / Reddit / etc.]
241 > "[Verbatim quote 2]" — [Source]
242 > "[Verbatim quote 3]" — [Source]
243- **Source count:** [N] independent mentions
244- **Competitor weakness exploited:** [Competitor name + specific gap, or "N/A"]
245- **Recommended formats:** [Search ad headline / Meta static / Video hook / etc.]
246- **Sample headline:** "[Draft headline using this angle]"
247- **Sample body copy:** "[Draft 1-2 sentence body]"
248 
249### Angle 2: ...
250 
251---
252 
253## Tier 2: Worth Testing (Score 50-69)
254 
255[Same format, briefer]
256 
257---
258 
259## Tier 3: Emerging / Low-Evidence (Score < 50)
260 
261[Brief list — angles with potential but insufficient evidence]
262 
263---
264 
265## Competitive Angle Map
266 
267| Angle | Your Product | [Comp A] | [Comp B] | [Comp C] |
268|-------|-------------|----------|----------|----------|
269| [Angle 1] | Can claim ✓ | Weak here ✗ | Also claims | Not relevant |
270| [Angle 2] | Strong ✓ | Strong | Weak ✗ | Not relevant |
271...
272 
273---
274 
275## Recommended Test Plan
276 
277### Week 1-2: Test Tier 1 Angles
278- [Angle] → [Format] → [Platform]
279- [Angle] → [Format] → [Platform]
280 
281### Week 3-4: Test Tier 2 Angles
282- [Angle] → [Format] → [Platform]
283```
284 
285Save to `angle-bank-[YYYY-MM-DD].md` in the current working directory (or user-specified path).
286 
287## Tools Required
288 
289- **Environment variable:** `APIFY_API_TOKEN` — for Apify actors (review scraper, Reddit scraper)
290- **`comment-mining`** — customer language from social and ad comment threads
291- **`competitor-ad-intelligence`** — structured ad-library research through ScrapeCreators
292- **Web search** — built into your AI agent for verification and review sources
293 
294## Trigger Phrases
295 
296- "Mine ad angles from reviews"
297- "What angles should we run?"
298- "Find pain language for our ads"
299- "Build an ad angle bank for [client]"
300- "What are people complaining about with [competitor]?"
301 

Discussion

Alternatives

Also in Competitor research
Competitor Comparison & Alternatives PagesTell us your product and a rival you keep losing deals to, and get back a ready-to-publish page that shows why customers should pick you.Business & ops · MITX audience insightsRead your X (Twitter) audience and niche from real data. Pull a handle's recent tweets (yours or a competitor's) with likes, replies, and views, see which formats and hooks are working, read the repliers on a tweet (X gates likers, so repliers are the signal), and scan a niche query for top tweets. Powered by Apify, no login. Triggers on "analyze my tweets", "what is working on X", "read the replies", "competitor tweets", "who is engaging". Not for writing a tweet (use x-post-writer).Marketing · MITFacebook Audience InsightsRead a Facebook Page and its audience from real data. Pull any Page's public stats (yours or a competitor's): followers, likes, categories, intro, websites. And pull the commenters on a public Page post, since Facebook hides the reactor and liker roster and shows counts only, so commenters are the signal. Powered by Apify, no login. Triggers on "analyze my Page", "competitor Page stats", "who is commenting", "read the comments", "audience insights". Not for writing Page posts (use fb-post-writer).Marketing · MITCompetitor & Alternative PagesWhen the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For sales-specific competitor docs, see sales-enablement.Marketing · MIT