Hermoso è un server MCP di marketing: 922+ strumenti su un unico endpoint con OAuth che permette a un agente di studiare gli annunci già attivi in un mercato, generare annunci finiti in immagine e video, pubblicarli e costruire le campagne a pagamento che stanno dietro. Claude Code raggiunge tutto attraverso una sola connessione. Questa pagina copre una fetta di tutto ciò: cosa Claude Code può fare davvero su YouTube e cosa YouTube non gli permette di fare.
Collega Hermoso a Claude Code
- Un solo comando, e nessuna chiave.
Già dentro una sessione? Scriviclaude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/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 comandohermosotramitenpx, quindi nessuna lista di strumenti viene caricata nelle tue sessioni e nulla consuma contesto finché non gira. - Accedi una volta.
Apre un accesso nel browser su loopback, come fanpx -y hermoso auth logingh, 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 eseguinpx -y hermoso auth login --token hmk_…. Una chiave porta con sé una vera autorità di spesa, quindi trattala come una password. - 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 mcpdopo l'accesso. Usa la stessa credenziale salvata, quindi nessuna chiave finisce in.claude.json. Le skill raggiungono ogni strumento anche senza di esso. - 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.
Poi collega YouTube stesso, una volta, da Impostazioni → Connettori in Hermoso. È una schermata di consenso OAuth, quindi è l'unico passaggio che richiede un browser. Tutto il resto è una chiamata di strumento.
Gli strumenti YouTube che ottiene Claude Code
post_to_youtube: carica un video finito con titolo, descrizione fino a 5.000 caratteri, fino a 30 tag e un'impostazione di privacy.schedule_post: mette in coda il caricamento, e trasporta con sé descrizione e tag.set_youtube_thumbnail: applica una miniatura progettata al caricamento. È la leva più grande sul tasso di clic, e YouTube altrimenti sceglie un fotogramma più o meno a caso.make_thumbnail: genera quella miniatura da zero.update_youtube_video / list_youtube_videos: modifica i metadati di un caricamento, o elenca i tuoi caricamenti, inclusi quelli non in elenco e privati che una ricerca pubblica non vede.youtube_video_insights / youtube_channel: visualizzazioni, tempo di visione, percentuale media di visione e iscritti acquisiti.list_youtube_comments / reply_to_youtube_comment: legge e risponde ai commenti come canale.
L'unità è davvero un video: post_to_youtube accetta un videoUrl e non esiste affatto un percorso per le immagini. Due vincoli minori da conoscere prima di un caricamento automatico: un progetto Google non verificato blocca videos.insert su privato a prescindere da ciò che chiedi, e le miniature personalizzate richiedono un canale con numero di telefono verificato.
Limiti di YouTube da conoscere prima di automatizzare qualsiasi cosa
| Testo | Un titolo YouTube è limitato a 100 caratteri, e il testo di un elemento programmato diventa il titolo. La descrizione è un campo separato fino a 5.000 caratteri, con fino a 30 tag. Viene applicata quando il post viene creato o messo in coda, quindi un post troppo lungo viene rifiutato mentre sei ancora lì per correggerlo, invece di essere tagliato in silenzio all'uscita. |
|---|---|
| Visibilità | Pubblico, non in elenco o privato. Non esiste una bozza di Studio: “l'API di YouTube può caricare come pubblico, non in elenco o privato, ma non può creare una bozza di Studio”. Quindi non in elenco è la cosa più vicina a uno stato di revisione, ed è ciò che un post immediato usa come default, così un caricamento pronto per l'annuncio non diventa pubblico per errore. |
| Carosello | Rifiutato, per nome. “L'unità di YouTube è un video, non un insieme di immagini fisse. Trasforma le diapositive in un video (Hermoso può unirle) e pubblica quello, oppure togli YouTube da questo post.” Hermoso non ha inventato questo limite per evitare lavoro; è semplicemente ciò che è YouTube. Il rifiuto arriva alla messa in coda, con la strada da seguire allegata, invece di una prima diapositiva pubblicata in silenzio. |
| Quale account | Nessuno. YouTube pubblica sul canale collegato. |
Provalo in Claude Code
Chiedilo con un linguaggio normale. Sono frasi semplici, non un DSL:
«Per ogni file in ./films, scrivi un titolo sotto i 100 caratteri e una descrizione completa, genera una miniatura, caricalo come non in elenco, e scrivi un CSV con gli id e gli URL dei video.»
Questo percorre make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights. 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 su YouTube: la parte che morde
I caricamenti in blocco sono dove emerge la trappola dei metadati: la didascalia diventa il titolo, limitato a 100 caratteri, mentre la descrizione è un campo separato di 5.000 caratteri con fino a 30 tag. Passali entrambi esplicitamente. E controlla lo stato del canale prima del blocco: un progetto Google non verificato blocca i caricamenti su privato, e le miniature personalizzate richiedono un canale verificato con telefono.
Il plugin non contiene un manifesto di strumenti, il che conta soprattutto in un'esecuzione lunga senza sorveglianza: l'agente lancia il comando hermoso per ogni passaggio, e --json su qualsiasi comando gli dà un output macchina da verificare.
Studia YouTube prima di pubblicare
search_youtube cerca nell'indice pubblico di YouTube. È una domanda diversa da «cosa ho caricato», e per quella c'è list_youtube_videos. Per il video di un concorrente, analyze_video restituisce la voce fuori campo, il testo sullo schermo e la lista dei momenti con i timestamp, che è esattamente ciò che ti serve prima di rifare un hook.
La parte a pagamento
Gli strumenti Google Ads di Hermoso creano campagne di ricerca, display e Performance Max (l'intero albero in un'unica operazione atomica, riletto da Google prima che il tuo agente lo descriva), oltre a volumi di Keyword Planner, azioni di conversione, e sitelink e callout creati e collegati. Non esiste un generatore di campagne video per YouTube, e sarebbe sbagliato suggerirlo; un asset video di YouTube si può caricare e collegare, ma i tipi di campagna che Hermoso crea sono ricerca, display e Performance Max.
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 non è volutamente senza interfaccia: collegare un account è una schermata di consenso OAuth, quindi colleghi il canale una volta nel browser. Tutto il resto è una chiamata di strumento.
Il resto della matrice
Da Claude Code, pubblica su: Facebook · Instagram · Threads · TikTok · X · LinkedIn · Pinterest · Bluesky · Telegram. Oppure vedi tutto ciò su cui Claude Code può pubblicare.
Pubblica su YouTube da: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Marketing con Claude Code
Domande frequenti
Claude Code può pubblicare su YouTube?
Sì, con il plugin di Hermoso per 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. Claude Code dispone poi di 922+ strumenti, inclusi quelli che pubblicano su YouTube, più quelli che cercano gli annunci già attivi nel tuo mercato e generano il creativo da zero.
Come collego YouTube a Claude Code?
Due passaggi, una volta ciascuno. 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. Poi collega YouTube dentro Hermoso in Impostazioni → Connettori, che è una schermata di consenso OAuth nel browser. Dopo, Claude Code pubblica su YouTube come una normale chiamata di strumento.
Claude Code può pubblicare un post privato o come bozza su YouTube?
Sì: pubblico, non in elenco o privato. Nell'API di YouTube non esiste una bozza di Studio, quindi non in elenco è lo stato di revisione, ed è il default di un post immediato. Hermoso rifiuta una visibilità che YouTube non può garantire nel momento in cui la chiedi, invece di pubblicare silenziosamente qualcosa di più debole.
Quanto costa pubblicare su YouTube da Claude Code?
Pubblicare su YouTube non costa crediti; YouTube non addebita nulla per chiamata API. I crediti si spendono generando il video e la miniatura. I piani costano $29, $69 e $149 al mese per 1.200, 3.000 e 7.000 crediti, e ogni funzione è inclusa in ogni piano, compreso il piano Gratuito. L'unica eccezione è l'SSO aziendale.
Qual è il limite di caratteri della didascalia YouTube quando pubblico da Claude Code?
Un titolo YouTube è limitato a 100 caratteri. La descrizione è un campo separato fino a 5.000 caratteri, con fino a 30 tag. Il testo di un elemento programmato diventa il titolo, quindi entrambi devono essere passati esplicitamente. Hermoso lo applica quando il post viene creato o messo in coda, quindi Claude Code lo sa subito invece di fallire più tardi, quando nessuno sta guardando.
Claude Code può programmare un post YouTube per più tardi?
Sì. schedule_post lo mette in coda su un calendario condiviso con tutti gli altri canali, con una didascalia per canale se il testo deve differire, e list_scheduled e cancel_scheduled lo leggono e lo ritirano. YouTube è uno degli undici canali che accettano la coda.
Inizia gratis con 30 crediti alla registrazione e altri 250+ da guadagnare. Ogni funzione è inclusa in ogni piano.
Inizia gratis → Vedi i prezzi