Claude Ads: lo skill di Claude Code che audita i tuoi account pubblicitari

Forse hai visto il reel su Instagram: "fai in dieci minuti il lavoro della tua agenzia ads da 3.000 al mese". Dietro il gancio un po' commerciale c'è un progetto open source molto reale: Claude Ads, uno skill per Claude Code che legge i dati dei tuoi account pubblicitari e ti dice cosa funziona, cosa è rotto e cosa correggere per primo. Oltre 10.000 stelle su GitHub a ottobre 2026, licenza MIT.

Aggiornato il 21 ottobre 2026 per Claude Ads v2.1.0, uscita il 16 ottobre 2026. La prima versione di questo articolo descriveva la v1.7.1. Dalla v2, lo skill copre dodici piattaforme invece di otto, non produce più un punteggio su 100, e i suoi autori ora sconsigliano l'installazione in una riga che mostravamo. Tutto ciò che segue è stato verificato sul README e sui file dello skill nella v2.1.0.

Cos'è esattamente Claude Ads

Claude Ads è uno skill di Claude Code creato da Daniel Agrici. Uno skill è un pacchetto di istruzioni, riferimenti e agenti che il tuo agente di codice carica su richiesta: qui, il know-how di un auditor di media a pagamento, suddiviso in moduli. Non è un prodotto di Anthropic, e non ha niente a che vedere con la pubblicità dentro Claude: Anthropic ha scritto a febbraio 2026 che Claude resterà senza pubblicità.

Si trova in due posti: la versione pubblica su AgriciDaniel/claude-ads (MIT, senza abbonamento) e un mirror della community su AI-Marketing-Hub/claude-ads, dove i membri di una community a pagamento hanno accesso anticipato.

Cosa contiene la v2.1.0:

• 12 piattaforme pubblicitarie: Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat e X.
• 33 skill dietro un solo comando /ads, uno per piattaforma più quelli trasversali (attribuzione, tracking lato server, creativi, landing page, budget, pianificazione, report).
• 25 definizioni di agenti: un worker di audit per piattaforma, worker per tracking, budget, creativi, policy e conformità normativa, quattro agenti creativi (copywriter, stratega creativo, adattatore di formati, visual designer) e agenti di ricerca e verifica.
• Quattro risultati possibili per ogni verifica: pass, fail, unknown o not_applicable. Unknown significa che il dato mancava, e lo skill non lo indovina mai.
• Nessun punteggio di salute, per ora. Il progetto si definisce candidato di sviluppo, e i dodici profili di punteggio della salute degli account sono disattivati. Un audit restituisce invece rilievi, incognite e una copertura delle prove: dall'80 % di copertura in su c'è una valutazione, dal 60 al 79 % è provvisoria, sotto il 60 % le prove sono insufficienti.

Le vecchie cifre che forse hai letto altrove, 250 verifiche, un punteggio su 100 con un voto da A a F, otto piattaforme, descrivono la v1. Non è più ciò che lo skill dice di sé.

Come funziona sotto il cofano

Un direttore d'orchestra gestisce il perimetro dell'esecuzione, le regole, l'aggregazione e il report finale. I worker analizzano porzioni delimitate, una piattaforma o un tema ciascuno, e restituiscono i rilievi in uno schema fisso. Se un worker necessario fallisce, l'esecuzione viene segnata come parziale: non viene mai presentata come un audit completo.

Configurare, fare l'audit, rivedere: i tre passaggi del flusso v2, dal repository ufficiale.

Se usi già Claude Code per scrivere codice, riconoscerai lo schema: è il meccanismo dei sotto-agenti e dei team di agenti, applicato al marketing invece che al codice. Dalla v2.1.0 gli agenti non fissano più un modello: Claude Code li esegue con il modello della tua conversazione principale, a meno che non sia impostato qualcosa di più specifico.

Il risultato di un'esecuzione è un file JSON versionato. I report in Markdown, HTML e PDF sono rendering di quello stesso file, ed è per questo che /ads report può mostrare di nuovo un'esecuzione passata senza eseguire nulla.

In pratica, il flusso sta in cinque passaggi:

1. Lancia /ads setup e rispondi alle sue domande: modello di business, obiettivo, conversione principale, spesa mensile, piattaforme attive e chi approva le modifiche. Ti dice di non incollare mai lì chiavi API o token.
2. Porta le prove: un export dell'account in CSV o JSON, degli screenshot o un riepilogo incollato con il suo intervallo di date, la valuta e il fuso orario.
3. Lancia /ads audit google, oppure /ads audit all. Ottieni cosa è passato, cosa è fallito e cosa manca.
4. Lancia /ads report per rivedere un'esecuzione passata.
5. Lancia /ads next per vedere il blocco più importante.

Le dodici piattaforme

Ogni piattaforma ha il proprio skill, il proprio worker di audit, il proprio riferimento di controlli e la propria dichiarazione di capacità. Un manifesto delle capacità nel repository registra cosa si può leggere o modificare in tempo reale su ogni piattaforma. Sopra le piattaforme ci sono gli audit trasversali: attribuzione (definizioni di conversione, finestre, GA4, partner di misurazione mobile) e tracking lato server (tagging server-side, Conversions API ed Events API, deduplicazione, qualità dei dati degli eventi). Sono spesso i punti ciechi degli audit umani, perché richiedono competenze sia media sia tecniche.

I comandi

Tutto passa da /ads. Installato come plugin di Claude Code, i comandi hanno un namespace e iniziano con /claude-ads:ads; installato in modo autonomo, iniziano con /ads. Il README elenca questi:

Le scorciatoie di piattaforma portano dritte a un audit: /ads google, /ads meta, /ads youtube, /ads linkedin, /ads tiktok, /ads microsoft, /ads apple, /ads amazon, /ads reddit, /ads pinterest, /ads snapchat e /ads x.

I comandi specialistici della v1 sono ancora instradati dallo skill: /ads dna per il profilo di brand e di offerta di un sito web, /ads attribution, /ads tracking, /ads creative, /ads landing, /ads budget, /ads math per CPA, ROAS, MER, LTV:CAC e break-even, /ads competitor, /ads generate per immagini a partire da un brief convalidato, /ads photoshoot per varianti di foto prodotto, e /ads test come altro nome di /ads experiment. Una richiesta in linguaggio naturale arriva agli stessi skill. Nessuno skill genera video: il lavoro sui video si ferma a concept e brief.

Installalo in sicurezza

Gli autori ora lo scrivono chiaramente: preferisci il flusso dei plugin dell'host o un archivio di release controllato con il suo checksum, e non passare mai un installer remoto direttamente a una shell. La prima versione di questo articolo mostrava proprio questo, un curl | bash e un irm | iex: non usarli.

Dentro Claude Code, il flusso dei plugin:

/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

Se hai aggiunto il marketplace prima della v2.0.0, Claude Code lo conserva ancora con un vecchio alias. Rimuovilo prima:

/plugin marketplace remove agricidaniel-claude-ads

Da un clone che hai letto, su macOS o Linux:

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local

Su Windows, in PowerShell, dallo stesso clone: .\install.ps1 -Source local.

Per fissare una versione, bash install.sh --source=git --ref=v2.1.0 fa il checkout esattamente di quel tag e fallisce se non si risolve. La strada verificata resta uno zip di release: ogni release di GitHub pubblica lo zip, un manifesto, una distinta base del software e un file SHA256SUMS, e ogni riga di sha256sum -c SHA256SUMS deve dire OK prima di decomprimere. Le release hanno un checksum, ma non sono firmate.

Cosa serve: CPython 3.11 o 3.12 per le dipendenze gestite, glibc 2.28 o successivo su Linux, le librerie WeasyPrint e Pango per i report PDF, e un browser Playwright se vuoi catture dal browser.

L'installer ha anche --target=codex, --target=gemini e target per Cursor, Windsurf e Goose. Il README li indica come sperimentali: solo Claude Code è verificato, e gli altri host possono gestire gli stessi file in modo diverso.

Il flusso del reel, rivisto

Il reel di Instagram che ha reso famoso lo skill mostra tre passaggi. Eccoli con la v2.1.0.

Passaggio 1: installa lo skill. Con il flusso dei plugin qui sopra, non con una riga incollata.

Passaggio 2: descrivi il tuo business, poi pianifica. /ads setup ti chiede della tua offerta, del tuo obiettivo, della conversione, del budget e delle piattaforme. Se hai un sito web, /ads dna <url> estrae il tuo profilo di brand e di offerta, così il piano parte dal tuo posizionamento reale. Poi /ads plan costruisce il piano di canali, campagne, budget e misurazione.

Passaggio 3: il report. /ads report mostra l'esecuzione salvata in Markdown, HTML o PDF, pronta da inviare a un cliente o alla tua direzione.

Dove il reel semplifica: il risultato vale quanto le prove. Dagli risposte vaghe e otterrai un piano vago. Lancia un audit senza export né screenshot e otterrai un report pieno di unknown, il che è onesto, ma non è una diagnosi. E nella v2.1.0 non c'è nessun punteggio da sfoggiare: ottieni rilievi e quanta parte dell'account si è potuta valutare.

I tuoi dati e i tuoi account

Lo skill gira nel tuo terminale e analizza le prove che gli dai. Le credenziali vanno in variabili d'ambiente, nel portachiavi del sistema operativo o in un gestore di segreti; mai nel repository, nei profili, nei report o nei log.

Il cambiamento più grande rispetto alla v1 riguarda la scrittura. La v2 ha /ads launch e /ads optimize, ma ogni adattatore è in sola lettura per impostazione predefinita e le modifiche restano bozze. Per applicarne una, lo skill ha bisogno di tutte e sei queste condizioni:

1. una capacità testata e attivata per quella precisa operazione;
2. ID di account e di oggetto espliciti;
3. un diff leggibile prima e dopo, con ciò che tocca;
4. l'approvazione del proprietario, entro i limiti fissati per l'account;
5. una chiave di idempotenza, una destinazione per il registro di audit, un rollback e una finestra di verifica;
6. una verifica che l'account corrisponda ancora a ciò che la modifica si aspetta.

Senza limiti fissati non c'è scrittura, e l'eliminazione definitiva non è supportata nella v2.

Cosa sostituisce, e cosa no

Siamo onesti, perché "sostituisci la tua agenzia da 3.000 al mese" merita qualche sfumatura.

Cosa fa bene Claude Ads: la parte sistematica del lavoro. Passare tutti i controlli su un account senza dimenticarne nessuno, confrontare il tracking con ciò che la piattaforma si aspetta, individuare la fatigue creativa, ricalcolare le soglie di break-even e dire chiaramente cosa non si è potuto verificare. È la parte oggettiva e ripetibile di un audit, quella che anche un buon consulente fa più lentamente di una macchina.

Cosa non fa: premere i pulsanti al posto tuo per impostazione predefinita, né conoscere il contesto che conosce la tua agenzia: la tua stagionalità, i test già falliti, il rapporto con il tuo referente in Google. E come qualsiasi output di un'IA, le sue raccomandazioni vanno verificate prima di impegnare un vero budget media.

L'inquadramento giusto: Claude Ads non sostituisce il giudizio, sostituisce le ore fatturate a scorrere checklist. Per un imprenditore che gestisce le proprie campagne, è un livello di audit che non aveva. Per un'agenzia, l'audit che richiedeva mezza giornata per account diventa un punto di controllo settimanale.

Claude Ads in AgentsRoom: il tuo polo pubblicità accanto al polo dev

È qui che diventa interessante se usi già degli agenti per programmare. Uno skill come Claude Ads, lanciato a mano in un terminale, è uno strumento. Lo stesso skill, affidato a un agente dedicato in un cockpit multi-agente, è un polo di mestiere che continua a girare.

AgentsRoom è fatto esattamente per questo: ogni agente ha un ruolo, uno stato in diretta e il proprio colore, e supervisioni l'intera flotta da un'unica finestra. Nulla ti obbliga a far girare solo agenti di codice. Crea un agente con un ruolo pubblicità, installa lo skill Claude Ads sul suo Claude Code, e diventa il tuo media buyer junior: raccoglie i ticket di audit dal backlog, lancia i suoi comandi /ads e deposita il report in uscita.

Il ciclo completo assomiglia a questo. L'agente Ads lancia /ads audit all sui tuoi export del lunedì mattina e pubblica i suoi rilievi sul backlog. I problemi tecnici che fa emergere (una conversione GA4 contata due volte, un Consent Mode configurato male, una landing page troppo lenta) diventano ticket che il tuo agente dev raccoglie e corregge nel codice, ciascuno nel proprio worktree affinché gli agenti in parallelo non si pestino mai i piedi. Nel frattempo, un agente SEO tiene le landing page allineate con le campagne in corso. Tu leggi i report, e sei tu ad approvare una modifica prima che arrivi a un account pubblicitario.

Tieni l'agente Ads su Claude Code, l'unico host che Claude Ads verifica. I tuoi agenti di codice possono girare sulla CLI che preferisci: AgentsRoom li fa girare fianco a fianco nella stessa finestra, qualunque sia il provider, e la matrice di compatibilità elenca ciò che è supportato.

Il mestiere accanto è sempre stato il più difficile da integrare: il dev non parla media, il media non parla dev. Una flotta di agenti che condividono lo stesso backlog colma questo divario meglio di qualsiasi riunione settimanale.

Domande frequenti

Claude Ads è fatto da Anthropic?

No. Claude Ads è uno skill open source per Claude Code scritto da Daniel Agrici e pubblicato con licenza MIT su github.com/AgriciDaniel/claude-ads. Anthropic fa Claude e Claude Code; lo skill gira sopra di essi.

Claude mostra pubblicità?

No. Nel suo post del 4 febbraio 2026, Claude is a space to think, Anthropic ha scritto che Claude resterà senza pubblicità: nessun link sponsorizzato accanto alle conversazioni e nessuna risposta influenzata dagli inserzionisti. Claude Ads serve a fare l'audit dei tuoi account pubblicitari, non a mostrare annunci dentro Claude.

Claude Ads dà ancora un punteggio su 100?

Non nella v2.1.0. I dodici profili di punteggio della salute degli account sono disattivati, quindi l'audit restituisce rilievi, incognite e una copertura delle prove invece di un punteggio. Ogni verifica finisce in pass, fail, unknown o not_applicable, e unknown significa che il dato mancava.

Claude Ads può modificare le mie campagne pubblicitarie?

Non da solo. Ogni adattatore è in sola lettura per impostazione predefinita e le modifiche restano bozze. Applicarne una richiede una capacità attivata per quella precisa operazione, ID di account e di oggetto espliciti, un diff prima e dopo, l'approvazione del proprietario entro i limiti dell'account, un rollback e la verifica che l'account non sia cambiato nel frattempo. L'eliminazione definitiva non è supportata nella v2.

Claude Ads funziona con Codex o Gemini CLI?

Il suo installer ha target Codex, Gemini, Cursor, Windsurf e Goose, ma il README li indica come sperimentali: solo Claude Code è verificato. Installalo su Claude Code se vuoi la strada supportata.

Installa lo skill, lancia il tuo primo /ads audit, e se vuoi che giri senza di te: scarica AgentsRoom e dai al tuo polo pubblicità la stessa infrastruttura del tuo polo dev.