Installs

Install the Claude Ads plugin in Claude Code.

Claude Ads installs as a plugin inside Claude Code. No signup, no account access, no upload. It runs locally on your machine, free and open-source.

Quick install · Claude Code

/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads@agricidaniel-claude-ads

What gets installed

Claude Ads installs as a native Claude Code plugin (a set of skills and slash commands) directly into your local environment. There is no separate app to run, no account to create, and no OAuth handshake with your ad platforms. The plugin lives on your machine alongside Claude Code.

It works anywhere Claude Code runs: macOS, Windows, and Linux. The only prerequisite is Claude Code itself, because Claude Ads does not ship a separate desktop app or web account. No account access means there is no ad-platform login screen, OAuth grant, refresh token, or background connector owned by Claude Ads. You choose the inputs for each audit: exported reports, screenshots, pasted metrics, or an MCP connection you control.

The marketplace install places the plugin in Claude Code’s local plugin directory, so commands are resolved by Claude Code on this machine. To update, re-run the marketplace install flow when a new release is available; teams that need repeatable environments can pin the marketplace entry or repository version they install. This keeps the install portable across work laptops and CI-like developer environments without asking your media-buying team to share credentials. If a command does not appear after install, use the troubleshooting and verification steps below before reinstalling.

When you run /ads audit, the checks execute locally against the data you provide: exports, screenshots, pasted metrics, or your own MCP connection. Nothing about your accounts is uploaded to a Claude Ads server, because there isn’t one. Pick whichever install path below fits your setup; they all land at the same place.

Prerequisites

What you need first.

Claude Code CLI

Required

Claude Ads installs as a plugin inside Claude Code. That's the only hard requirement.

Python 3.10+

Recommended

Runs the local audit and scoring scripts that power the deeper analyses.

Playwright

Optional

Enables live landing-page analysis for /ads landing.

reportlab

Optional

Generates client-ready PDF audit reports with /ads report.

banana-claude (MCP)

Optional

Required only for AI image generation: /ads generate and /ads photoshoot.

Install

Pick your install path.

The plugin marketplace is the quickest route inside Claude Code. The install script and manual clone also set up the local Python tooling.

Run these inside Claude Code. Registers Claude Ads as a native plugin with auto-updates, namespace isolation, and version tracking.

Claude Code

/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads@agricidaniel-claude-ads

One command sets up the plugin plus the optional local Python tooling. Pick your shell:

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.ps1 | iex

Clone the repo and run the installer. Best if you want to read or edit the audit checks yourself.

Terminal

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
./install.sh

Install into another AI coding host (Codex, Cursor, Windsurf, Gemini, or Goose). Only Claude Code is verified end to end; other targets follow each host's documented conventions.

macOS / Linux

bash install.sh --target=codex
bash install.sh --target=cursor
bash install.sh --target=windsurf
bash install.sh --target=gemini
bash install.sh --target=goose

Windows PowerShell

.\install.ps1 -Target codex
.\install.ps1 -Target cursor
.\install.ps1 -Target windsurf
.\install.ps1 -Target gemini
.\install.ps1 -Target goose

Cleanly removes the plugin and local tooling:

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.ps1 | iex

Public vs Pro early access

These commands use the public AgriciDaniel/claude-ads repo, MIT-licensed, no membership required. Pro members get early access through the AI-Marketing-Hub mirror, which needs gh auth login with org access. If /plugin marketplace add returns a 404, ask in the Skool community to be added.

Verify

Confirm it's working.

In Claude Code, run the root command:

Claude Code

/ads

You should see the command menu:

/ads - Multi-platform paid advertising audit
Run /ads audit for a full audit, or a platform
command like /ads google. See /docs for more.

Troubleshooting

Command not found

Restart Claude Code after installing so it picks up the new plugin.

Python features missing

Make sure Python 3.10+ is on your PATH, then re-run the install script.

Images won't generate

Install the banana-claude MCP: /ads generate and /ads photoshoot depend on it.