New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Analyze active ads from Meta/Facebook, Google

Ad library teardown

by ScrapeCreators · MIT license · ★ 2,619 on GitHub · v1.0.0 · updated Aug 26

Ad library teardown cover

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.

---
name: ad-library-teardown
description: 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.
allowed-tools: Bash, Read, Write, WebFetch

version: 1.0.0
author: ScrapeCreators
license: MIT
homepage: https://scrapecreators.com
repository: https://github.com/ScrapeCreators/social-media-research-skills
metadata:
  openclaw:
    requires:
      env:
        - SCRAPECREATORS_API_KEY
    primaryEnv: SCRAPECREATORS_API_KEY
    homepage: https://scrapecreators.com
    tags:

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.

The SKILL.md below is the copy AgentAlley read and checked. The repo has changed it since; the other files are from commit 64ba7b4.

Manual install (npx, ZIP)
Claude Codenpx skills add ScrapeCreators/social-media-research-skills --skill ad-library-teardown -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/ScrapeCreators/social-media-research-skills/tar.gz/64ba7b4dea71 \ | tar -xz -C ~/.claude/skills --strip-components=2 social-media-research-skills-64ba7b4dea71/skills/ad-library-teardown
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/46c9b7409b9c9bc8b3a1/ad-library-teardown.zip" -OutFile "$env:TEMP\ad-library-teardown.zip"; Expand-Archive "$env:TEMP\ad-library-teardown.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md3.7 KB
Read the files here
ScrapeCreators/64ba7b41 file
SKILL.md
Show the full text130 lines
ad-library-teardown/SKILL.md130 lines · 3.7 KB

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

# 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.
1---
2name: ad-library-teardown
3description: 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.
4allowed-tools: Bash, Read, Write, WebFetch
5 
6version: 1.0.0
7author: ScrapeCreators
8license: MIT
9homepage: https://scrapecreators.com
10repository: https://github.com/ScrapeCreators/social-media-research-skills
11metadata:
12 openclaw:
13 requires:
14 env:
15 - SCRAPECREATORS_API_KEY
16 primaryEnv: SCRAPECREATORS_API_KEY
17 homepage: https://scrapecreators.com
18 tags:
19 - social-media
20 - research
21 - scrapecreators
22---
23 
24# Ad Library Teardown
25 
26## Overview
27 
28Analyze 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.
29 
30## When to Use
31 
32Use this skill when the user asks to:
33 
34- analyze a competitor's active ads
35- search Meta/Facebook, Google, or LinkedIn ad libraries
36- extract ad hooks, CTAs, claims, offers, and landing page angles
37- compare ad messaging across competitors
38- summarize video ad transcripts
39- generate ad test ideas from competitor ads
40 
41## Data Sources
42 
43| Ad library | Search/list endpoint | Detail endpoint | Transcript endpoint |
44|---|---|---|---|
45| 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` |
46| Google | `/v1/google/adLibrary/advertisers/search`, `/v1/google/company/ads` | `/v1/google/ad` | n/a |
47| LinkedIn | `/v1/linkedin/ads/search` | `/v1/linkedin/ad` | n/a |
48 
49## Workflow
50 
511. **Find the advertiser**
52 - Use company search endpoints when the user provides only a brand name.
53 - Use domain/advertiser/page IDs when available.
54 
552. **Fetch active ads**
56 - Prefer active ads unless the user asks for historical analysis.
57 - Capture platform, advertiser/page, ad ID, start date, creative type, text, headline, CTA, destination URL, and source URL.
58 
593. **Fetch details for representative ads**
60 - Enrich the ads with detail endpoints.
61 - For video Meta ads, fetch transcripts when available.
62 
634. **Cluster messaging**
64 Group ads by:
65 - pain point
66 - persona
67 - offer
68 - proof/social proof
69 - feature/benefit
70 - objection handled
71 - comparison/alternative angle
72 - urgency/discount
73 
745. **Extract swipeable elements**
75 - hooks
76 - headlines
77 - primary text patterns
78 - CTAs
79 - claims
80 - offers
81 - visual/creative concepts
82 
836. **Recommend tests**
84 Suggest tests based on repeated patterns and gaps, not random ideas.
85 
86## Output Format
87 
88```markdown
89# Ad Library Teardown: {brand}
90 
91## Summary
92- Ads analyzed: {count}
93- Platforms: Meta / Google / LinkedIn
94- Main positioning:
95- Strongest repeated offer:
96 
97## Messaging Angles
98| Angle | Evidence | Example ads | Notes |
99|---|---|---|---|
100 
101## Hooks and Headlines Swipe File
102- "..."
103- "..."
104 
105## Offers and CTAs
106| Offer | CTA | Platform | Example |
107|---|---|---|---|
108 
109## Video Transcript Notes
110- [Ad](url): summary, hook, best quote
111 
112## What They Appear to Be Testing
1131. ...
1142. ...
115 
116## Recommended Tests for Us
1171. ...
1182. ...
1193. ...
120 
121## Sources
122- [Ad](url)
123```
124 
125## Common Pitfalls
126 
127- 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.
128- Do not ignore repeated ads. Repetition is often a useful signal.
129- Do not invent spend, conversion rate, or targeting unless public data includes it.
130- Do not skip video transcripts when the user asks for hooks or messaging from video ads.
View all files on GitHub →

Details

Version
1.0.0
Updated
Aug 26, 2026
License
MIT
Stars on the repo
★ 2,619
Checked
Source
ScrapeCreators/social-media-research-skills ↗
Creator
ScrapeCreators · 13 listings
View creator

Similar skills

See all →
SkillTurn product materials into listing visuals for Taobao, JDEcommerce visual copywritingfeichanggege/ecommerce-visual-copywriting-skill · by feichanggegeTurn product materials into listing visuals for Taobao, JD, Douyin, Amazon, Shopify and TikTok Shop: main-image and detail-page storyboards, in-image copy, image prompts, plus an evidence and ad-compliance check.★ 985 GitHub starsSkillTell us about your plans and pricesPricing Page (High‑Conversion) — Web Design Skillboraoztunc/skills · by Meng ToTell us about your plans and prices, and get back a ready-to-build pricing page: plan layout, what each tier includes, buttons, and answers to common buyer questions.★ 361 GitHub starsSkillWrites opening hooks and post titles for long-form articlesCopywriting hookssamber/cc-skills · by samberWrites opening hooks and post titles for long-form articles in EN or FR — blog posts, Substack/Medium/dev.to, LinkedIn long-form, newsletters, essays. Trigger whenever the user asks for a hook, opening, lede, intro, first sentence/paragraph, opener, accroche, attaque, phrase d'accroche, or première phrase — including punching up a flat intro or draft opening — or for a post title, titre d'article, or headline. Do NOT trigger for social posts (LinkedIn feed, Twitter/X, TikTok, Bluesky), READMEs, taglines, email subjects, ad copy, landing-page headlines, press releases, SEO meta, or body rewrites. Do NOT use for end-of-article CTAs — use samber/cc-skills@copywriting-cta instead.★ 222 GitHub starsSkillSomeone wants landing page ideas, conceptsEcom landing pageskgelster/awesome-ecom-skills · by kgelsterUse when someone wants landing page ideas, concepts, or angles for a store: give me landing page concepts", "LP ideas", "landing page angles", a campaign or ad landing page, pages for a new audience/segment, a seasonal/event/promo page, or a geo/local page. Also use when a chosen concept gets picked and needs building out into an actual page (section-by-section blueprint), or when auditing an existing landing page against best practice. The core insight: one product becomes dozens of pages by varying the ANGLE, not the product. Not for full-site information architecture, product detail pages, collection pages, or blog/SEO content (a landing page has ONE goal, no site chrome). Use an SEO/content skill. Not for the ad or email creative itself, though message match with the page matters.★ 49 GitHub starsSkillWrite sales pages, email sequencesEW Skill — Sales CopyDeupaxx/EveryDay-Writer · by DeupaxxWrite sales pages, email sequences, and direct-response copy that converts through clarity and specificity rather than manipulation. Use for launches, offers, and conversion-focused email. Enforces the EW anti-AI rules, proof standards, and the writer's voice profile.★ 32 GitHub starsSkillWrite and rewrite landing-page headlines, hero sectionsHeadline Copywriting — Hero Sections That Convertoathdriven/rymac-skills · by oathdrivenWrite and rewrite landing-page headlines, hero sections, and their CTAs using a pain + dream-outcome formula, awareness-stage diagnosis, and a curated SaaS swipe file. Use when the user asks to "write a headline", "rewrite the hero", "fix the landing page headline", "give me headline options", "punch up the hero", or works on above-the-fold copy for allodra.ai, sierra6ai.com, or any writing-room landing page. Make sure to use this skill whenever a headline, hero section, subheadline, or CTA button copy is being written or critiqued.★ 28 GitHub stars

More from ScrapeCreators

SkillEvaluate a creator, influencerAudience researchScrapeCreators/social-media-research-skills · by ScrapeCreatorsUse 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.★ 2.6k GitHub starsSkillMine comments and replies for audience reactionsComment miningScrapeCreators/social-media-research-skills · by ScrapeCreatorsUse 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.★ 2.6k GitHub starsSkillResearch competitors' social media strategyCompetitor social researchScrapeCreators/social-media-research-skills · by ScrapeCreatorsUse 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.★ 2.6k GitHub starsSkillTurn public social videos, transcripts, postsContent repurposingScrapeCreators/social-media-research-skills · by ScrapeCreatorsUse 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.★ 2.6k GitHub starsSkillAnalyze a creator, influencer, founderCreator profile teardownScrapeCreators/social-media-research-skills · by ScrapeCreatorsUse 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.★ 2.6k GitHub starsSkillFind creators, influencers, affiliatesInfluencer prospectingScrapeCreators/social-media-research-skills · by ScrapeCreatorsUse 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.★ 2.6k GitHub stars