claude-ads
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 audits, deterministic findings and evidence coverage, versioned JSON reports, and capability-gated account changes.
- 10.3k stars
- 1.5k forks
- 5 open issues
- Language: Python
- License: MIT
- updated
Install
/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads- Inside Claude Code, add the marketplace and install the plugin with the commands above.
- Follow any post-install configuration from the README.
- Restart the session if commands or hooks do not show up immediately.
Editor's note
Claude Ads is a Claude Code agent skill that audits paid advertising accounts across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, and Amazon Ads, running more than 250 individual checks and returning a weighted 0-100 health score with a prioritized action plan. It integrates with Claude Code as a verified skill, invoked through slash commands such as `/ads audit`, `/ads google`, `/ads meta`, and `/ads report`, with the audit dispatching parallel subagents to evaluate each platform concurrently. The tool compresses what the README describes as 4-6 hours of senior PPC work into 10-15 minutes, making it practical for agencies managing multiple accounts, in-house teams preparing for executive reviews, and freelance consultants scoping new client engagements. A standout detail is the 41-test pytest evaluation harness added in v1.7, which validates routing logic, scoring math determinism, and SSRF regressions on every CI commit. The project is MIT-licensed, runs locally, and ships with platform-specific sub-skills for attribution, tracking, and Amazon Sponsored Products.
24 items in this repository
Operate professional paid advertising across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, and X. Use for account intake, source-grounded audits, strategy, budget and measurement planning, creative production, experiments, reporting, monitoring, and explicitly approved campaign changes. Also trigger on PPC, paid social, retail media, attribution, tracking, landing pages, cross-platform conversion totals, negative keywords or search terms, beta-feature scoring, stale platform claims, API-token or credential setup, campaign deletion, and safe Claude Ads installation or uninstall.
Audit Amazon Ads profiles, regions, Sponsored Products, Sponsored Brands, Sponsored Display, DSP, portfolios, targeting, search terms, retail readiness, creative, budgets, ACOS, TACOS, reporting, and policy. Use for Amazon Ads, sponsored ads, Amazon PPC, ACOS, TACOS, ASIN advertising, Amazon DSP, or retail-media optimization.
Audit Apple Ads measurement, AdServices and AdAttributionKit, campaign and keyword structure, Search Match, App Store placements, custom product pages, bidding, budgets, MMP reconciliation, and policy. Use for Apple Ads, Apple Search Ads, App Store ads, Search Match, custom product pages, AdServices, or Apple app-install campaigns.
Audit cross-platform attribution, conversion definitions, reporting windows, GA4, AdServices and AdAttributionKit, MMPs, browser and server events, offline conversions, and platform reconciliation. Use for attribution audit, attribution models, conversion windows, requests to add or total Meta and Google conversions, incompatible reporting-window aggregation, GA4 attribution, MMP review, AppsFlyer, Adjust, Branch, Singular, or cross-platform discrepancies.
Run a source-grounded paid-advertising audit for one or more of Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, and X. Use for full ad checks, account health reviews, paid-media diagnostics, partial audits after authentication or worker failure, missing-platform weighting, beta-feature eligibility and scoring, spend audits, tracking audits, or prioritized opportunities and risks.
Plan and review paid-media budgets, bidding, pacing, marginal return, forecasts, CPA, ROAS, MER, LTV:CAC, constraints, and allocation across supported platforms. Use for ad budget allocation, media budget, bidding strategy, scaling, spend pacing, budget forecast, ROAS target, or investment tradeoffs.
Research competitor paid-ad presence, messaging, creative, formats, landing pages, keyword and auction signals, transparent ad libraries, and strategic gaps across supported platforms. Use for competitor ads, ad libraries, ad spy, competitive PPC analysis, competitor creative, Google Ads Transparency, Meta Ad Library, or paid-media competitor research.
Create source-grounded paid-ad campaign concepts, messaging, copy, creative briefs, and production plans from a validated brand profile, campaign objective, platform requirements, and optional audit evidence. Triggers on: campaign brief, campaign concepts, create a campaign, ad concepts, ad copy, ad messaging, creative brief, headlines, descriptions.
Audit paid-ad copy, images, video, hooks, concepts, format coverage, platform-native fit, message match, creative fatigue, accessibility, and policy across supported platforms. Use for creative audit, ad creative, creative fatigue, creative diversity, ad copy review, video review, image review, or production priorities.
Extract a public-safe brand and offer profile for paid advertising from an authorized website and operator input. Triggers on: brand DNA, brand profile, brand identity, brand style, brand colors, brand voice, visual identity, style guide, website brand analysis.
Generate paid-ad image assets from a validated creative brief and brand profile using an explicitly configured image provider. Triggers on: generate ads, generate ad images, create ad creatives, create ad images, make ad images, generate visuals, make campaign visuals, generate images from campaign brief.
Audit Google Ads measurement, Search, Shopping, Performance Max, Demand Gen, YouTube-linked inventory, keywords and search terms, negative-keyword generation or review, creative assets, bidding, budgets, settings, and policy. Use for Google Ads, AdWords, Search campaigns, search terms reports, broad negatives, Shopping, Performance Max, PMax, Demand Gen, GAQL, Google conversion tracking, or Google campaign optimization.
Audit paid-ad landing pages for message match, mobile experience, performance, accessibility, trust, forms, consent, tracking, security, and conversion friction. Use for landing-page audit, post-click experience, LP audit, conversion-rate optimization, form optimization, ad-to-page message match, redirects, blocked navigation, or requests involving private, loopback, link-local, or metadata IP destinations.
Draft or explicitly apply a paid-ad campaign launch through Claude Ads capability-gated adapters. Use for campaign creation, launch plans, publishing ads, activating campaigns, uploading creative, or requests to push a campaign live.
Audit LinkedIn Ads measurement, Insight Tag and conversions, professional audiences, lead generation, ABM, creative, bidding, budgets, pacing, automation, and policy. Use for LinkedIn Ads, Campaign Manager, Insight Tag, Lead Gen Forms, Thought Leader Ads, ABM campaigns, or B2B paid media.
Calculate and model paid-media CPA, CPL, CPC, CPM, ROAS, MER, break-even targets, contribution margin, LTV:CAC, impression-share opportunity, budgets, forecasts, and experiment economics. Use for PPC math, ad calculator, break-even analysis, ROAS calculator, CPA calculator, budget forecast, LTV CAC, or MER.
Audit Meta Ads measurement, Pixel and Conversions API, attribution, Facebook and Instagram creative, audiences, placements, automation, budgets, account structure, and policy. Use for Meta Ads, Facebook Ads, Instagram Ads, Advantage+, Pixel, CAPI, Events Manager, creative fatigue, or Meta campaign optimization.
Audit Microsoft Advertising measurement, UET, search and audience campaigns, Google imports, syndication, keywords, creative, bidding, budgets, Copilot inventory, and policy. Use for Microsoft Ads, Bing Ads, UET, Microsoft Audience Network, Google Ads import, or Microsoft campaign optimization.
Monitor paid-ad account pacing, delivery, performance, creative fatigue, tracking, policy, and data quality across supported platforms. Use for daily or weekly checks, anomaly review, budget pacing, post-launch verification, or campaign monitoring.
Diagnose and draft or explicitly apply paid-ad optimizations using evidence, financial constraints, experiments, and capability-gated adapters. Use for campaign optimization, budget reallocation, bid changes, pausing or archiving ads, requests to delete campaigns, search-term or negative-keyword actions, creative rotation, or improving CPA and ROAS.
Generate rights-cleared paid-ad product photography variants from an authorized source image and validated brand profile. Triggers on: product photo, product photography, virtual photoshoot, photoshoot, enhance product image, studio shot, lifestyle shot, lifestyle product image, floating product image, ingredient shot.
Audit Pinterest Ads measurement, Pinterest Tag and Conversions API, catalog and shopping readiness, visual creative, audiences, Performance+ intent, budgets, brand safety, and reporting. Use for Pinterest Ads, promoted Pins, shopping ads, catalog sales, Pinterest Tag, Pinterest Conversions API, or Pinterest Performance+.
Create a professional paid-advertising strategy covering objectives, economics, platform selection, campaign architecture, audiences, budget, creative, measurement, experiments, governance, rollout, and reporting. Use for ad plan, media plan, PPC strategy, paid-social strategy, campaign architecture, advertising roadmap, or channel planning.
Audit Reddit Ads measurement, campaign structure, community and interest targeting, creative-native fit, catalog advertising, budgets, brand safety, and reporting. Use for Reddit Ads, promoted posts, conversation ads, community targeting, Reddit Pixel, Reddit Conversions API, or Reddit dynamic product ads.
Plugins overview
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(MIT licensed, no membership needed), and the community mirror atAI-Marketing-Hub/claude-ads, where AI Marketing Hub Pro members get early access and direct collaboration.
Quickstart
Install (see Installation):
/plugin marketplace add agricidaniel/claude-ads, then/plugin install claude-ads@ai-marketing-hub-claude-ads.Run
/ads setupand answer a few questions: your business model, goal, main conversion, monthly spend, active platforms, and who approves changes. Never paste API keys or tokens.Bring evidence: an account export (CSV or JSON), screenshots, or a pasted summary with its date range, currency, and timezone.
Run
/ads audit google(or/ads audit all). You get a report that states what passed, what failed, and what is missing.Run
/ads reportto see a past run again, and/ads nextto see the most important blocker.
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
Each platform has its own focused skill, audit worker, control reference, and capability declaration. The capability manifest is the authoritative record of what can be read or changed live.
Commands
Standalone installs use /ads. Claude Code plugins are namespaced and use
/claude-ads:ads. Both load the same ads/SKILL.md contract.
| Command | What it does |
|---|---|
/ads setup | Save your client, account, goal, privacy, and guardrail profile |
/ads audit [all|platform|scope] | Run a full or scoped audit backed by evidence |
/ads plan | Build channel, campaign, budget, competitor, and measurement plans |
/ads create | Produce copy, image, video, or product-photo assets |
/ads launch --draft | Draft a campaign change plan without touching the account |
/ads monitor | Review pacing, delivery, tracking, fatigue, policy, and performance |
/ads optimize --draft | Draft evidence-backed improvements |
/ads experiment | Design or read out a controlled test |
/ads report | Render a saved run as Markdown, HTML, or PDF |
/ads research refresh | Refresh platform, policy, API, and benchmark evidence |
/ads validate | Check contracts, runs, capabilities, or release readiness |
/ads status, /ads next | Show where things stand and the most important blocker |
Platform shortcuts such as /ads google, /ads meta, /ads amazon, and
/ads reddit go straight to that platform's audit.
Built to be trusted
Every check ends in one of four results: pass, fail, unknown, or not_applicable. Unknown is a real answer. It means the data was missing, and it is never guessed.
Claude Ads Cockpit (optional)
Cockpit is a separate, optional companion (version 0.1.0, plugin ID ads-cockpit). /ads-cockpit opens a local workbench where you can look through a finished audit: its status, evidence, missing inputs, comparisons with an earlier run, and report receipts. A built-in demo with synthetic data lets you try it without any account.
Task counts stay separate from health scores, and every scoring profile in the scoring manifest stays disabled. See the Cockpit guide and its compatibility and acceptance limits.
Installation
Claude Code is the canonical runtime. Codex, Gemini, Cursor, Windsurf, Goose, and compatible Agent Skills hosts can consume the same skill files where their runtime supports them.
Prefer the host's native plugin flow or a tagged release archive with a verified SHA-256 checksum. Never pipe a remote installer directly to a shell.
For Claude Code, the native plugin flow is:
/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-adsIf you added this marketplace before v2.0.0, Claude Code still holds it under
the stale local alias agricidaniel-claude-ads. Remove that alias, then re-add
and install:
/plugin marketplace remove agricidaniel-claude-ads
/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-adsManaged dependencies require CPython 3.11 or 3.12. Linux x86_64 requires glibc 2.28 or later; musl is unsupported. macOS 11 x86_64/arm64 and Windows amd64 remain declared wheel targets and require native CI qualification. CI checks the Linux minimum in an AlmaLinux 8 glibc 2.28 container with both supported interpreters. This checks Python wheels and the managed CLI lifecycle; browser payloads and PDF system libraries require separate host verification.
Or install from a local clone of the public repository:
git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=localSelect another standalone host explicitly:
bash install.sh --target=codex --source=local
bash install.sh --target=gemini --source=local --no-depsWarning
EXPERIMENTAL: Only Claude Code is verified. The Codex, Gemini, Cursor, Windsurf, and Goose targets install the same skill artifacts under each host's expected directory, but that host's runtime conventions may differ. Confirm the result in your host, and pin the install locations with
--skill-dirand--agent-dirif the auto-detected paths are wrong. The installer creates the managed Python environment only for theclaudeandcodextargets.
--source=git (the default when the installer is run outside a checkout) clones
the default branch HEAD, which is unpinned and is not a verified release. Prefer
--source=local from a checkout you have reviewed, or a release archive.
To pin a git install, add the opt-in --ref option (PowerShell: -Ref) with a
tag, branch, or commit. It is valid only with --source=git. The installer
validates the value strictly, checks it out detached, prints the resolved full
commit SHA, and fails before installing anything if the ref does not resolve:
bash install.sh --source=git --ref=v2.1.0A git ref is not a checksum-verified release, and nothing here is signed. A
release zip checked with the SHA256SUMS recipe below remains the verified path.
PowerShell uses the same managed ownership model:
git clone https://github.com/AgriciDaniel/claude-ads.git
Set-Location claude-ads
.\install.ps1 -Source localVerify a release archive before using it. Each GitHub release publishes the zip,
release-manifest.json, sbom.cdx.json, and a SHA256SUMS file. Releases are
checksummed, not signed, so a checksum confirms the files match what the release
published and is not an independent proof of origin. Download all four files into
one empty directory, then run:
sha256sum -c SHA256SUMS # macOS: shasum -a 256 -c SHA256SUMSEvery line must report OK before you unzip and run bash install.sh --source=local
from the extracted folder.
Managed dependencies support CPython 3.11 and 3.12 on the declared Linux,
macOS, and Windows wheel matrix. Unsupported interpreters fail before the
destination changes. Use --no-deps or -NoDeps for a skill-only install.
Browser capture requires an operator-installed Playwright browser payload. PDF rendering requires the host's WeasyPrint and Pango system libraries. These are documented in the external runtime dependency manifest.
Uninstall only manifest-owned files:
bash uninstall.sh --target=claudeThe PowerShell equivalent is uninstall.ps1.
The Bash and PowerShell skill installers do not enable or load Cockpit. Its optional plugin has its own marketplace entry and curated archive, and requires
What people ask about claude-ads
What is AgriciDaniel/claude-ads?
AgriciDaniel/claude-ads is plugins for the Claude AI ecosystem. 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 audits, deterministic findings and evidence coverage, versioned JSON reports, and capability-gated account changes. It has 10.3k GitHub stars and its last recorded update is dated 2026-10-17.
How do I install claude-ads?
You can install claude-ads by cloning the repository (https://github.com/AgriciDaniel/claude-ads) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is AgriciDaniel/claude-ads safe to use?
Our security agent has analyzed AgriciDaniel/claude-ads and assigned a Trust Score of 100/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains AgriciDaniel/claude-ads?
AgriciDaniel/claude-ads is maintained by AgriciDaniel. The last recorded GitHub activity is dated 2026-10-17, with 5 open issues.
Are there alternatives to claude-ads?
Yes. On ClaudeWave you can browse similar plugins at /categories/plugins, sorted by popularity or recent activity.
Maintain this repo? Show its Trust Score in your README
The badge shows this repository's current Trust Score and verdict, and links back to this page. It follows the catalogue data: nobody can buy or edit the score it displays.
[](https://claudewave.com/en/repo/agricidaniel-claude-ads)<a href="https://claudewave.com/en/repo/agricidaniel-claude-ads"><img src="https://claudewave.com/api/badge/agricidaniel-claude-ads" alt="ClaudeWave Trust Score for AgriciDaniel/claude-ads" width="320" height="64"></a>