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.
Install the plugin
Add Claude Ads from the plugin marketplace inside Claude Code.
/plugin marketplace add AgriciDaniel/claude-ads /plugin install claude-ads@ai-marketing-hub-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 spend-weighted 0-100 health score and a prioritized fix plan. Export a client-ready PDF with one command.
/ads report
Reference library
Read 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.
- READMEOverview, full command list, and quick start.
- Thinking frameworkThe audit discipline every analysis follows.
- BenchmarksIndustry benchmarks by platform: CPC, CTR, CVR, ROAS, ACOS.
- MCP integrationWire up live API access (Google Ads, Meta, and more).
- Additional platformsCoverage notes for emerging and adjacent ad networks.
- ChangelogWhat changed in each release.
- ContributingHow to propose checks, fixes, and improvements.
- Security policyReporting vulnerabilities and the data-handling model.
- SupportWhere to get help and the response commitment.
- License (MIT)Free to use, fork, and white-label.
FAQ
Common
questions.
Does my data leave my machine?
No. The skill runs locally in Claude Code. If you opt into a live API connection, data flows directly from your machine to the platform API, never through us. There is no Claude Ads account, login, or server.
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 configure read-only API access, the connection runs directly between your machine and the platform API, under your control.
Which platforms does it support?
Twelve: Google Ads, Meta, YouTube, LinkedIn, TikTok, Microsoft Advertising, Reddit, Snapchat, and X for search, video, and social, plus Apple Ads, Amazon Ads, and Pinterest for commerce and retail media. Run /ads audit to check them in parallel, or target one at a time with its shortcut 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 skill and every 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, since everything runs inside Claude Code on your machine.
Is ad posting or campaign creation automated?
Not silently, and never by default. Claude Ads is read-only out of the box. Version 2 can draft campaign launches and optimizations with /ads launch --draft and /ads optimize --draft. Applying a draft requires your explicit approval through capability-gated adapters with verification and rollback. Permanent deletion is not supported.
How does the scoring work?
Every finding carries an explicit confidence level (high, medium, low, or none) tied to its evidence source, from platform API data down to flagged assumptions. Health scores are 0-100, deterministic, and weighted by spend, so a broken pixel on your biggest platform hurts more. Evidence coverage is tracked separately: 80% or more coverage gives a graded score, 60-79% is provisional, and below 60% the run is marked insufficient rather than pretending to be complete.
How is this different from a commercial PPC audit tool?
Three things: it runs inside your own Claude Code session with no Claude Ads server behind it; it is MIT-licensed and forkable so you can read and edit every skill; and every claim it makes is tied to dated evidence with an explicit confidence level instead of a black-box score.
Can I use it for client work as an agency?
Yes. The MIT license allows it, and you can white-label the reports produced by /ads report. Run it in the first 48 hours of a new client engagement to benchmark the account before you take 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 configure read-only API access), and run /ads google. You get an evidence-backed health score and a prioritized fix list in minutes, free and MIT-licensed. The manual equivalent costs a senior analyst most of a day.
Is there a free tool to find wasted ad spend?
Yes. Claude Ads flags broad-match leakage, missing negative keywords, untracked conversions, and redundant targeting, then ranks each finding by severity and evidence so you fix what costs the most first. 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?
Claude Ads adds no destination for your data: the audit runs inside your own Claude Code session, under the Claude setup you already trust. There is no Claude Ads server, account, or login. And because findings are graded against a deterministic scoring contract, you get a consistent 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 12 platforms with confidence-rated, evidence-backed findings. There is no monthly subscription, and you can read and edit every skill 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 skill. Issues are monitored and most get a response within a few days.
AI Marketing Hub
A free Skool community for templates, walkthroughs, and peer support.
YouTube
Walkthroughs and breakdowns of building ad workflows with Claude Code.
Blog
The maintainer's deep dives on running a paid-ads practice with AI.