Pubblica su X da Claude Code

Hermoso è un server MCP di marketing: 922+ strumenti su un unico endpoint protetto da OAuth che permettono a un agente di cercare gli annunci già attivi in un mercato, generare annunci finiti in immagine e video, pubblicarli e costruire le campagne a pagamento che li sostengono. Claude Code raggiunge tutto attraverso un'unica connessione. Questa pagina copre una parte: cosa Claude Code può fare davvero su X, e cosa X non gli permette di fare.

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.

Poi collega X stesso, una volta, in Impostazioni → Connettori dentro Hermoso. È una schermata di consenso OAuth, quindi è l'unico passaggio che richiede il browser. Tutto il resto è una chiamata di strumento.

Gli strumenti X che ottiene Claude Code

• post_to_x: pubblica testo, un'immagine o un video con testo alternativo, un intero thread, una risposta, un post di citazione o un sondaggio, e può limitare chi è autorizzato a rispondere.
• post_x_article: pubblica un Articolo lungo. Scrivilo in Markdown e titoli, elenchi, citazioni, link, blocchi di codice e tabelle passano tutti intatti.
• edit_x_post: riscrive un post già pubblicato, entro l'ora che X consente.
• schedule_post: lo mette in coda nel calendario condiviso.
• x_post_metrics: i conteggi pubblici di un post.
• x_post_insights: numeri di livello inserzionista solo per le ultime 28 ore: impression, clic sul link, visite al profilo, visualizzazioni video e quartili di completamento.
• x_post_insights_historical: gli stessi numeri su qualsiasi intervallo di date, fino a 25 post alla volta. È quello per «come è andato il mese scorso».
• x_mentions: chi parla del brand.
• delete_x_post: elimina un post.

X è l'unico connettore che costa denaro per chiamata, e i numeri sono pubblicati anziché nascosti. Meta, TikTok, LinkedIn, YouTube, Threads e Drive non costano nulla per richiesta; X fa pagare noi, quindi quelle chiamate addebitano ciascuna un piccolo numero di crediti. Un post semplice costa $0.015 per richiesta, e un post con un link $0.200, circa 13× di più. Eliminazioni, letture e la scrittura del testo alternativo hanno ciascuna il proprio prezzo, e gli insight si addebitano per post restituito. Il rilevamento dei link è volutamente prudente e presume che un link ci sia, perché sbagliare nell'altro senso ci costa 13×. In pratica, su X un buon post batte cinque post, e il tuo agente vede il prezzo prima di pubblicare. La lunghezza dipende dall'account che pubblica, non è fissa a 280. Hermoso legge l'abbonamento X dell'account e invia fino a 25.000 caratteri dove Premium lo consente, quindi un post lungo parte intero invece di tornare rifiutato, e nulla viene mai troncato. È anche la forma più economica: un post lungo è una sola chiamata X addebitata, mentre le stesse parole divise in cinque post sono cinque chiamate. X Premium sblocca anche due cose che Hermoso pubblica per te: un Articolo lungo, scritto in Markdown con titoli, elenchi, citazioni, blocchi di codice e tabelle intatti, e una modifica a un post già pubblicato, entro l'ora che X consente.

I limiti di X da conoscere prima di automatizzare qualsiasi cosa

Provalo in Claude Code

Chiedilo con un linguaggio normale. Sono frasi semplici, non un DSL:

“Trasforma ./notes/launch.md in un thread su X di non più di cinque post, lascia il link solo nell'ultimo e dimmi il costo prima di pubblicare.”

Il flusso è get_brand → generate_text → post_to_x → x_post_insights_historical. Claude Code chiede prima di eseguire uno strumento, e la trascrizione è lì nel terminale, quindi un passo di pubblicazione è una riga che puoi leggere prima di premere y.

Claude Code su X: la parte che morde

Metti il link in un solo post, non in cinque. Un post con un link costa circa 13 volte uno semplice, quindi un thread in cui ogni post contiene un link è la forma costosa, e il rilevamento dei link è volutamente prudente e considera presente un link quando c'è il dubbio. Il testo oltre il limite viene rifiutato, non troncato, e l'eccedenza viene conteggiata. In uno script questo significa un errore pulito che puoi gestire, invece di un post inviato a metà.

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.

Ricerca su X prima di pubblicare

Non esiste una libreria annunci di X da cercare. La ricerca su X qui riguarda il tuo account: menzioni, metriche dei post e i numeri storici degli inserzionisti. Il resto della ricerca non cambia: le librerie annunci di Meta, Google e LinkedIn, e TikTok, Instagram, YouTube, Reddit e Threads organici.

La parte a pagamento

X Ads è arrivato ad agosto 2026, quindi X ora è entrambe le cose. L'API di X Ads è un prodotto separato su un host separato con la propria firma OAuth 1.0a, ed è per questo che è arrivata dopo il resto. Hermoso ora costruisce su di essa l'intero albero dei post promossi: campagna, line item (il nome che X dà al gruppo di annunci), post promosso, targeting, budget, stato e reportistica. Un annuncio X promuove un post, quindi il creativo è un post, lo stesso che Hermoso pubblica in modo organico. L'interruttore che attiva i soldi veri rifiuta di partire senza una conferma esplicita, come sulle altre undici piattaforme. Una cosa da sapere prima di pianificare un budget: X concede l'accesso all'API Ads per account pubblicitario anziché per app, quindi non c'è un pulsante OAuth per questo: aggiungi l'utente X di Hermoso al tuo account pubblicitario su business.x.com → Accesso account, e compare in list_x_ads_accounts con il livello di permesso assegnato da X.

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 · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. Oppure vedi tutto ciò su cui Claude Code può pubblicare.

Pubblica su X 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 X?

Sì, con il plugin di Claude Code di Hermoso. Un solo comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, oppure, in una sessione, /plugin marketplace add hermoso-ai/hermoso e poi /plugin install hermoso@hermoso. Installa cinque skill di Hermoso che usano la CLI hermoso, quindi nelle tue sessioni non viene caricato nessun elenco di strumenti. Accedi una volta con npx -y hermoso auth login, che apre il browser e salva da solo la credenziale, quindi non c'è nessuna chiave da creare né da incollare. Claude Code ha poi oltre 922+ strumenti, inclusi quelli che pubblicano su X, più quelli che fanno ricerca sulle inserzioni già attive nel tuo mercato e generano il creativo da zero.

Come collego X a Claude Code?

Due passaggi, una volta ciascuno. Un solo comando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, oppure, in una sessione, /plugin marketplace add hermoso-ai/hermoso e poi /plugin install hermoso@hermoso. Installa cinque skill di Hermoso che usano la CLI hermoso, quindi nelle tue sessioni non viene caricato nessun elenco di strumenti. Accedi una volta con npx -y hermoso auth login, che apre il browser e salva da solo la credenziale, quindi non c'è nessuna chiave da creare né da incollare. Poi collega X in Hermoso da Impostazioni → Connettori, che è una schermata di consenso OAuth nel browser. Dopodiché Claude Code pubblica su X come una normale chiamata di strumento.

Claude Code ha bisogno della mia password di X?

No. Colleghi X a Hermoso una sola volta tramite una schermata di consenso OAuth nel browser, e poi Claude Code lo raggiunge come chiamata di strumento. Collegare un account è l'unico passaggio che non avviene senza interfaccia; tutto ciò che viene dopo non richiede una password, e nessuna credenziale viene mai consegnata al modello.

Claude Code può programmare un post su X per più tardi?

Sì. schedule_post lo mette in coda su un calendario condiviso con tutti gli altri canali, con una didascalia specifica per canale se il testo deve cambiare, e list_scheduled e cancel_scheduled lo leggono e lo ritirano. X è uno degli undici canali che passano da questa coda.

Claude Code può pubblicare un carosello su X?

No. L'API di X allega fino a quattro media a un post e vengono mostrati come una griglia, con ogni immagine visibile subito e nulla da far scorrere, quindi un mazzo di slide numerate non può essere pubblicato lì come previsto. Claude Code chiama comunque lo stesso strumento di pubblicazione, e un canale che non può ospitare un carosello viene rifiutato con il motivo reale allegato.

Quanto costa pubblicare su X da Claude Code?

X è l'unico connettore che addebita crediti per chiamata, perché X fa pagare ogni richiesta API: circa $0.015 per un post e $0.200 per un post con un link, cioè circa 13 volte di più. Il tuo agente vede il prezzo prima di pubblicare. 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, incluso Free. Unica eccezione: l'SSO aziendale.