ad-library-scraper

Search public ad libraries through ToolRouter's MCP server - Meta (Facebook and Instagram) Ad Library, Google Ads Transparency Center, LinkedIn, TikTok and Reddit ads. Use when the user wants to see a competitor's running ads, ad copy and creative, how long ads have run, which platforms they run on, or video ad transcripts.

Read the public ad libraries that Meta, Google, LinkedIn, TikTok and Reddit publish, from one MCP connection. Returns ad copy, creative URLs, start dates, platforms and, where the library publishes it, reach and spend.

Installation

Install with pnpm dlx skills add Humanleap/agent-skills --skill ad-library-scraper. Connect the client's remote MCP server to https://api.toolrouter.com/mcp (Claude: Customize → Connectors → Add custom connector; Claude Code: claude mcp add toolrouter -- npx -y toolrouter-mcp). Setup: https://toolrouter.com/docs/markdown/quickstart.

Hard Rules

1. Resolve the advertiser first. Keyword search matches any ad that contains the word. To see one company's ads, look up its page or advertiser ID, then fetch that company's ads.
2. Use the exact operation. Pick the tool and skill below, or call discover. Never invent an input field.
3. State the window. Say which country, status and date range the results cover.
4. No guessing at spend. Only report spend or reach when the library returns it.

Authentication and Cost

The server provisions an anonymous account on first use. Paid calls need credits: if use_tool returns a claim link, give it to the user so they can sign in and add credits. Most ad library calls cost $0.005; discover shows the live price. get_google_company_ads with get_ad_details: true costs more per ad, so leave it off until the user needs full detail.

Core Workflow

1. Find the advertiser. Meta: search_facebook_ad_companies → page_id. Google: search_google_advertisers → advertiser_id, or pass the domain.
2. Pull their ads. get_facebook_company_ads with page_id, country, status:"ACTIVE" and trim:true. get_google_company_ads with domain or advertiser_id.
3. Open the winners. get_facebook_ad with get_transcript:true for a video ad's script; get_google_ad for one Google creative.
4. Summarise. Table of start date, days running, platforms, format, hook (first line) and call to action. Long-running ads are the ones the advertiser keeps paying for.

Essential Operations

All tool: "ad-library-search".

Job	skill	Input
Find a brand's Meta page ID	search_facebook_ad_companies	{"query":"Notion"}
A brand's active Meta ads in one country	get_facebook_company_ads	{"page_id":"825120160874613","country":"GB","status":"ACTIVE","trim":true}
Meta ads mentioning a keyword	search_facebook_ads	{"query":"protein bar","country":"US","search_type":"keyword_exact_phrase","trim":true}
One Meta ad, with video transcript	get_facebook_ad	{"url":"https://www.facebook.com/ads/library/?id=123","get_transcript":true}
Find a Google advertiser	search_google_advertisers	{"query":"Shopify"}
A domain's Google ads	get_google_company_ads	{"domain":"shopify.com","region":"US"}
One Google ad (text via OCR)	get_google_ad	{"url":"https://adstransparency.google.com/advertiser/AR.../creative/CR..."}
LinkedIn ads by company	search_linkedin_ads	{"company":"Salesforce"}
TikTok ads by advertiser	search_tiktok_ads	{"advertiser_name":"Duolingo"}
One TikTok ad (hook, landing page, video)	get_tiktok_ad	{"ad_id":"<id or library.tiktok.com URL>"}
Reddit promoted posts	search_reddit_ads	{"query":"project management"}

Call these through use_tool with tool, skill and input.

Common Patterns

• Competitor ad teardown: resolve 3 competitors' Meta page IDs, pull active ads in the user's market, sort by start date, and compare hooks, offers and formats.
• Creative brief: take the 5 longest-running ads, pull transcripts for the video ones, and list the hooks, proof points and calls to action that repeat.
• Channel mix check: run the same brand through Meta, Google, LinkedIn and TikTok to see where it actually advertises.
• Landing page follow-through: pass an ad's landing URL to web-scraper/scrape_page to read the offer behind the ad.
• Organic vs paid: pair with the social-media-scraper skill to compare what a brand promotes with what it posts.

Gotchas

• search_facebook_ads is a keyword search across all advertisers: "notion" also matches unrelated ads that use the word. Resolve the page ID for brand research.
• Several pages can share a brand name. Pick the one with the matching Instagram handle, follower count or page alias.
• Meta results default to active ads; set status:"ALL" for history. Use trim:true to keep responses small, and cursor to page.
• An empty Google result for a domain can mean the advertiser is registered under another name. Try search_google_advertisers.
• Pass query or advertiser_name to search_tiktok_ads, not both.

Quick Reference

Connect → resolve page/advertiser ID → company ads (country, active, trim) → open top ads → table of hooks, dates and platforms.

More: https://toolrouter.com/tools/ad-library-search