facebook-ads-library-mcp-server — Claude Code skill: setup
Connects Meta Ads Library querying to your AI agent and reviews ad creatives. Helps batch-fetch running campaigns and inspect video strategies across brands.
npx skills add reason-machines/marketing-skills --skill facebook-ads-library-mcp-server -a claude-codeWhat facebook-ads-library-mcp-server does
This tool resolves company names into Meta account identifiers and pulls active ad campaigns. It handles multi-brand queries in batches, cutting down token usage by about 88% when requesting multiple accounts at once.
Built-in functions evaluate imagery and video. The Gemini model handles video review, breaking down storytelling pacing, messaging, and visual structure. Analyzed items get saved into a local cache to prevent redundant requests.
Without a ScrapeCreators key, the server cannot fetch ads. Running video evaluations will also require a separate Gemini API credential.
What it helps with
- retrieve active Meta ads for multiple brands
- inspect competitor video ad pacing and hooks
- extract colors and visual styles from ad banners
- batch query advertising assets across rival companies
Example prompts for the agent
- Fetch all running ads for Nike and Adidas right now
- Inspect the top competitor video ads and break down their script angles
- Check local media cache for ads that feature red banners
How to install facebook-ads-library-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill facebook-ads-library-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/facebook-ads-library-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/facebook-ads-library-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill facebook-ads-library-mcp-server -a codex2Manually: put the files in place
.agents/skills/facebook-ads-library-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill facebook-ads-library-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/facebook-ads-library-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/marketing-skills facebook-ads-library-mcp-server2Manually: put the files in place
.github/skills/facebook-ads-library-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill facebook-ads-library-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/marketing-skills --path skills/facebook-ads-library-mcp-serverManually: put the files in place
.devin/skills/facebook-ads-library-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill facebook-ads-library-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about facebook-ads-library-mcp-server
How do I install facebook-ads-library-mcp-server in Claude Code?
Run npx skills add reason-machines/marketing-skills --skill facebook-ads-library-mcp-server -a claude-code in your terminal.
What does facebook-ads-library-mcp-server do?
It lets AI agents search the Facebook Ads Library, pull live ads for brands, and inspect image and video creatives.
Which credentials are required for this server?
You must configure SCRAPECREATORS_API_KEY to pull ad records. You only need GEMINI_API_KEY if you intend to analyze video files.