YSY-99/meta-ads-api-field-guide

README preview

# Meta Ads Field Guide for Claude Code

> **Claude Code + Meta Ads without disasters.** A drop-in skill, 3 subagents, and safety hooks that let marketers run Facebook/Instagram campaign automation safely — built on 4,800+ lines of battle-tested Meta Marketing API field notes.

Marketers are using Claude Code to automate Meta Ads work: creating campaigns, pulling insights, scaling budgets, analyzing creatives. But the LLM doesn't know that:

- Changing a budget by more than 20% silently resets your Learning Phase
- The same image hash from another ad account will render as a placeholder (no error)
- `CONVERSIONS` and `LINK_CLICKS` objectives are deprecated — new campaigns need `OUTCOME_*`
- Editing 5+ budgets in an hour locks the ad set for 60 minutes
- Most MCP servers let you create ads with `status: "ACTIVE"` by default

So Claude makes confident, expensive mistakes.

This repo fixes that. **Copy one folder into your project** and Claude Code suddenly:

- **Blocks** any API call that would create non-PAUSED ads (via `PreToolUse` hook)
- **Follows** a Research → Synthesis → Implementation → Verification workflow with a user-approval gate
- **Loads** the right field guide page for the current task (rate limits, insights, budgets, creatives, etc.)
- **Knows** the 23 production pitfalls that Meta's official docs don't warn you about

View full repository on GitHub →