Claude Ads

Domain

Paid-media audits, plans and creative across major ad platforms, with cited evidence, versioned JSON reports and gated account changes.

by AgriciDanielAgriciDaniel/claude-ads

Stars10.3k

Forks1.5k

Watchers78

Open issues5

LicenseMIT

Last push5 days ago

Install

install

$ /plugin marketplace add agricidaniel/claude-ads

Update

update

$ /plugin marketplace update ai-marketing-hub-claude-ads

Then /reload-plugins. From a shell: `claude plugin marketplace update ai-marketing-hub-claude-ads`. Added it before v2.0.0? Remove the old `agricidaniel-claude-ads` marketplace first.

When to use it

You run paid media (PPC, social, retail media) and want repeatable audits instead of ad-hoc account reviews
Auditing or planning across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, or X
You need a versioned, defensible report — deterministic findings, cited evidence, and controls — to hand a client or stakeholder
Working on attribution, server-side tracking, or cross-platform conversion reconciliation
Reviewing ad creative for fatigue and fit, or generating image assets from a creative brief
You want account changes gated behind explicit approval rather than an agent editing live campaigns unprompted

Commands & flags

/claude-ads:ads: Conductor: routes a paid-media request to the right platform and lifecycle skill.
/claude-ads:ads-audit: Source-grounded account audit with deterministic findings, evidence coverage and a versioned JSON report.
/claude-ads:ads-plan: Build a media plan: budgets, channel mix, structure and forecast.
/claude-ads:ads-google: Google Ads audit, read-only: search terms, PMax, bidding, conversion tracking.
/claude-ads:ads-meta: Meta Ads audit, read-only: Pixel/CAPI, creative fatigue, audiences, placements.
/claude-ads:ads-creative: Cross-platform creative review: fit, concept diversity, fatigue, refresh calls.
/claude-ads:ads-generate: Generate ad image assets from a validated creative brief, through an image provider you configure.
/claude-ads:ads-attribution: Reconcile conversion taxonomy, attribution windows and cross-platform data.
/claude-ads:ads-monitor: Ongoing review of pacing, delivery, tracking, creative fatigue, policy and anomalies.
/claude-ads:ads-optimize: Bid and budget changes grounded in evidence: drafted by default, applied only when you ask.

How to use it

Add the marketplace and install the plugin inside Claude Code:

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

From a shell, claude plugin marketplace add and claude plugin install take the same arguments. Plugin commands are namespaced, so each one starts with /claude-ads::

/claude-ads:ads audit google

Two ways in. /claude-ads:ads is the conductor: it routes the request to the right platform and lifecycle skill. Or call a skill directly: one per platform (/claude-ads:ads-google, /claude-ads:ads-meta, …) plus lifecycle skills for audits, planning, creative, measurement and operations.

Under the hood. Audits fan out to one worker per selected platform, plus cross-platform workers for tracking, creative, budget and policy when their inputs exist. Findings are deterministic, and the Markdown, HTML and PDF reports are renderings of the same versioned JSON bundle. Account changes stay drafts until the full mutation gate passes: a granted capability, explicit IDs, a before/after diff, owner approval, rollback and verification.

Before you rely on it. Reading an account needs that platform's API credentials; /claude-ads:ads-setup stores references to them, never the values, so don't paste tokens into the chat. /claude-ads:ads-generate sends briefs to the image provider you configure, and /claude-ads:ads research refresh fetches platform, policy and benchmark sources. Claude Code is the only verified runtime: the installer's Codex, Gemini, Cursor, Windsurf and Goose targets are experimental.

Why it earns its place

Most "run my ads" agents improvise: they eyeball an account, output plausible advice, and give you a different answer every time. Claude Ads is built the opposite way. Its skills are source-grounded: findings cite evidence, and platform claims need a dated source. Audits run one worker per selected platform, plus cross-platform workers for tracking, creative, budget and policy, each returning schema-valid results. Findings are deterministic and reports are versioned JSON, so results are defensible to a client, not a fresh guess per run. It covers the whole lifecycle across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat and X: audit, plan, creative, launch, monitor, optimize, attribution and reporting. It analyzes and plans freely, and keeps account changes as drafts until the full mutation gate passes.

MIT-licensed. Upstream calls the current version a development candidate, not release-ready, and keeps account-health scores disabled until a scoring policy is approved.

Try it

claude

> /claude-ads:ads audit google