Claude Ads provides a read-only, source-grounded auditing and planning workflow for paid-media across 12 platforms, with versioned JSON outputs and gated change workflows. It supports CLI and Claude Code plugin usage, with multi-platform coverage and structured release history.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Claude Ads is a Claude-first, portable paid-media operations tool that turns account reads into audits, plans, briefs, monitoring, and reports. It renders versioned JSON and can output Markdown, HTML, and optional PDF, while drafting safe changes without applying them by default. It operates read-only by default and enforces gates for live mutations.
How it works
The project uses a conductor-dispatch model where one conductor manages scope, policy, aggregation, and final artifacts, while workers analyze bounded slices to produce schema-valid findings that feed a canonical, versioned JSON bundle. Platforms have dedicated skills, audit workers, capability declarations, and testable routing surfaces. Outputs include JSON, Markdown, HTML, and optional PDF renderings.
Getting started
Install instructions for Claude Code and standalone hosts are provided. Example commands:
/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads
git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local
Or for other hosts:
bash install.sh --target=codex --source=local
bash install.sh --target=gemini --source=local --no-deps
PowerShell:
git clone https://github.com/AgriciDaniel/claude-ads.git
Set-Location claude-ads
.
\install.ps1 -Source local
Uninstall:
bash uninstall.sh --target=claude
Recent releases
Latest releases include:
- v2.0.1 v2.0.1: public mirror release (2026-07-13): Claude Ads v2 goes public. This is a documentation and metadata patch on top of v2.0.0, adapting the release surface for the public re
- v2.0.0 v2.0.0: 12-platform paid-media operating skill (2026-07-13): Major architecture release: professional paid-media operations across 12 advertising platforms, source-grounded and safe by default.
Traction
- 7813 stars
- 1160 forks
- 35 open issues
Behind the repo
The project has a public repository and a community mirror; the README notes two homes and public versus community access. It runs on Python and is MIT licensed.
Caveats
- License: MIT
- Created: 2026-02-11
- Last push: 2026-07-13
- Requires CPython 3.11 or 3.12 for dependencies, with environment-based credential handling and restricted writes (read-only by default; changes gated).