Claude Ads docs: how to audit your ad accounts.
Everything you need to run your first audit, plus the full, editable source on GitHub.
Your first audit in three steps.
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-adsRun 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 googleGet your report
Claude returns a 0–100 health score and a prioritized action plan. Export a client-ready PDF with one command.
/ads reportRead the source.
Claude Ads pulls in reference files on demand as it audits. They all live in the repo: open, versioned, and yours to edit.
README
Overview, full command list, and quick start.
Thinking framework
The audit discipline every analysis follows.
Benchmarks
Industry benchmarks by platform: CPC, CTR, CVR, ROAS, ACOS.
MCP integration
Wire up live API access (Google Ads, Meta, and more).
Additional platforms
Coverage notes for emerging and adjacent ad networks.
Changelog
What changed in each release.
Contributing
How to propose checks, fixes, and improvements.
Security policy
Reporting vulnerabilities and the data-handling model.
Support
Where to get help and the response commitment.
License (MIT)
Free to use, fork, and white-label.
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.
Not built alone.
Claude Ads is open source and maintained by Agrici Daniel. Plug into the channels that fit how you work.
GitHub
Star the repo, file issues, and read every check. 48-hour response on issues.
View the repoAI Marketing Hub
A free Skool community for templates, walkthroughs, and peer support.
Join freeYouTube
Walkthroughs and breakdowns of building ad workflows with Claude Code.
WatchBlog
Deep dives on running a paid-ads practice with AI from the maintainer.
Read