# meta-ads

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 301 repo stars
- Author: hoodini
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/meta-ads/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/hoodini-meta-ads

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill meta-ads -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/meta-ads/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/meta-ads/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill meta-ads -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/meta-ads/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill meta-ads -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/meta-ads/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hoodini/ai-agents-skills skills/meta-ads
```

2. **Manually: put the files in place**
- File: `.github/skills/meta-ads/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill meta-ads -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/meta-ads
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/meta-ads/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/meta-ads/SKILL.md

## When to use it
- 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
- 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

## Similar
- [ads-meta](https://affpapa.org/en/nevibecode/skills/ads-meta.md) — skill · 5500 installs
- [KonQuest Meta Ads MCP](https://affpapa.org/en/nevibecode/mcp/konquest-meta-ads-mcp.md) — MCP server · ★ 44 repo stars
- [meta-ads-strategy](https://affpapa.org/en/nevibecode/skills/meta-ads-strategy.md) — skill · 613 installs
- [pp-meta-ads](https://affpapa.org/en/nevibecode/skills/pp-meta-ads.md) — skill · 112 installs
- [meta-ads-creative](https://affpapa.org/en/nevibecode/skills/meta-ads-creative.md) — skill · ★ 4288 repo stars
- [meta-ads-audit](https://affpapa.org/en/nevibecode/skills/meta-ads-audit.md) — skill · ★ 4288 repo stars

## Other versions with the same name
- [meta-ads · arnabbagxd](https://affpapa.org/en/nevibecode/skills/arnabbagxd-meta-ads.md) — 2000 installs
- [meta-ads · kostja94](https://affpapa.org/en/nevibecode/skills/meta-ads.md) — 2300 installs
- [meta-ads · nowork-studio](https://affpapa.org/en/nevibecode/skills/nowork-studio-meta-ads.md) — ★ 4288 repo stars
- [meta-ads · boringmarketer](https://affpapa.org/en/nevibecode/skills/james-dickerson-at-boringmarke-meta-ads.md) — ★ 778 repo stars

From the same set: [hoodini/ai-agents-skills](https://affpapa.org/en/nevibecode/by/hoodini/ai-agents-skills.md) — 34 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
