Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add hyperfx-ai/marketing-skills --skill meta-ads-librarygit clone --depth 1 https://github.com/hyperfx-ai/marketing-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/hyperfx-ai/marketing-skills/meta-ads-library)<a href="https://agentmods.dev/skills/hyperfx-ai/marketing-skills/meta-ads-library"><img src="https://agentmods.dev/badge/skills/hyperfx-ai/marketing-skills/meta-ads-library/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/hyperfx-ai/marketing-skills/meta-ads-library"><img src="https://agentmods.dev/badge/skills/hyperfx-ai/marketing-skills/meta-ads-library.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00090 | $0.02005 |
| Opus 5 | $0.00045 | $0.01002 |
| Sonnet 5 | $0.00018 | $0.00401 |
| Haiku 4.5 | $0.00009 | $0.00200 |
Grade A, and why
meta-ads-library scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 156 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Meta Ads Library
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.
Out of scope — defer to other skills
| 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 |
Requirements
- Hyper MCP installed and connected. https://app.hyperfx.ai/mcp
- Apify integration connected at https://app.hyperfx.ai/apps — the Meta Ads Library tools run via Apify under the hood.
If search_facebook_ads is not in the tool list, stop and tell the user to enable Hyper MCP and connect Apify.
Tool surface
| 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. |
Critical rules
- Public-only data. The Meta Ads Library is public. Don't attempt to bypass any access control or scrape private content.
- Count limits differ between tools.
search_facebook_adsallowscountup to 40.search_facebook_ads_enrichedcaps at 20 — exceeding this returns an error. get_facebook_ad_detailsneeds two IDs. Bothad_archive_idandpage_idare required. Both are returned in everysearch_facebook_adsresult row — pass them through together.- Enriched search is slow. It makes a Facebook page scrape per ad and optionally a website scrape. Only use it when contact info matters (lead-gen workflows). For pure ad intelligence, use the regular
search_facebook_ads. - Apify-backed tools fail intermittently. Expect occasional
"fetch failed"responses. Retry once after a short delay before reporting the source as missing. - Don't over-interpret a single ad. "Brand X is running a discount" is noise. "5 of the top 10 advertisers in this query are running discounts" is signal. Always aggregate before drawing conclusions.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago First seen · 156 lines · 90 tokens per session scan A 8925637b434f
meta-ads-library is a skill published in the GitHub repository hyperfx-ai/marketing-skills (86 stars, last pushed 16d ago), licensed MIT. It adds 90 tokens to every session and 2,005 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
adspirer-ads-agent
Adspirer — AI-powered advertising and performance marketing agent. Manage Google Ads, Meta Ads (Facebook & Instagram), LinkedIn Ads, and TikTok Ads via natural language. 100+ tools for paid media campaign creation, live performance analysis, PPC keyword research with real CPC data, budget optimization, ad creative…
adcp-advertising
Automate advertising campaigns with AI. Create ads, buy media, manage ad budgets, discover ad inventory, run display ads, video ads, CTV campaigns, and optimize ad performance. Perfect for marketing automation, programmatic advertising, media buying, ad management, campaign optimization, creative management, and…
_mureo-shared
Skill "_mureo-shared" from logly/mureo, covering mureo shared patterns, installation, setup, claude code (recommended) and manual configuration.
_mureo-strategy
Strategy Context: Manage business strategy files (STRATEGY.md, STATE.json) for strategy-driven ad operations.
daily-check
Run a daily health check on all configured ad accounts (Google Ads, Meta Ads, Amazon Ads, TikTok Ads, Search Console, GA4, and any configured plugin platform). Use when the user asks for a daily review, health check, status update, anomaly detection, or 'how are my campaigns doing today'. Reads STRATEGY.md and…
_mureo-google-ads
Google Ads: Manage campaigns, ad groups, ads, keywords, budgets, and performance analysis.