Signal Collective
Hong Kong Book a call
Signal Collective The Library Marketing
We find where your growth is · Then we build it

Marketing · Copy, launches, pricing pages, ads, search. · a tool

Find out where your ad money is leaking

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
A blank page Three drafts The one you chose nothing yet

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.

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.

Also in Marketing

A blank page Three drafts The one you chose nothing yet
Tool · Marketing · gstack

One AI, a whole team's judgement

gstack turns Claude Code into a small engineering team with defined roles — a CEO for direction, an engineer, a designer, a QA lead, a security reviewer and a release engineer — each one a slash command with its own review gate.

15 min · your AI on your computer · Claude Code, git, Bun v1.0+ (Node.js too, on Windows)Open
A blank page Three drafts The one you chose nothing yet
Tool · Marketing · marketingskills

Marketing done the proven way, not by guesswork

marketingskills is a set of reference playbooks your AI coding agent reads before doing marketing work — conversion optimization, copywriting, SEO, analytics and growth engineering — so instead of guessing at best practice, it works from the same frameworks a marketing consultant would use.

10 min · your AI on your computer · Claude Code (or Cursor, Windsurf, Codex, or another Agent Skills-compatible tool), Node.js, for the install commandOpen
A blank page Three drafts The one you chose nothing yet
Tool · Marketing · notfair-plugin

Your ads and search rankings, managed by your AI

toprank connects your AI agent to your live SEO, Google Ads, Meta Ads and analytics accounts and gives it forty-five ready-made workflows for auditing and reporting on them — why organic traffic dropped, how a Google Ads account is actually performing, what an AI search engine says about you.

20 min · your AI on your computer · Claude Code (or Cursor, Codex, Gemini CLI), an authorised connection to the tool's own MCP, logins or API access for each platform you connect (Google Search Console, GA4, Google Ads, Meta Ads, etc.)Open

What's in the library is how we work.

If you're launching or growing a brand across Asia and the West, a call is where we work out whether it's a fit.