Skip to main content
ClaudeWave
ES, Spanish
AgriciDaniel / Plugins

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 estrellas
  • 1.5k forks
  • 5 issues abiertos
  • Lenguaje: Python
  • Licencia: MIT
  • actualizado

Instalación

Claude Code
/plugin marketplace add AgriciDaniel/claude-ads
/plugin install claude-ads
  1. Inside Claude Code, add the marketplace and install the plugin with the commands above.
  2. Follow any post-install configuration from the README.
  3. Restart the session if commands or hooks do not show up immediately.

Nota editorial

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.

Items instalables

24 items en este repositorio

adsSkill

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar
ads-dnaSkill

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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.

Instalar

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+.

Instalar

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.

Instalar

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.

Instalar
README

Resumen de Plugins

README completo en GitHub

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 at AI-Marketing-Hub/claude-ads, where AI Marketing Hub Pro members get early access and direct collaboration.

Quickstart

  1. Install (see 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.

What you can do

You want toRunYou get
Find out what is wrong/ads auditA report of passed, failed, and unchecked items, each with its evidence
Decide where to spend/ads planChannel, budget, measurement, and competitor plans
Make ads/ads createCopy, image, video, and product-photo briefs and assets
Keep watch/ads monitorChecks on pacing, delivery, tracking, ad fatigue, and policy
Improve results/ads optimize --draftSuggested changes, written as drafts
Test an idea/ads experimentA 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.

CommandWhat it does
/ads setupSave your client, account, goal, privacy, and guardrail profile
/ads audit [all|platform|scope]Run a full or scoped audit backed by evidence
/ads planBuild channel, campaign, budget, competitor, and measurement plans
/ads createProduce copy, image, video, or product-photo assets
/ads launch --draftDraft a campaign change plan without touching the account
/ads monitorReview pacing, delivery, tracking, fatigue, policy, and performance
/ads optimize --draftDraft evidence-backed improvements
/ads experimentDesign or read out a controlled test
/ads reportRender a saved run as Markdown, HTML, or PDF
/ads research refreshRefresh platform, policy, API, and benchmark evidence
/ads validateCheck contracts, runs, capabilities, or release readiness
/ads status, /ads nextShow 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-ads

If 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-ads

Managed 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=local

Select another standalone host explicitly:

bash install.sh --target=codex --source=local
bash install.sh --target=gemini --source=local --no-deps

Warning

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-dir and --agent-dir if the auto-detected paths are wrong. The installer creates the managed Python environment only for the claude and codex targets.

--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.0

A 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 local

Verify 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 SHA256SUMS

Every 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=claude

The 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

Topics
agent-skillsaiai-marketingclaude-codeclaude-code-skillgoogle-adsmarketing-automationmeta-adsopen-sourcepaid-advertisingppc
Preguntas frecuentes

Lo que la gente pregunta sobre claude-ads

¿Qué es AgriciDaniel/claude-ads?

AgriciDaniel/claude-ads es plugins para el ecosistema de Claude AI. 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. Tiene 10.3k estrellas en GitHub y su última actualización registrada es del 2026-10-17.

¿Cómo se instala claude-ads?

Puedes instalar claude-ads clonando el repositorio (https://github.com/AgriciDaniel/claude-ads) o siguiendo las instrucciones del README en GitHub. ClaudeWave también te ofrece bloques de instalación rápida en esta misma página.

¿Es seguro usar AgriciDaniel/claude-ads?

Nuestro agente de seguridad ha analizado AgriciDaniel/claude-ads y le ha asignado un Trust Score de 100/100 (tier: Verified). Revisa el desglose completo de comprobaciones superadas y flags en esta página.

¿Quién mantiene AgriciDaniel/claude-ads?

AgriciDaniel/claude-ads es mantenido por AgriciDaniel. La última actividad registrada en GitHub es del 2026-10-17, con 5 issues abiertos.

¿Hay alternativas a claude-ads?

Sí. En ClaudeWave puedes explorar plugins similares en /categories/plugins, ordenados por popularidad o actividad reciente.

¿Mantienes este repo? Muestra su Trust Score en tu README

La insignia muestra el Trust Score y el veredicto actuales de este repositorio y enlaza a esta página. Sigue los datos del catálogo: nadie puede comprar ni editar la puntuación que enseña.

ClaudeWave Trust Score for AgriciDaniel/claude-ads
Markdown (README)
[![ClaudeWave Trust Score for AgriciDaniel/claude-ads](https://claudewave.com/api/badge/agricidaniel-claude-ads)](https://claudewave.com/en/repo/agricidaniel-claude-ads)
HTML
<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>

Qué significa la insignia y cómo se calcula la puntuación