claude-ads

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="assets/banner-dark.svg">
    <img src="assets/banner-light.svg" alt="Claude Ads: every ad account, one command line" width="100%">
  </picture>
</p>

# Claude Ads

Claude Ads is a free, open source skill for Claude Code. Give it your ad account data and it tells you what is working, what is broken, and what to fix first, across twelve ad platforms.

It is made for agencies, consultants, and in-house marketing teams. It reads your data and reports back. It does not change your accounts on its own.

> [!NOTE]
> You can get Claude Ads from two places: the **public release** at
> [`AgriciDaniel/claude-ads`](https://github.com/AgriciDaniel/claude-ads)
> (MIT licensed, no membership needed), and the **community mirror** at
> `AI-Marketing-Hub/claude-ads`, where
> [AI Marketing Hub Pro](https://www.skool.com/ai-marketing-hub-pro) members
> get early access and direct collaboration.

## Quickstart

1. Install (see [Installation](#installation)): `/plugin marketplace add agricidaniel/claude-ads`, then `/plugin install claude-ads@ai-marketing-hub-claude-ads`.
2. Run `/ads setup` and answer a few questions: your business model, goal, main conversion, monthly spend, active platforms, and who approves changes. Never paste API keys or tokens.
3. Bring evidence: an account export (CSV or JSON), screenshots, or a pasted summary with its date range, currency, and timezone.
4. Run `/ads audit google` (or `/ads audit all`). You get a report that states what passed, what failed, and what is missing.
5. Run `/ads report` to see a past run again, and `/ads next` to see the most important blocker.

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="assets/how-it-works-dark.svg">
    <img src="assets/how-it-works-light.svg" alt="Three steps: tell it about your business, give it your data, then read the audit" width="100%">
  </picture>
</p>

## What you can do

| You want to | Run | You get |
| --- | --- | --- |
| Find out what is wrong | `/ads audit` | A report of passed, failed, and unchecked items, each with its evidence |
| Decide where to spend | `/ads plan` | Channel, budget, measurement, and competitor plans |
| Make ads | `/ads create` | Copy, image, video, and product-photo briefs and assets |
| Keep watch | `/ads monitor` | Checks on pacing, delivery, tracking, ad fatigue, and policy |
| Improve results | `/ads optimize --draft` | Suggested changes, written as drafts |
| Test an idea | `/ads experiment` | A test design, or a readout of a finished test |

## Platforms

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="assets/platforms-dark.svg">
    <img src="assets/platforms-light.svg" alt="Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat and X" width="100%">
  </picture>
</p>

Each platform has its own focused skill, audit worker, control reference, and