# ad-library-teardown Adopt this skill: https://proskills.md/skills/other/scrapecreators-social-media-research-skills-skills-ad-library-teardown Page: https://proskills.md/skills/other/scrapecreators-social-media-research-skills-skills-ad-library-teardown This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required. ## File: skills/ad-library-teardown/SKILL.md size: 3786 sha: 2b680ffc8c995afa7fa62c56adf2d6b7dd07d72a upstream: https://github.com/scrapecreators/social-media-research-skills/blob/main/skills/ad-library-teardown/SKILL.md ````text --- 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: - social-media - research - scrapecreators --- # 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. ```` ## File: README.md upstream: https://github.com/scrapecreators/social-media-research-skills/blob/main/README.md ````text # Social Media Research Skills for AI Agents Practical AI agent skills for social media research, powered by [ScrapeCreators](https://scrapecreators.com). These skills help agents find outlier posts, mine comments, summarize transcripts, tear down competitors, analyze ad libraries, and turn public social data into useful business artifacts. This is not just endpoint routing. The goal is to give your AI agent complete research workflows it can run across TikTok, Instagram, YouTube, Reddit, X/Twitter, LinkedIn, Facebook, Threads, Bluesky, Pinterest, Rumble, ad libraries, and more. ## Install ```bash npx skills add ScrapeCreators/social-media-research-skills ``` Works with Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Gemini CLI, Windsurf, VS Code, and other agents that support the [Agent Skills spec](https://agentskills.io). ## Setup Set your ScrapeCreators API key: ```bash export SCRAPECREATORS_API_KEY=sk_... ``` Get a key at [scrapecreators.com](https://scrapecreators.com). ## Available Skills | Skill | Use it when you want to... | Output | |---|---|---| | [`outlier-post-finder`](skills/outlier-post-finder/) | Find posts, reels, shorts, tweets, or videos that beat a creator's baseline | Outlier table, repeatable patterns, hooks to steal | | [`transcript-intelligence`](skills/transcript-intelligence/) | Analyze video transcripts from TikTok, Instagram, YouTube, Facebook, X, LinkedIn, Rumble, or Reddit | Summary, hooks, claims, quotes, content atoms | | [`comment-mining`](skills/comment-mining/) | Mine comments for questions, objections, pain points, product ideas, and audience language | VOC report, themes, quotes, content ideas | | [`competitor-social-research`](skills/competitor-social-research/) | Compare competitors' social strategy and find what is working | Competitor brief, content pillars, gaps, recommendations | | [`ad-library-teardown`](skills/ad-library-teardown/) | Analyze active Meta, Google, and LinkedIn ads | Messaging angles, hooks, CTAs, offers, test ideas | | [`trend-discovery`](skills/trend-discovery/) | Find trending topics, hashtags, sounds, posts, and short-form formats in a niche | Trend brief, evidence table, suggested content angles | | [`influencer-prospecting`](skills/influencer-prospecting/) | Build creator or influencer prospect lists from public social data | Prospect CSV/table, fit score, outreach notes | | [`audience-research`](skills/audience-research/) | Evaluate creator or brand audience fit from public profile and demographic signals | Audience-fit report, market/country notes, confidence labels | | [`social-listening-brief`](skills/social-listening-brief/) | Research what people are saying about a brand, topic, product category, or niche | Multi-source brief, themes, cited examples, sentiment caveats | | [`product-demand-research`](skills/product-demand-research/) | Validate product ideas and find pain points from social posts, comments, and Reddit | Demand signals, pains, objections, exact language, ideas | | [`creator-profile-teardown`](skills/creator-profile-teardown/) | Analyze why a creator or brand account works and what to copy | Positioning teardown, content pillars, outliers, playbook | | [`content-repurposing`](skills/content-repurposing/) | Turn social videos, transcripts, and posts into reusable content assets | LinkedIn posts, X threads, scripts, newsletter/blog ideas | | [`scrapecreators-api`](skills/scrapecreators-api/) | Route a raw scraping/fetching request to the right ScrapeCreators endpoint | API calls, endpoint references, pagination guidance | ## Example Prompts ```text Find the outlier posts for @starterstory on YouTube Shorts from the latest page of videos. ``` ```text Analyze the transcripts from these 12 TikToks and pull out the best hooks, claims, and reusable content angles. ``` ```text Mine the comments on this viral Instagram Reel. I want objections, questions, buying intent, and exact audience language. ``` ```text Compare these five brands on TikTok and Instagram. What formats and topics are working for each one? ``` ```text Tear down the active Facebook, Google, and LinkedIn ads for this competitor. Give me hooks, offers, CTAs, and what to test. ``` ## How the Skills Work Together ```text scrapecreators-api │ ▼ social research workflows ├─ outlier-post-finder ├─ transcript-intelligence ├─ comment-mining ├─ competitor-social-research ├─ ad-library-teardown ├─ trend-discovery ├─ influencer-prospecting ├─ audience-research ├─ social-listening-brief ├─ product-demand-research ├─ creator-profile-teardown └─ content-repurposing ``` The workflow skills should use `scrapecreators-api` as the data layer when they need endpoint details. Each workflow produces a useful artifact, not just raw JSON. ## Design Principles 1. **Workflow-first, API-second** — users ask for a business outcome, not an endpoint. 2. **Public-data only** — ScrapeCreators extracts public social data. Do not promise logged-in/private data. 3. **Cited outputs** — include source URLs for posts, videos, ads, and comments whenever possible. 4. **Baseline-aware analysis** — judge performance against a creator's own normal performance, not only raw vanity metrics. 5. **Exact language matters** — preserve useful comments, hooks, captions, and transcript quotes verbatim. 6. **Keep outputs actionable** — end with patterns, recommendations, test ideas, or a CSV when useful. ## Links - [ScrapeCreators](https://scrapecreators.com) - [API Documentation](https://docs.scrapecreators.com) - [MCP Integration](https://docs.scrapecreators.com/integrations/mcp) - [Agent Skill Docs](https://docs.scrapecreators.com/integrations/agent-skill) ````