Claude Ads
A free Claude Code skill that turns Claude into your in-house paid-ads team — audits, plans, scores, reports.
What is this? (in plain English)
You know how you can ask Claude to review your code? Claude Ads is the same idea, but for paid advertising. Install it once, and Claude gets a brain transplant: it now knows Meta, Google, and TikTok Ads at a senior-strategist level — the 3 platforms where 95% of advertiser spend lives — with ~158 specific checks, 8 industry templates, and the ability to write you a real audit report at the end. Free-first: all 3 platforms have free community MCPs and free direct-API adapters.
You drop in your ad data (an export, a screenshot, or just paste your numbers), type a command like /ads audit, and Claude runs three deep-specialist analysts in parallel — one per platform. You get back a 0–100 health score, a prioritized punch list of what to fix, and (optionally) a polished PDF report you can hand a client.
It's not a magic button that runs your ads for you. It's a senior-level reviewer that lives inside your terminal, knows what's broken before you do, and never forgets to check the boring things (Consent Mode V2, CAPI, learning-phase rules, kill thresholds). And in v2.0+, it can update its own knowledge base monthly so it doesn't go stale.
New in v2.4.0 — /ads start walks first-time users from cold install to a working audit pipeline (context, OAuth, verification), and /ads next ranks Quick Wins after every audit so you always know exactly what to fix next.
Quick start (90 seconds)
Plugin install (recommended) — registers as a native Claude Code plugin with auto-updates:
/plugin marketplace add Hainrixz/claude-ads
/plugin install claude-ads@tododeia-claude-ads
Or one-liner install (Unix / macOS / Linux):
curl -fsSL https://raw.githubusercontent.com/Hainrixz/claude-ads/main/install.sh | bash
Or one-liner install (Windows PowerShell):
irm https://raw.githubusercontent.com/Hainrixz/claude-ads/main/install.ps1 | iex
Then open Claude Code and run the first-time wizard:
claude
> /ads start
/ads start asks about your industry, monthly spend, and goals — then walks you through connecting Meta, Google, TikTok one at a time, step by step, with a live verification call after each. Optionally walks you through creating a Meta for Developers account and a Zernio account for /ads publish. Everything is saved to ~/.claude-ads/profile.json, so no future /ads command ever re-asks. When you're done it suggests your next command — usually /ads audit.
Already set up? You can also skip straight to:
> /ads audit # full multi-platform audit
> /ads next # top 3 fixes from your most recent audit
How it works
flowchart LR
U([You]) -->|/ads audit| O[Orchestrator]
O -.dispatches in parallel.-> G[audit-google · 80 checks]
O -.-> M[audit-meta · 50 checks · MCP-wired]
O -.-> T[audit-tiktok · 28 checks]
G & M & T -->|MD + JSON findings| S[Scored report]
S --> R([0–100 health score · prioritized fixes · optional PDF])
