Pubblica, pianifica e gestisci annunci da Claude Code

Cos'è Claude Code?

Claude Code è l'agente da terminale di Anthropic. Vive in una directory di lavoro, legge e scrive file, esegue comandi e installa plugin da un marketplace con un solo comando. Questo lo rende la casa naturale per le parti del marketing che sono davvero pipeline: render, controllo, pubblicazione, log.

Claude Code, Claude o Cowork? Claude Code è l'agente da terminale di Anthropic, e Hermoso arriva come plugin. In Claude sul web o desktop Hermoso è invece un connettore, e Cowork usa lo stesso connettore.

Hermoso è marketing in automatico: 922+ strumenti su un unico endpoint MCP che coprono la ricerca di annunci dei concorrenti, annunci finiti in immagine e video con oltre 100 modelli, pubblicazione e programmazione su undici canali social, e gestione delle campagne su Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads. Una sola connessione, e Claude Code ha tutto.

Collega Hermoso a Claude Code

1. Un solo comando, e nessuna chiave.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Già dentro una sessione? Scrivi /plugin marketplace add hermoso-ai/hermoso, poi /plugin install hermoso@hermoso. Installa cinque skill di Hermoso (research, ad-from-brand, generate, product-photoshoot e marketing) che eseguono il comando hermoso tramite npx, quindi nessuna lista di strumenti viene caricata nelle tue sessioni e nulla consuma contesto finché non gira.
2. Accedi una volta.

   npx -y hermoso auth login

   Apre un accesso nel browser su loopback, come fa gh, e salva una credenziale riservata al proprietario in ~/.hermoso/config.json. Claude Code la esegue per te la prima volta che serve Hermoso. Nessun browser su quella macchina, per esempio in CI, su un server remoto o in un container? Crea una chiave in MCP & CLI → Terminal & API keys ed esegui npx -y hermoso auth login --token hmk_…. Una chiave porta con sé una vera autorità di spesa, quindi trattala come una password.
3. Facoltativo: anche il server MCP. Se vuoi anche gli strumenti di Hermoso nella lista strumenti di Claude Code, esegui claude mcp add hermoso -- npx -y hermoso mcp dopo l'accesso. Usa la stessa credenziale salvata, quindi nessuna chiave finisce in .claude.json. Le skill raggiungono ogni strumento anche senza di esso.
4. Chiedi qualcosa a Claude Code. “Recupera le inserzioni più longeve dei tre concorrenti più vicini e trasforma il gancio migliore in un video 9:16”, oppure “pubblica questo render sul canale”. L'agente sceglie gli strumenti; tu approvi la spesa.

Il plugin e il server MCP facoltativo raggiungono gli stessi strumenti e lo stesso account. La differenza è il contesto: una lista di strumenti viene caricata in ogni sessione prima che tu scriva qualcosa, mentre le skill non costano nulla finché non gira un comando.

Ogni canale su cui Claude Code può pubblicare

Ognuno di questi ha la sua pagina, con il limite reale di caratteri della didascalia, le opzioni di visibilità reali, cosa rifiuta e perché, e un esempio formulato per Claude Code.

Tutti passano da un unico calendario schedule_post con didascalie per canale, e list_scheduled riporta l'esito per canale invece di un semplice segno verde, perché “il job è riuscito” e “il post è uscito” sono domande diverse. Un post programmato vive in Hermoso, quindi esce in orario anche se Claude Code non è più in funzione.

Google Business Profile è il canale più recente: post con una foto e un pulsante sulla tua scheda di Google Ricerca e Maps, risposte alle recensioni, modifiche alla scheda, e le chiamate, i clic sul sito e le richieste di indicazioni che la scheda genera. Claude Code lo raggiunge con gli stessi strumenti, e schedule_post lo mette in coda sullo stesso calendario.

Un canale costruito ma non offerto

Essere diretti su questo vale più di un elenco più lungo. Nel codice esiste una superficie di pubblicazione che è trattenuta, in attesa della piattaforma e non di noi:

• Reddit: la pubblicazione organica e le statistiche dei post sono costruite, ma la Responsible Builder Policy di Reddit richiede un'approvazione scritta esplicita prima che un'app possa usare la Data API, e quella approvazione non è ancora arrivata. Il connettore è trattenuto invece di essere offerto come schermata OAuth che porta a un'API inattiva. Reddit Ads è un'altra connessione ed è attiva: l'intera struttura di campagne, le previsioni, la ricerca di targeting, i pixel e i moduli lead.

Un connettore che ti darebbe un OAuth riuscito e un'API inattiva è peggio di uno non ancora offerto, quindi non è elencato come disponibile.

Tre cose da digitare una volta collegato

1. Ricerca. “Chi sono i miei tre concorrenti più vicini, e quali sono le loro inserzioni Meta più longeve? Dimmi quale gancio continua a ripetersi.” Esegue find_competitors → pull_competitor_ads → mine_angles.
2. Crea. “Fammi un video annuncio UGC 9:16 con quel gancio, con la foto reale del mio prodotto e i sottotitoli applicati.” Esegue get_brand → plan_ad → render_ad, e restituisce un URL di un mp4 finito.
3. Pubblica. “Programma la pubblicazione su Instagram e TikTok per martedì alle 9, e costruisci attorno ad essa una campagna Meta in pausa rivolta agli Stati Uniti con $30 al giorno.” Esegue schedule_post → create_meta_campaign → create_meta_ad.

Cosa Claude Code non può fare da solo

Un agente con un budget è utile solo se il raggio d'azione è limitato, quindi il limite è nel server e non in un prompt. Ogni campagna, ogni set di inserzioni, ogni gruppo di annunci e ogni annuncio viene creato in pausa, e i cambi di stato che attivano denaro reale si rifiutano di funzionare senza un flag di conferma esplicito. Ogni render viene preventivato prima (hermoso_capabilities pubblica il costo esatto in crediti di ogni modello prima che qualcosa venga speso). I crediti vengono riservati prima della prima chiamata al fornitore e poi addebitati al costo esatto, quindi una chiamata fallita viene rimborsata invece di lasciarti addebitato per nulla. Anche le eliminazioni richiedono conferma, e ogni struttura di campagna viene riletta dalla piattaforma pubblicitaria prima che il tuo agente ti dica cosa ha costruito.

Un passaggio è deliberatamente tuo: collegare ogni account, una volta. La maggior parte dei canali si collega tramite la schermata di consenso OAuth della piattaforma nel browser; Bluesky richiede una password per le app e Telegram un token del bot, incollati in Hermoso. Tutto il resto è una chiamata di strumento.

Claude Code chiede prima di eseguire uno strumento, e la trascrizione è lì nel terminale, quindi un passaggio di pubblicazione è una riga che puoi leggere prima di premere y.

Quanto costa

Aggiungere Hermoso a Claude Code non costa nulla in più: c'è un solo contatore di crediti, e non importa quale client lo ha chiamato. Un account gratuito parte con 30 crediti alla registrazione e altri 250+ da guadagnare. I crediti si spendono solo per i modelli IA e per la ricerca Ad Spy; pubblicazione, programmazione, gestione degli annunci e analisi sono gratuite su ogni canale tranne X, che addebita per chiamata perché X ci addebita ogni richiesta API. I piani a pagamento costano $29, $69 e $149 al mese per 1.200, 3.000 e 7.000 crediti, e ogni funzione è inclusa in ogni piano. hermoso_capabilities indica il prezzo esatto in crediti di ogni render prima che parta.

Risoluzione dei problemi

• Un server locale stampa l'aiuto ed esce. Mancano gli argomenti: il mcp finale. npx -y hermoso da solo stampa l'aiuto; npx -y hermoso mcp avvia il server.
• Su quella macchina non c'è un browser. Crea una chiave in MCP & CLI → Terminal & API keys ed esegui invece npx -y hermoso auth login --token hmk_….
• Manca un canale. Collegalo in Hermoso in Impostazioni → Connettori, poi chiedi a Claude Code di eseguire di nuovo list_connectors.
• Claude Code risponde senza usare Hermoso. Nominalo nella richiesta: “usa Hermoso per …”. Così non ci sono dubbi su quali strumenti debbano fare il lavoro.

Oltre la pubblicazione

La pubblicazione è l'ultimo passo, ed è quello più piccolo. La stessa connessione dà a Claude Code le librerie di annunci di Meta, Google e LinkedIn, più TikTok, Instagram, YouTube, Reddit e Threads organici per la ricerca; oltre 100 modelli di immagini, video, voce e scrittura su un unico contatore di crediti, con avatar UGC, doppiaggio, upscaling e formati annuncio HTML nativi; e l'intera struttura di campagne su dodici piattaforme a pagamento. Non ci sono chiavi API di fornitori da custodire né un'app separata da imparare.

Vedi l'elenco completo degli strumenti, ogni agente in cui lavora Hermoso, oppure cos'è un MCP di marketing. Per la storia più lunga su questo client in particolare, vedi Marketing con Claude Code.

Hermoso negli altri agenti

Lo stesso account Hermoso funziona in ogni agente qui sotto, quindi il tuo brand, la libreria, il calendario e i crediti ti seguono da uno all'altro.

Domande frequenti

Claude Code può pubblicare sui social?

Sì, una volta installato Hermoso. Claude Code può pubblicare su Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram e Google Business Profile, e programmare su tutti e undici da un'unica coda, con didascalie per canale.

Come aggiungo Hermoso a Claude Code?

Un solo comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, oppure dentro una sessione /plugin marketplace add hermoso-ai/hermoso e poi /plugin install hermoso@hermoso. Installa cinque skill di Hermoso che eseguono il comando hermoso CLI, quindi nessuna lista di strumenti viene caricata nelle tue sessioni. Accedi una volta con npx -y hermoso auth login, che apre il browser e salva la credenziale da solo, quindi non c'è nessuna chiave da creare né da incollare. Il plugin e il server MCP facoltativo raggiungono gli stessi strumenti e lo stesso account. La differenza è il contesto: una lista di strumenti viene caricata in ogni sessione prima che tu scriva qualcosa, mentre le skill non costano nulla finché non gira un comando.

Claude Code può generare anche video e immagini?

Sì, in modo nativo e non appaltandolo altrove. Più di 100 modelli di immagini, video, voce e scrittura stanno su un unico contatore di crediti, e Claude Code può calcolare il prezzo di un render prima di lanciarlo, perché hermoso_capabilities pubblica il costo esatto di ogni modello. Il risultato è un annuncio finito, con il tuo prodotto reale nella scena e didascalie e CTA composte sopra il render.

C'è un piano gratuito per Claude Code?

Sì. Un account gratuito parte con 30 crediti e 250+ altri che puoi guadagnare mentre configuri e crei, e il server MCP stesso si aggiunge gratis a Claude Code. I piani a pagamento costano $29, $69 e $149 al mese per 1.200, 3.000 e 7.000 crediti. Ogni funzione è inclusa in ogni piano, incluso Free, e l'unica eccezione è l'SSO aziendale.

È sicuro lasciare che Claude Code pubblichi e gestisca annunci per me?

Hermoso tiene dietro a gate, sul proprio server, i passaggi che costano denaro o non si possono annullare, qualunque sia l'impostazione di Claude Code: ogni campagna viene creata in pausa, gli interruttori della spesa e le eliminazioni richiedono una conferma esplicita, e un post raggiunge solo un account che hai collegato e spuntato in Hermoso. Claude Code chiede prima di eseguire uno strumento, e la trascrizione è lì nel terminale, quindi un passaggio di pubblicazione è una riga che puoi leggere prima di premere y.

Claude Code può far girare Hermoso in CI o su un server?

Sì. Su una macchina senza browser, crea una chiave in MCP & CLI, Terminal & API keys ed esegui una volta npx -y hermoso auth login --token hmk_… . Ogni comando hermoso accetta --json, quindi un passaggio di pipeline può verificare l'output. Tratta quella chiave come una password, perché porta con sé l'autorità di spesa.