AgriciDaniel

claude-ads: Audit Paid Media with Claude Code

Claude Ads is a Claude Code skill for evidence-based paid-media audits and operations across 12 advertising platforms. It produces versioned reports and keeps account changes as drafts unless explicit safety gates allow them.

View on GitHub Compare
Stars
10.4k
Forks
1.5k
Stars, last 30 days
+1,035
Last commit
6 days ago
Contributors
2

Our take

Activeregular commits and releases

Health score

43/100

How it is scored
Activity
66
Community
12
Issues
51
Pull requests
42

+1,035 stars in the last 30 days

  • Fewer contributors than 86% of the projects we track

Claude Ads is an actively maintained, MIT-licensed Claude Code skill with substantial release activity, but its disabled scoring profiles and highly concentrated contributor base call for careful review before operational adoption.

Good fit if

  • You use Claude Code and want evidence-backed reviews across the supported ad platforms.
  • Your team can provide account exports or other evidence and prefers proposed changes to remain drafts by default.
  • You can review the project’s development-candidate status and validate its behavior for your workflow.

Look elsewhere if

  • You need approved account-health scores now, since all 12 scoring profiles are disabled.
  • You need a verified runtime other than Claude Code, since other host targets are marked experimental.
  • You require a project with a broader contributor base, since most contributions come from one person.
All health signals
Last commit2026-10-17 (6 days ago)
Commits, last 90 days43
Releases, last 12 months18 (latest v2.1.0, 2026-10-16)
Contributors2 (top contributor: 98% of commits)
Issues closed, last 90 days24 (typically closed in 95 days)
Pull requests merged, last 90 days4 (typically merged in 1 day)
Project age8 months

Checked on 2026-10-24 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

10,967

Forks

1,591

Change since Nov 11, 2026: +40 stars·+4 forks

Overview

Claude Ads is a Claude Code skill for paid-media operations, built around Claude Code and implemented with Python. It helps agencies, consultants, and in-house marketing teams understand what is working, what is broken, and what to address first across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, and X.

It analyzes supplied account exports, screenshots, or summaries rather than changing accounts by default. Findings are tied to evidence, missing information is reported as unknown instead of guessed, and audits are saved as versioned JSON that can also be rendered as Markdown, HTML, or PDF.

Key Features

  • Audit all platforms or focus on a specific platform or scope, with findings marked pass, fail, unknown, or not applicable.
  • Build channel, budget, competitor, and measurement plans, and create ad copy and creative briefs.
  • Monitor pacing, delivery, tracking, ad fatigue, policy, and performance.
  • Draft campaign launches and optimization suggestions without applying them automatically.
  • Design experiments or summarize completed tests.
  • Save validated, versioned audit runs and render reports in several formats.
  • Gate account changes on tested capabilities, explicit IDs, human approval, before-and-after diffs, and rollback and verification requirements.

Use Cases

  • An agency consultant can review a client's exports across multiple ad platforms and identify which findings are supported by evidence and which need more data.
  • An in-house marketer can investigate pacing, tracking, delivery, or policy concerns before deciding what to change.
  • A team planning a new campaign can use the channel, budget, and measurement planning workflows to structure its proposal.
  • A marketing lead can create optimization drafts for owner review without giving the skill default authority to change accounts.

What you need

Detected in the repository

  • Python >=3.11 (from pyproject.toml)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

In Claude Code, add the marketplace and install the plugin:

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

Then run /ads setup and provide account evidence before starting an audit. See the repository README for setup, release verification, and platform details.

Considerations

The project describes itself as a development candidate, and its release requirements must pass before it is considered release-ready. Recent commits and frequent releases indicate active work, but the contributor base is small and strongly concentrated in one person. Issue closure is relatively slow, so account for that when relying on maintainer support.

Audits do not currently produce health scores because every platform scoring profile is disabled. Only Claude Code is verified; the README labels other host targets experimental. Managed dependencies require CPython 3.11 or 3.12, while browser capture and PDF output have additional host dependencies. The MIT license covers the project’s code and documentation, not the separate terms for third-party APIs, trademarks, or documentation.

Found this useful?

Share it with someone who would like claude-ads.