From Hyper Marketing
Searches the Meta Ads Library for competitor Facebook/Instagram ads via Hyper MCP & Apify. Retrieves ad creatives, metadata, page contact info, and produces structured ad-intelligence summaries for competitive analysis or lead generation.
How this skill is triggered — by the user, by Claude, or both
Slash command
/hyper-marketing:meta-ads-libraryThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Guide for searching the Meta Ads Library and producing structured competitor ad intelligence.
Guide for searching the Meta Ads Library and producing structured competitor ad intelligence.
The skill's job is to turn raw scraped ads into useful summaries: top advertisers, common CTAs, recurring hooks, recently launched creatives, and (optionally) enriched lead lists. All output is presented inline in chat — there is no database or persistence layer.
| Request | Send them to |
|---|---|
| Multi-source competitor research (site, social, search rank, etc., not just ads) | competitor-intel |
| Generating new ad creative based on what you found | ad-creative-generation |
If search_facebook_ads is not in the tool list, stop and tell the user to enable Hyper MCP and connect Apify.
| Tool | Purpose |
|---|---|
search_facebook_ads | Search the Meta Ads Library by keyword. Returns compact results (title, body, CTA, link, page name, dates, platforms). Max 40 per call. |
get_facebook_ad_details | Get full details for a specific ad. Requires both ad_archive_id and page_id — both come from search_facebook_ads results. |
search_facebook_ads_enriched | Search + enrich each result with page contact info (email, phone, website). Slower (multiple API calls per result). Max 20 per call. |
search_facebook_pages | Search Facebook pages by category + location (not by keyword). Useful for building a lead list from a vertical. |
scrape_facebook_pages | Scrape detailed data from specific Facebook page URLs. |
search_facebook_ads allows count up to 40. search_facebook_ads_enriched caps at 20 — exceeding this returns an error.get_facebook_ad_details needs two IDs. Both ad_archive_id and page_id are required. Both are returned in every search_facebook_ads result row — pass them through together.search_facebook_ads."fetch failed" responses. Retry once after a short delay before reporting the source as missing.Before running anything, agree on:
"meal kit delivery", "AI marketing tools", "skincare for sensitive skin"."US", "GB", "AU"). Default to "ALL" only if the user explicitly wants global.active_status="active" is usually what you want. Inactive ads are historical and noisier.period accepts "last24h", "last7d", "last14d", "last30d", or "all_time". Match the window to the user's intent (weekly digest → "last7d", trend research → "last30d").search_facebook_ads, summarize patterns across hooks, CTAs, formats.search_facebook_ads, group by page_name.search_facebook_ads_enriched, filter for rows with contact_email or contact_website.search_facebook_ads(
query="meal kit delivery",
country="US",
active_status="active",
count=40, # max for this tool
period="last30d"
)
Each result row includes: ad_archive_id, page_id, page_name, is_active, start_date_formatted, end_date_formatted, title, body, cta_text, link_url, caption, ad_library_url, page_categories, publisher_platform.
For more than 40 ads, paginate by re-calling with offset=40, offset=80, etc.
For lead-gen with contact info:
search_facebook_ads_enriched(
query="meal kit delivery",
country="US",
active_status="active",
count=20, # max for the enriched tool
scrape_websites=True,
filter_spam=False
)
Enriched rows add: contact_email, contact_phone, contact_website, page_followers, page_rating, address, business hours.
search_facebook_ads returns truncated bodies for some ads. To get the complete creative — including video URLs and images — call get_facebook_ad_details on the specific ads worth a deeper look:
get_facebook_ad_details(
ad_archive_id="559220927273823", # from search results
page_id="328127803978438" # from search results
)
Both args come from the same row in search_facebook_ads. Do this for the top 3–5 ads, not all 40 — each detail call is a separate Apify run.
Present the findings inline in chat. Pick the format that matches the user's job from Phase 1.
Top advertisers (group by page):
| Page | Active ads | Categories | Notable angle |
|---|---|---|---|
| Brand A | 12 | Restaurant, Meal Kit | "Skip the grocery store" hook in 8/12 ads |
| Brand B | 7 | Software, Subscription | Heavy on UGC video, "$1 first week" offer |
Common CTAs and hooks:
| Pattern | Count | Examples |
|---|---|---|
Sign up CTA | 18 | … |
Shop now CTA | 12 | … |
| Price-anchor opener ("From $X/week") | 9 | … |
| Founder-story opener | 4 | … |
Recently launched ads (last 7 days):
| Page | Started | CTA | Hook | Library URL |
|---|---|---|---|---|
| Brand A | 2026-04-28 | Sign up | "Skip the grocery run this week" | <ad_library_url> |
Lead list (enriched only):
| Page | Website | Followers | Active ads | |
|---|---|---|---|---|
| Brand A | [email protected] | a.com | 12K | 7 |
If the user wants ongoing tracking:
active_status settings.period="last7d".This is when competitor-intel becomes the better skill — it handles multi-source diffing across many surfaces, not just Meta ads.
ad_library_url for any specific ad referenced in the brief — the user can click through to verify.npx claudepluginhub hyperfx-ai/marketing-skills --plugin hyper-marketingExtracts and analyzes competitors' ads from Facebook and LinkedIn ad libraries to identify successful messaging, problems, and creative patterns. Helps inspire ad campaigns.
Extracts and analyzes competitors' ads from Facebook Ad Library and LinkedIn, capturing screenshots, identifying messaging patterns, pain points, use cases, and successful strategies.
Extracts competitors' ads from Facebook Ad Library and LinkedIn, captures screenshots, analyzes messaging, pain points, patterns, and creative strategies to inspire campaigns.