Documentation Index
Fetch the complete documentation index at: https://mintlify.com/TheMattBerman/meta-ads-kit/llms.txt
Use this file to discover all available pages before exploring further.
Get Meta Ads Kit running and see your first daily briefing in 10 minutes.
Prerequisites
Before starting, make sure you have:
- Node.js 14+ installed
- A Facebook account with access to a Meta ad account
- Permission to read ad insights (most ad account admins have this)
Step 1: Clone the repository
git clone https://github.com/themattberman/meta-ads-kit.git
cd meta-ads-kit
Step 2: Install social-cli
social-cli is the open-source engine that talks to the Meta Marketing API.
npm install -g @vishalgojha/social-cli
Step 4: Set your ad account
List your available ad accounts:
social marketing accounts
ID: act_123456789, Name: My Brand
ID: act_987654321, Name: Client Account
social marketing set-default-account act_YOUR_ACCOUNT_ID
cp ad-config.example.json ad-config.json
ad-config.json with your benchmarks:
{
"account": {
"id": "act_YOUR_ACCOUNT_ID",
"name": "Your Brand Name"
},
"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
}
}
Don’t know your benchmarks? Leave the defaults — the agent will learn them from your data.
Step 6: Run your first daily check
chmod +x run.sh
./run.sh daily-check
Question 1: Am I on track?
Spend Pacing (Today)
Daily Budget: $500.00
Spent So Far: $127.50 (as of 10:30 AM)
Pace: On track (25.5% of budget, 43% through day)
Question 2: What’s running?
Active Campaigns (3)
- Summer Sale 2026: ACTIVE, $200/day budget
- Retargeting - Cart: ACTIVE, $150/day budget
- Brand Awareness: ACTIVE, $150/day budget
Campaign Performance
1. Summer Sale 2026
Spend: $1,400 | CTR: 2.3% | CPC: $0.87 | Conv: 47 | CPA: $29.79
2. Retargeting - Cart
Spend: $1,050 | CTR: 1.8% | CPC: $1.12 | Conv: 32 | CPA: $32.81
3. Brand Awareness
Spend: $1,050 | CTR: 1.1% | CPC: $0.65 | Conv: 12 | CPA: $87.50
Question 4: Who’s winning and losing?
Winners 🏆
1. Ad #238471234 - Hero Image A
CTR: 3.2% | CPC: $0.72 | Freq: 1.8 | Spend: $287
→ Scale candidate (high CTR, low frequency)
2. Ad #238471567 - Testimonial Carousel
CTR: 2.8% | CPC: $0.81 | Freq: 2.1 | Spend: $195
→ Strong performer
1. Ad #238472891 - Generic Product
CTR: 0.7% | CPC: $1.89 | Freq: 4.2 | Spend: $312
→ Pause candidate (high frequency, low CTR)
2. Ad #238473102 - Lifestyle B
CTR: 0.8% | CPC: $1.65 | Freq: 3.8 | Spend: $245
→ Review for pause
Question 5: Any fatigue?
Fatigue Signals 😴
Ad #238471234 - Hero Image A
- CTR declining: 3.8% → 3.2% (last 3 days)
- Frequency climbing: 1.8 → 2.3
- Status: Monitor (early fatigue signal)
Ad #238473102 - Lifestyle B
- CTR dropped 40% from peak
- Frequency at 3.8
- Status: Refresh needed
Next steps
Now that you’ve run your first daily check, you can:
Understand the 5 Questions
Learn what each question tells you and how to interpret the data
Explore Skills
Discover all 5 skills from monitoring to creative upload
Take Actions
Pause bleeders, scale winners, and optimize budgets
Automate It
Set up morning briefings with cron or OpenClaw
Running with OpenClaw
For a conversational experience, use OpenClaw:
npm install -g openclaw
cd meta-ads-kit
openclaw start
You: "How are my ads doing?"
You: "Any bleeders I should pause?"
You: "Which ads should I scale?"
You: "Check for creative fatigue"
Set up automated morning briefings: “Run my daily ads check every morning at 8am and send me the summary”
