# 06 · Claude Meta Ads Manager

It pulls all the granular reporting from Meta Ads Manager and compares it with the analytics tracking apps you
use. Reports in minutes instead of hours. It can also write new ads, always paused, with a daily cap and a
weekly ceiling you set.

**For your AI:** walk me through building this one step at a time. Ask what I sell, where the sales are recorded,
and which analytics I use first. Don't move on until the current step works.

## First, check

- Do you spend real money on Meta ads every month, or pay someone to report on them?
- Do you know where each sale is recorded (your shop, Stripe, your platform)? Without that, the tool only
  repeats what Ads Manager already shows.

## What you need

- A Meta Business account with your ad account in it.
- A system user in Business Settings with a token for the Marketing API (read access first; write access later).
- Access to where your sales are recorded (Stripe, your shop or your platform's database).
- Your analytics (for example Vercel Analytics, Google Analytics, Microsoft Clarity).
- Claude Code or another AI that can run commands on your computer.

## Where it runs

On your computer, as a small command-line tool. Nothing needs to be online.

## The steps

1. **Read only, first.** Connect with a read token. List campaigns, ad sets and ads with their spend.
2. **The breakdowns.** Pull results by age, gender, country, platform and placement. This is where Ads
   Manager hides what matters.
3. **Join the sales.** Match spend to real orders from your sales records, by campaign and by date.
4. **Join the analytics.** Match clicks to what visitors actually did on your site: pages, time, where they left.
5. **The report.** One question at a time: "what did this campaign really sell, and who clicked?" Your AI
   writes the answer in plain words with the numbers under it.
6. **Write access, later.** Only once the reports are right. Every new ad is created paused. A daily cap and
   a weekly ceiling the tool refuses to go over. Every write is logged.

## Checklist before you rely on it

- [ ] Nothing it creates spends money until you switch it on yourself in Ads Manager.
- [ ] The caps are in the code, not only in your head.
- [ ] Every number in a report says where it came from and for which dates.
- [ ] Read the countries you sell to, not the whole world: cheap clicks elsewhere skew every average.
- [ ] Tokens live in a secure place, never in a file or chat.
- [ ] Before the tool writes any ad, set a spending limit on the ad account itself.