TOOLKIT

claude-ads

A Claude Code plugin for paid-media operations across twelve ad platforms: read-only by default, drafts changes it does not apply, and requires six gates before any live mutation.

by Daniel Agrici AgriciDaniel/claude-adsMIT licence9.2k starscommit ac21644read by us 11 September 2026

Twelve platform surfaces (Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Reddit, Snapchat, X, Apple, Amazon, Pinterest), each with a skill, an audit worker and a capability declaration. `/ads audit`, `/ads plan`, `/ads monitor`, `/ads experiment` and `/ads report` read; `/ads launch --draft` and `/ads optimize --draft` produce a change plan without touching the account.

The account-safety section is the reason it is on this shelf. Applying a change needs a tested and enabled capability for that exact operation, explicit IDs, a before-and-after diff with blast radius, owner approval within account ceilings, an idempotency key with rollback, and a precondition check that remote state still matches. Missing ceilings mean no write. Permanent deletion is not supported.

It is a real software dependency: managed Python 3.11 or 3.12, Playwright for browser capture, WeasyPrint and Pango for PDF. Skill-only installs (`--no-deps`) keep the instructions and drop the scripts.

Connects to: your ad accounts on up to 12 platforms, via authorised exports or account reads
Access: read-only by default; writes only through the six-gate approval path; no permanent deletion

Connect

/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

Requires

Claude Code (canonical) or a compatible Agent Skills host
CPython 3.11 or 3.12 for the managed dependencies
Playwright browser payload for capture; WeasyPrint and Pango for PDF
platform credentials in environment variables or a keychain, never in the repo

Safety review, read from the skill text and its scripts
Network	yes	Reads ad platform APIs and, for research, vendor policy and benchmark pages.
Shell	yes	Python workers, an installer script (never piped from a URL, by its own rule), browser capture.
Secrets	yes	Platform credentials, required to be kept in env or a keychain; the README forbids them in profiles, reports and logs.
Deletes	no	Permanent deletion is not supported in v2; uninstall removes only manifest-owned files.

What it exposes

Commands, and which ones change things

Commands: /ads setup /ads audit /ads plan /ads create /ads launch --draft /ads monitor /ads optimize --draft /ads experiment /ads report /ads research refresh /ads validate /ads status /ads next

Writes

gated: launch and optimize without --draft, only through the six-condition path

Pairs with

Skills that work on what it reads

Method behind it

Our Performance Max guide is the kind of audit finding this plugin is built to produce with evidence attached: what PMax reports, what it hides, and which brand queries to pull out of it.

Performance Max: Which Controls You Still Have

Questions

Questions people ask before installing

Is it the same as the ads skill from marketingskills?

No. That is a 4,000-word instruction set; this is a plugin with workers, schemas, scoring code and a control plane for live accounts. Use the skill to think, this to operate.

Will it spend money?

Not by default, and not without the six conditions. Reads and drafts are the normal mode; a write needs an enabled capability, approval within ceilings and a rollback plan.

What does it need on my machine?

Python 3.11 or 3.12, plus Playwright and the PDF libraries if you want captures and PDFs. `--no-deps` installs the skill files alone.