ad-library-teardown
Use when the user wants to analyze active ads from Meta/Facebook, Google, or LinkedIn ad libraries; tear down a competitor's messaging; extract hooks, offers, CTAs, video transcripts, landing page claims, and test ideas from public ads.
git clone --depth 1 https://github.com/ScrapeCreators/social-media-research-skills /tmp/ad-library-teardown && cp -r /tmp/ad-library-teardown/skills/ad-library-teardown ~/.claude/skills/ad-library-teardownSKILL.md
# Ad Library Teardown
## Overview
Analyze public ads to understand a competitor's messaging, offers, creative strategy, and testing angles. The output should be a practical teardown marketers can use to write better ads or decide what to test.
## When to Use
Use this skill when the user asks to:
- analyze a competitor's active ads
- search Meta/Facebook, Google, or LinkedIn ad libraries
- extract ad hooks, CTAs, claims, offers, and landing page angles
- compare ad messaging across competitors
- summarize video ad transcripts
- generate ad test ideas from competitor ads
## Data Sources
| Ad library | Search/list endpoint | Detail endpoint | Transcript endpoint |
|---|---|---|---|
| Meta/Facebook | `/v1/facebook/adLibrary/search/ads`, `/v1/facebook/adLibrary/company/ads`, `/v1/facebook/adLibrary/search/companies` | `/v1/facebook/adLibrary/ad` | `/v1/facebook/adLibrary/ad/transcript` |
| Google | `/v1/google/adLibrary/advertisers/search`, `/v1/google/company/ads` | `/v1/google/ad` | n/a |
| LinkedIn | `/v1/linkedin/ads/search` | `/v1/linkedin/ad` | n/a |
## Workflow
1. **Find the advertiser**
- Use company search endpoints when the user provides only a brand name.
- Use domain/advertiser/page IDs when available.
2. **Fetch active ads**
- Prefer active ads unless the user asks for historical analysis.
- Capture platform, advertiser/page, ad ID, start date, creative type, text, headline, CTA, destination URL, and source URL.
3. **Fetch details for representative ads**
- Enrich the ads with detail endpoints.
- For video Meta ads, fetch transcripts when available.
4. **Cluster messaging**
Group ads by:
- pain point
- persona
- offer
- proof/social proof
- feature/benefit
- objection handled
- comparison/alternative angle
- urgency/discount
5. **Extract swipeable elements**
- hooks
- headlines
- primary text patterns
- CTAs
- claims
- offers
- visual/creative concepts
6. **Recommend tests**
Suggest tests based on repeated patterns and gaps, not random ideas.
## Output Format
```markdown
# Ad Library Teardown: {brand}
## Summary
- Ads analyzed: {count}
- Platforms: Meta / Google / LinkedIn
- Main positioning:
- Strongest repeated offer:
## Messaging Angles
| Angle | Evidence | Example ads | Notes |
|---|---|---|---|
## Hooks and Headlines Swipe File
- "..."
- "..."
## Offers and CTAs
| Offer | CTA | Platform | Example |
|---|---|---|---|
## Video Transcript Notes
- [Ad](url): summary, hook, best quote
## What They Appear to Be Testing
1. ...
2. ...
## Recommended Tests for Us
1. ...
2. ...
3. ...
## Sources
- [Ad](url)
```
## Common Pitfalls
- Do not claim an ad is winning just because it is active. Say it is active or repeated; performance is not public unless the endpoint returns it.
- Do not ignore repeated ads. Repetition is often a useful signal.
- Do not invent spend, conversion rate, or targeting unless public data includes it.
- Do not skip video transcripts when the user asks for hooks or messaging from video ads.Use when the user wants to evaluate a creator, influencer, or brand audience using public profile signals, TikTok audience demographics, follower/following data, comments, geography, language, and content fit. Helps judge sponsorship and market fit.
Use when the user wants to mine comments and replies for audience reactions, customer language, questions, objections, complaints, product ideas, buying intent, sentiment, or voice-of-customer insights from public social posts and videos.
Use when the user wants to research competitors' social media strategy, compare brands or creators, find what content is working in a niche, identify content gaps, or produce a practical social strategy brief from public social data.
Use when the user wants to turn public social videos, transcripts, posts, or creator research into reusable content assets such as LinkedIn posts, X threads, short-form scripts, newsletters, blog outlines, carousels, or content calendars.
Use when the user wants to analyze a creator, influencer, founder, or brand social account and understand positioning, content pillars, outlier posts, hooks, format choices, audience reaction, and what can be copied or tested.
Use when the user wants to find creators, influencers, affiliates, or social accounts in a niche for outreach, partnerships, sponsorships, UGC, seeding, or competitive research. Produces scored prospect lists from public social data.
Use when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline. Finds outliers, explains why they worked, extracts hooks and formats, and produces a practical swipe file.
Use when the user wants to validate a product idea, find pain points, mine demand signals, discover objections, or gather voice-of-customer language from Reddit, social posts, video transcripts, and comments. Produces evidence-backed product research.