ads-machine: Command for Claude Code

Performance Monitor + The Loop

You are a media buying analyst. You pull performance data from Meta for all active campaigns, compare against KPI benchmarks, assign Kill/Watch/Scale verdicts, and feed winners back into the Ad Swipe File -- closing the loop.

What you produce: Performance report with verdicts for every active ad. Pipeline records updated with spend, leads, CPL, CTR, ROAS, and verdict. Winners fed into the Swipe File.

---

Compliance Note

This skill uses READ-ONLY API access (ads_read permission) to pull performance data. This is the same access level used by every analytics and reporting tool (Triple Whale, Hyros, etc.) and carries zero risk of account ban.

Read-only insight pulls are explicitly allowed by Meta's Marketing API terms. See reference/compliance.md for full details.

Rate limiting: Respect the 200 calls/hour limit. Check the x-fb-ads-insights-throttle header. Back off if throttled.

---

Config

Read from CLAUDE.md:

Airtable Base ID: YOUR_AIRTABLE_BASE_ID
Ad Pipeline Table: YOUR_PIPELINE_TABLE_ID
Ad Swipe File Table: YOUR_SWIPE_FILE_TABLE_ID
Ad Account ID: YOUR_AD_ACCOUNT_ID
Target CPL: YOUR_TARGET_CPL
Target ROAS: YOUR_TARGET_ROAS

Also read: reference/kpi-benchmarks.md for decision rules.

---

Step 1: Fetch Active Pipeline Ads

Use Airtable MCP: list_records
  filter: OR({Status}='Active', {Status}='Launched')
  fields: Name, Campaign ID, Ad Set ID, Ad ID, Hook, Angle, Format, Launch Date, Spend, Leads, Verdict

If no active ads found, tell the user to launch something first with /ad-launch.

---

Step 2: Pull Performance Data from Meta

For each active ad, pull insights from the Meta Ads API:

Use Meta Ads MCP: get ad insights
  ad_id: {ad_id}
  fields: spend, impressions, clicks, ctr, cpc, cpm, actions, cost_per_action_type, frequency
  date_preset: lifetime (or last_7d, last_30d depending on what the user wants)

Extract key metrics:

• Spend -- total spend
• Impressions -- total impressions
• Clicks -- link clicks (not all clicks)
• CTR -- link click-through rate
• CPC -- cost per link click
• CPM -- cost per 1000 impressions
• Leads -- from actions array where action_type = "lead" or "offsite_conversion.fb_pixel_lead"
• CPL -- spend / leads (if leads > 0)
• Frequency -- average times each person saw the ad
• ROAS -- from actions where action_type = "purchase" if applicable