meta-ads · hoodini — Claude Code skill: Meta Ads through the Marketing API
meta-ads runs Meta campaigns end to end: pixel, launch, reading the numbers, fixing what leaks. Pulls and changes your ad account through the Marketing API.
no license ★ 301 updated 2026-10-23
npx skills add hoodini/ai-agents-skills --skill meta-ads -a claude-codeWhat meta-ads does
The skill covers Meta advertising from the pixel to the daily campaign check. It ships Python scripts that talk to the Marketing API: auth_check.py for access, check_pixel.py to find the pixel on funnel pages, funnel_report.py for conversion by funnel step broken down by placement and age, create_campaign.py to build a Sales campaign.
Reads through GET are harmless. Every write, whether that is a pause, a budget move, a duplicate or a new campaign, waits for explicit confirmation; the rules sit in references/write-actions.md. Spend can also be reconciled with real sales from Schooler MCP, and past buyers or people who signed up without paying become recovery campaigns.
Python and the requests package are required. If the first call fails with ProxyError or Tunnel connection failed: 403, run the scripts on your own machine instead of the sandbox, on macOS, Windows or Linux. Click-to-WhatsApp is not its own surface: those ads run in Facebook and Instagram placements and appear in the API as destination_type=WHATSAPP, so there is no separate dashboard for them.
What it helps with
- verify the pixel fires on every funnel page
- launch a Sales campaign with creatives and UTM tags
- spot the funnel step where spend leaks
- pause an ad or shift budget after confirming
- build stage-by-stage remarketing with exclusions
Example prompts for the agent
- How are my Meta ads doing over the last 30 days?
- Pause the ad with creative fatigue
- Build remarketing for people who visited but didn't buy
How to install meta-ads
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill meta-ads -a claude-code2Manually: put the files in place
~/.claude/skills/meta-ads/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/meta-ads/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill meta-ads -a codex2Manually: put the files in place
.agents/skills/meta-ads/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill meta-ads -a cursor2Manually: put the files in place
.cursor/skills/meta-ads/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoodini/ai-agents-skills skills/meta-ads2Manually: put the files in place
.github/skills/meta-ads/SKILL.md1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill meta-ads -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/meta-adsManually: put the files in place
.devin/skills/meta-ads/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.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 meta-ads
How do I install meta-ads in Claude Code?
Run npx skills add hoodini/ai-agents-skills --skill meta-ads -a claude-code; the skill lands at ~/.claude/skills/meta-ads/SKILL.md.
What does meta-ads do?
It reads Meta ad data through the Marketing API, breaks conversions down by funnel step, and once you confirm edits campaigns: pause, budget, duplicate, create.
What do I need before running it?
Python with the requests package and Marketing API access. If a proxy blocks the first call, run the scripts on your own machine.
Similar skills
All skills for Marketing and content →meta-ads by other authors comes first.