Docs

Claude Ads docs: how to audit your ad accounts.

Everything you need to run your first audit, plus the full, editable source on GitHub.

Quick start

Your first audit in three steps.

01

Install the plugin

Add Claude Ads from the plugin marketplace inside Claude Code.

/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads@agricidaniel-claude-ads
02

Run your first audit

Audit everything at once, or target a single platform. Paste in exports, screenshots, or metrics when prompted.

/ads audit
# or a single platform:
/ads google
03

Get your report

Claude returns a 0–100 health score and a prioritized action plan. Export a client-ready PDF with one command.

/ads report
Full installation options & prerequisites
FAQ

Common
questions.

Does my data leave my machine?

No. The skill runs locally in Claude Code. If you opt into a live MCP integration (e.g. mcp-google-ads), data flows directly from your machine to the platform API, never through us.

Can Claude Ads log into my ad manager automatically?

No. By default Claude Ads analyzes data you provide: platform exports, screenshots, or pasted metrics. It never asks for your ad-account credentials and does not connect to platforms on its own. If you choose to wire up a live MCP integration (for example mcp-google-ads), that connection runs directly between your machine and the platform's API under your control, never through a third party.

Which platforms does it support?

Eight: Google Ads (Search, Performance Max, Display, Demand Gen), Meta (Facebook, Instagram, Advantage+), YouTube, LinkedIn (B2B targeting and Lead Gen), TikTok, Microsoft / Bing, Apple Search Ads, and Amazon Ads (Sponsored Products, Brands, and Display). Run /ads audit to check all eight in parallel, or target one at a time with its own command such as /ads google or /ads meta.

Is it free?

Yes. Claude Ads is MIT-licensed and fully forkable: you can read, edit, and white-label every audit check and every PDF report. There is no per-seat fee, no credit card, and no paid tier of the plugin itself. The only requirement is a Claude Code subscription to run it, since the audits execute inside Claude Code on your machine.

Is ad posting or campaign creation automated?

No. Claude Ads is an audit and strategy tool. It finds issues, recommends fixes, and builds campaign plans, but creating, editing, or posting ads stays manual.

How is this different from a commercial PPC audit tool?

Three things: it's local-first with no data uploaded anywhere; it's MIT-licensed and forkable so you can edit the checks; and it tracks 2026-current platform changes where commercial tools can lag by 6–12 months.

Can I use it for client work as an agency?

Yes. The MIT license allows it, and you can white-label the PDF reports produced by /ads report. Many agencies run it in the first 48 hours of a new client to benchmark the account before taking over.

How do I audit my Google Ads account for free?

Install the Claude Ads plugin in Claude Code, point it at your account (paste an export or use your own MCP connection), and run /ads google. In 10–15 minutes you get a 0–100 health score and a prioritized fix list across roughly 80 Google Ads checks. It is free and MIT-licensed; the manual equivalent typically takes a senior analyst 4–6 hours.

Is there a free tool to find wasted ad spend?

Yes. Claude Ads flags wasted spend, including broad-match leakage, missing negative keywords, untracked conversions, and redundant keywords, and ranks each finding by how much it is costing you, as part of a 250+ check audit. It is free, open-source, and runs locally; the only requirement is a Claude Code subscription.

Is it safe to run my ad data through Claude or ChatGPT?

With Claude Ads, your data never leaves your machine. The audit runs entirely inside your local Claude Code session. Nothing is uploaded to any server and there is no Claude Ads account or login. And because it runs a fixed 250+ check list, you get the same audit every run, not a different answer each time you rephrase a prompt.

Is there an open-source alternative to Optmyzr or Adalysis?

Yes: Claude Ads. It is MIT-licensed and forkable, runs locally with no account access, and covers 8 platforms with 250+ checks, with no $99–$1,000/month subscription. You can read and edit every audit check yourself.