StackMap
Subscribe
Explore / claude-ads
AgriciDaniel

claude-ads

Paid-media operations skill for Claude Code across 12 ad platforms — source-grounded audits with deterministic scoring, versioned JSON reports, and account changes gated behind approval and rollback.

7,115 1,056 Python MITupdated 3 days ago
Curator's take

The engineering discipline is the story here, rare in marketing tooling: read-only by default, and a live account change requires a tested capability, explicit IDs, a before/after diff with blast radius, owner approval within ceilings, an idempotency key, rollback and post-verification — miss one gate, no write. Scoring is honest too: unknown controls reduce evidence coverage instead of inflating health, and a failed platform makes the run explicitly partial. Twelve platforms from Google/Meta to Amazon/Reddit, each with its own skill, worker and capability manifest. For agencies and in-house performance teams who live in Claude Code. NOT plug-and-play: you bring real platform credentials, Python 3.11/3.12, and WeasyPrint for PDFs. Dual-homed with a paid community mirror — the public MIT release is the real, complete thing.

Mapped by ShipWithAI editors · links verified
README.md

Claude Ads, Claude-first paid-media operations across twelve advertising platforms

Claude Ads

Claude-first, portable paid-media operations for agencies, consultants, and in-house performance teams.

Claude Ads turns authorized exports or account reads into source-grounded audits, plans, creative workflows, experiments, monitoring, and reports. It is read-only by default. Live changes stay disabled until the exact platform and operation pass approval, idempotency, verification, audit, and rollback gates.

[!NOTE] Claude Ads ships from two homes: the public release at AgriciDaniel/claude-ads (MIT, no membership required) and the community mirror at AI-Marketing-Hub/claude-ads, where AI Marketing Hub Pro members get early access and direct collaboration.

Validated inputs flow through bounded workers into schema-valid findings and deterministic reports

What it does

  • Audits paid-media accounts with dated evidence and explicit confidence.
  • Plans campaigns, channels, budgets, measurement, and experiments.
  • Creates copy, image, video, and product-photo briefs and assets.
  • Monitors pacing, delivery, tracking, fatigue, policy, and performance.
  • Produces versioned JSON, then renders Markdown, HTML, and optional PDF.
  • Drafts safe account changes without applying them by default.
  • Reports missing data, stale sources, contradictions, and partial failures.

Platforms

Twelve first-class paid-advertising platform surfaces

Segment Platforms
Search, video, and social Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Advertising, Reddit Ads, Snapchat Ads, X Ads
Commerce and retail media Apple Ads, Amazon Ads, Pinterest Ads

Each platform has a focused skill, audit worker, control reference, capability declaration, and testable routing surface. The capability manifest is the authoritative record for live reads and writes.

Commands

Standalone installs use /ads. Claude Code plugins are namespaced and use /claude-ads:ads. Both load the same ads/SKILL.md contract.

Command Outcome
/ads setup Create the client, account, KPI, privacy, and guardrail profile
/ads audit [all|platform|scope] Run a complete or scoped evidence-backed audit
/ads plan Build channel, campaign, budget, competitor, and measurement plans
/ads create Produce copy, image, video, or product-photo assets
/ads launch --draft Draft a campaign mutation plan without changing the account
/ads monitor Review pacing, delivery, tracking, fatigue, policy, and performance
/ads optimize --draft Draft evidence-backed optimization changes
/ads experiment Design or read out a controlled test
/ads report Render a validated JSON run bundle
/ads research refresh Refresh platform, policy, API, benchmark, and ecosystem evidence
/ads validate Validate contracts, runs, capabilities, maturity, or release readiness
/ads status, /ads next Show current status and the highest-priority blocker

Platform shortcuts such as /ads google, /ads meta, /ads amazon, and /ads reddit route to the matching platform audit.

Demo

Claude Ads command discovery inside Claude Code

The GIF shows the original command-discovery experience. The v2 command table above and the platform table are current and authoritative.

Installation

Claude Code is the canonical runtime. Codex, Gemini, Cursor, Windsurf, Goose, and compatib

Continue your stack

What teams reach for next — and why each earns a place beside claude-ads. Ranked by curator confidence.