The open-source project claude-ads, by AgriciDaniel
“Claude-first paid-media operations skill for Claude Code across 12 ad platforms (Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, X): source-grounded…” — the project's own words, on GitHub
What it does
You hand it your ad account exports from any of twelve platforms — Google, Meta, TikTok, LinkedIn, Microsoft, Reddit, Snapchat, X, Amazon, Apple, Pinterest and YouTube — and it turns them into the work a paid-media analyst would produce: a dated audit of what's actually happening in the account, a channel and budget plan, new ad copy and creative, and a performance report. Every change starts as a draft; it never pushes a budget, bid or live ad to your account without you approving it first. It is for people already spending money on ads who want the analysis, not another dashboard.
Replaces
a paid-media agency's ongoing account management
For
A founder or marketer already spending money on ads across one or more of these platforms who wants agency-grade audits and reports without hiring an agency.
Not for
Not for someone who isn't running paid ads yet, or who can't get a Python 3.11 or 3.12 environment running — the install is a real command-line job, not a one-click plugin.
Setup
40 min · Claude Code, Kimi, Gemini CLI or Codex · Claude Code (or Codex, Gemini, Cursor, Windsurf), Python 3.11 or 3.12, logins or API access for each ad platform you want it to audit
Get it running
Paste this into the AI that runs on your computer. It does the install, checks it works, and tells you what to type first. If anything fails, paste the error back to it.
Paste into Claude Code
Install claude-ads (https://github.com/AgriciDaniel/claude-ads) on this computer and get it working for me. I am not a developer; explain each step in one line as you go and never skip one. You are Claude Code, running on my machine.
1. Check what this machine already has (git, Python or Node as the project needs, Docker if the README says so). Tell me anything missing and install it, asking me before anything that needs my password.
2. Clone https://github.com/AgriciDaniel/claude-ads into ~/tools/claude-ads and follow the README's install exactly.
3. Configure it. If it needs an API key or a login, stop and ask me for it; never guess one and never store it anywhere except where the README says.
Tool-specific notes: Clone it with `git clone https://github.com/AgriciDaniel/claude-ads.git`, then run `bash install.sh --source=local` (or, inside Claude Code, `/plugin marketplace add AgriciDaniel/claude-ads` then `/plugin install claude-ads@ai-marketing-hub-claude-ads`).
It needs Python 3.11 or 3.12: `python3.12 -m venv .venv`, then `.venv/bin/python -m pip install --no-deps -e .` and `.venv/bin/python -m pip install --require-hashes --only-binary=:all: -r requirements.lock`.
Verify with `.venv/bin/python -m pytest -q` and `python -m claude_ads_core --version` — both should pass before you call it installed.
Ask for each ad platform's credentials one at a time and put them in environment variables or the OS keychain, never in a file the repo tracks.
PDF reports need WeasyPrint and Pango on the machine — skip that step if Markdown or HTML output is enough.
4. Run the smallest test the README gives, and show me the output.
5. When it works, tell me what to type first, in one line, for this job: Run an account audit.
If anything fails, show me the exact error and fix it before going on.
Paste into Kimi
Install claude-ads (https://github.com/AgriciDaniel/claude-ads) on this computer and get it working for me. I am not a developer; explain each step in one line as you go and never skip one. You are Kimi, running on my machine.
1. Check what this machine already has (git, Python or Node as the project needs, Docker if the README says so). Tell me anything missing and install it, asking me before anything that needs my password.
2. Clone https://github.com/AgriciDaniel/claude-ads into ~/tools/claude-ads and follow the README's install exactly.
3. Configure it. If it needs an API key or a login, stop and ask me for it; never guess one and never store it anywhere except where the README says.
Tool-specific notes: Clone it with `git clone https://github.com/AgriciDaniel/claude-ads.git`, then run `bash install.sh --source=local` (or, inside Claude Code, `/plugin marketplace add AgriciDaniel/claude-ads` then `/plugin install claude-ads@ai-marketing-hub-claude-ads`).
It needs Python 3.11 or 3.12: `python3.12 -m venv .venv`, then `.venv/bin/python -m pip install --no-deps -e .` and `.venv/bin/python -m pip install --require-hashes --only-binary=:all: -r requirements.lock`.
Verify with `.venv/bin/python -m pytest -q` and `python -m claude_ads_core --version` — both should pass before you call it installed.
Ask for each ad platform's credentials one at a time and put them in environment variables or the OS keychain, never in a file the repo tracks.
PDF reports need WeasyPrint and Pango on the machine — skip that step if Markdown or HTML output is enough.
4. Run the smallest test the README gives, and show me the output.
5. When it works, tell me what to type first, in one line, for this job: Run an account audit.
If anything fails, show me the exact error and fix it before going on.
Paste into Gemini CLI
Install claude-ads (https://github.com/AgriciDaniel/claude-ads) on this computer and get it working for me. I am not a developer; explain each step in one line as you go and never skip one. You are Gemini CLI, running on my machine.
1. Check what this machine already has (git, Python or Node as the project needs, Docker if the README says so). Tell me anything missing and install it, asking me before anything that needs my password.
2. Clone https://github.com/AgriciDaniel/claude-ads into ~/tools/claude-ads and follow the README's install exactly.
3. Configure it. If it needs an API key or a login, stop and ask me for it; never guess one and never store it anywhere except where the README says.
Tool-specific notes: Clone it with `git clone https://github.com/AgriciDaniel/claude-ads.git`, then run `bash install.sh --source=local` (or, inside Claude Code, `/plugin marketplace add AgriciDaniel/claude-ads` then `/plugin install claude-ads@ai-marketing-hub-claude-ads`).
It needs Python 3.11 or 3.12: `python3.12 -m venv .venv`, then `.venv/bin/python -m pip install --no-deps -e .` and `.venv/bin/python -m pip install --require-hashes --only-binary=:all: -r requirements.lock`.
Verify with `.venv/bin/python -m pytest -q` and `python -m claude_ads_core --version` — both should pass before you call it installed.
Ask for each ad platform's credentials one at a time and put them in environment variables or the OS keychain, never in a file the repo tracks.
PDF reports need WeasyPrint and Pango on the machine — skip that step if Markdown or HTML output is enough.
4. Run the smallest test the README gives, and show me the output.
5. When it works, tell me what to type first, in one line, for this job: Run an account audit.
If anything fails, show me the exact error and fix it before going on.
Paste into Codex
Install claude-ads (https://github.com/AgriciDaniel/claude-ads) on this computer and get it working for me. I am not a developer; explain each step in one line as you go and never skip one. You are Codex, running on my machine.
1. Check what this machine already has (git, Python or Node as the project needs, Docker if the README says so). Tell me anything missing and install it, asking me before anything that needs my password.
2. Clone https://github.com/AgriciDaniel/claude-ads into ~/tools/claude-ads and follow the README's install exactly.
3. Configure it. If it needs an API key or a login, stop and ask me for it; never guess one and never store it anywhere except where the README says.
Tool-specific notes: Clone it with `git clone https://github.com/AgriciDaniel/claude-ads.git`, then run `bash install.sh --source=local` (or, inside Claude Code, `/plugin marketplace add AgriciDaniel/claude-ads` then `/plugin install claude-ads@ai-marketing-hub-claude-ads`).
It needs Python 3.11 or 3.12: `python3.12 -m venv .venv`, then `.venv/bin/python -m pip install --no-deps -e .` and `.venv/bin/python -m pip install --require-hashes --only-binary=:all: -r requirements.lock`.
Verify with `.venv/bin/python -m pytest -q` and `python -m claude_ads_core --version` — both should pass before you call it installed.
Ask for each ad platform's credentials one at a time and put them in environment variables or the OS keychain, never in a file the repo tracks.
PDF reports need WeasyPrint and Pango on the machine — skip that step if Markdown or HTML output is enough.
4. Run the smallest test the README gives, and show me the output.
5. When it works, tell me what to type first, in one line, for this job: Run an account audit.
If anything fails, show me the exact error and fix it before going on.
What to point it at first
1
Run an account audit
Point it at one ad account export and run the audit command — good output is a dated finding with a confidence level attached to each claim, not just a list of stats.
2
Check the audit before you trust it
Open two or three of the findings it cites and confirm the underlying numbers match your own ads dashboard before you act on any of them.
3
Draft a plan, don't apply it
Run the planning command for one channel and read the draft yourself — it should propose budget and channel changes, not make them, until you say so.
What it must never do unattended
It drafts. It never posts.
Never let it invent a number, a customer or a quote.
Never let it push a budget, bid or live ad change to an account without you approving it in the platform itself.
Who made it
AgriciDaniel/claude-ads on GitHub, under the MIT licence. 9,072 stars, checked 9 September 2026. Last change 13 July 2026. We did not write it; we checked it, and wrote this page so you can use it.