An open-source AI ad manager that replaces 20 minutes of Ads Manager clicking with a 2-minute summary over coffee.

Built with OpenClaw — the AI agent framework.

Monitor → Detect Fatigue → Find Winners → Shift Budget → Generate Copy → Upload to Meta → Repeat

This kit automates your entire Meta Ads workflow:

• Morning briefing — Spend pacing, active campaigns, 7-day trends
• Find bleeders — Ads with high spend + low CTR bleeding your budget
• Spot winners — Top performers ready to scale
• Detect fatigue — CTR declining, frequency climbing, CPC rising
• Generate copy — AI writes ad copy matched to your actual image creatives
• Upload to Meta — Push new ads straight to your account via Graph API
• Pixel + CAPI audit — Audit your tracking setup, test server-side events, optimize for 9.3+ Event Match Quality
• Take action — Pause, resume, adjust budgets (always with your approval)

The result: A full ad management loop -- from monitoring to creative refresh to tracking optimization -- without opening Ads Manager.

I've spent 20 years in marketing. Scaled Fireball Whisky from one state to a billion-dollar global brand. Ran campaigns for Heineken, Hennessy, Buffalo Trace. Now I run Emerald Digital, an AI-first marketing agency.

Here's what I learned: 90% of ad management is pattern recognition. Spend trending up or down. CTR declining (creative fatigue). CPA spiking (audience exhaustion). Winners emerging. Losers bleeding.

You don't need to stare at Ads Manager to spot these patterns. An AI agent can do it and tell you what matters.

I'm open-sourcing this because every founder running Meta ads deserves a copilot.

git clone https://github.com/themattberman/meta-ads-kit.git
cd meta-ads-kit

# Install social-cli (the engine under the hood)
npm install -g @vishalgojha/social-cli

# Authenticate with Meta
social auth login

# Set your default ad account
social marketing accounts
social marketing set-default-account act_YOUR_ACCOUNT_ID

# Copy config
cp .env.example .env
cp ad-config.example.json ad-config.json

# Edit ad-config.json with your benchmarks

See SETUP.md for detailed instructions.

The core of the system. Five questions that replace Ads Manager:

# Run all 5 questions
./run.sh daily-check

# Or with OpenClaw agent
openclaw start
# Then message: "Daily ads check"

Each skill can run standalone or as part of the daily routine.

The five skills chain together into a closed loop:

Monitor (meta-ads) → Detect fatigue (ad-creative-monitor) → Shift budget (budget-optimizer)
    → Generate new copy (ad-copy-generator) → Upload to Meta (ad-upload) → Monitor again

Pixel + CAPI (pixel-capi) runs alongside: audit tracking, test server events, optimize EMQ

No Ads Manager required at any step.

┌──────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│  Daily Check │───▶│   Patterns   │───▶│    Budget     │───▶│  Copy Gen    │───▶│   Upload     │
│  (5 questions│    │  & Fatigue   │    │  Optimizer    │    │  (per image) │    │  (Graph API) │
└──────────────┘    └──────────────┘    └──────────────┘    └──────────────┘    └──────────────┘
       │                   │                   │                   │                   │
       ▼                   ▼                   ▼                   ▼                   ▼
 Spend pacing        Bleeders 🩸         Shift budget       Copy matched to      Push ads live
 Active campaigns    Winners 🏆          Scale winners      each creative        No Ads Manager
 7-day trends        Fatigue 😴          Cap losers         asset_feed_spec      Image + copy

Morning (automated via cron):

1. Run daily-check — flag bleeders, winners, and fatigue
2. Send strategist-level briefing to Slack/Telegram with recommendations and new creative concepts
3. You approve from your phone

When you need new creatives:

1. Generate copy matched to specific image creatives
2. Review the variants
3. Upload directly to Meta — images, copy, and all

You (2 minutes over coffee):

1. Read the summary
2. Approve/reject recommendations
3. Done.

This kit is built for OpenClaw, an open-source AI agent framework.

# Install OpenClaw
npm install -g openclaw

# Set up the agent
cd meta-ads-kit
openclaw start

Then just message it naturally:

• "How are my ads doing?"
• "Any bleeders I should pause?"
• "Which ads should I scale?"
• "Check for creative fatigue"
• "Show me performance by age and gender"
• "Pause ad 12345678"

The agent handles the orchestration, interprets the data, and asks before taking any action.

Set up a daily cron in OpenClaw:

"Run my daily ads check every morning at 8am and send me the summary"

The agent will run the 5 questions, analyze the results, and message you with findings + recommendations. You approve from your phone.

Edit ad-config.json to set your benchmarks:

{
  "account": {
    "id": "act_123456789",
    "name": "My Brand"
  },
  "benchmarks": {
    "target_cpa": 25.00,
    "target_roas": 3.0,
    "max_frequency": 3.5,
    "min_ctr": 1.0,
    "max_cpc": 2.50
  },
  "alerts": {
    "bleeder_ctr_threshold": 1.0,
    "bleeder_frequency_threshold": 3.5,
    "fatigue_ctr_drop_pct": 20,
    "spend_pace_alert_pct": 15
  },
  "reporting": {
    "default_preset": "last_7d",
    "timezone": "America/New_York"
  }
}

Or just tell the OpenClaw agent your benchmarks conversationally — it'll figure it out.

Your Meta ad spend is separate — this kit just helps you manage it smarter.

meta-ads-kit/
├── README.md              # You're here
├── SETUP.md               # Detailed setup guide
├── run.sh                 # Report runner
├── .env.example           # Environment template
├── ad-config.example.json # Benchmarks template
├── skills/
│   ├── meta-ads/             # Core reporting & actions
│   ├── ad-creative-monitor/  # Creative fatigue tracking
│   ├── budget-optimizer/     # Spend efficiency analysis
│   ├── ad-copy-generator/    # AI copy matched to image creatives
│   ├── ad-upload/            # Push ads to Meta via Graph API
│   └── pixel-capi/           # Pixel + CAPI audit, testing, EMQ optimization
│       ├── scripts/          # pixel-audit, pixel-setup, capi-test, capi-send, emq-check
│       └── references/       # Complete pixel + CAPI knowledge base
├── SOUL.md                # Agent personality (for OpenClaw)
├── AGENTS.md              # Agent instructions
└── SPEC.md                # Full system spec

This is open source. PRs welcome.

Ideas for contribution:

• Google Ads support (social-cli may add this)
• Creative performance dashboards
• Automated A/B test analysis
• Multi-account agency mode
• Slack/Discord notification integrations

MIT License. Use it, fork it, build on it.

Built by Matt Berman.

• 🐦 Twitter/X: @themattberman
• 📰 Newsletter: Big Players
• 🏢 Agency: Emerald Digital

Stop babysitting Ads Manager. Let your AI copilot do the watching.

Star the repo if this helps. It tells me to keep building.