Pubblica su TikTok da Claude Code

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 TikTok e cosa TikTok 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 TikTok 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 TikTok che ottiene Claude Code

• post_to_tiktok: pubblica un video finito, o un post fotografico fino a 35 immagini, in diretta sul profilo con la privacy che scegli, oppure nelle bozze TikTok da finire nell'app. Trasporta anche le impostazioni di interazione (commenti, duet, stitch), il fotogramma di copertina e la dichiarazione di contenuto di marca.
• schedule_post: lo mette in coda per dopo sul calendario condiviso, con la privacy fissata nel momento in cui lo metti in coda.
• tiktok_account / tiktok_creator_info: la bio dell'account, la verifica, il numero di follower e di video, e i livelli di privacy che l'account stesso consente.
• tiktok_post_status: segue un post che TikTok sta ancora elaborando, così un caricamento lento viene controllato invece di essere pubblicato due volte.
• list_tiktok_videos / tiktok_account_insights: post recenti con visualizzazioni, like, commenti e condivisioni, e le statistiche dell'account, con i dati demografici dei follower su un account Business con 100 o più follower.
• list_tiktok_comments / reply_to_tiktok_comment / moderate_tiktok_comment: legge i commenti sui tuoi post, risponde come account, e mette mi piace, nasconde o elimina, una volta collegata l'autorizzazione dell'account TikTok.
• search_tiktok: ricerca per parola chiave su TikTok pubblico, che è la metà della ricerca.

Altri due fatti operativi. I post fotografici TikTok vengono prelevati da un URL anziché caricati, quindi l'host che serve le immagini deve essere verificato nel portale sviluppatori di TikTok prima che i post fotografici possano uscire del tutto. E una bozza non porta fotogramma di copertina: su un post diretto Hermoso imposta il fotogramma migliore del video come copertina, mentre per una bozza scegli la copertina nell'app TikTok.

Limiti di TikTok da conoscere prima di automatizzare qualsiasi cosa

Provalo in Claude Code

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

«Renderizza tre varianti dell'hook, pubblica pubblicamente la più forte, carica le altre due nelle bozze di TikTok, e stampa gli id di pubblicazione.»

Questo percorre search_tiktok → plan_ad → render_ad → post_to_tiktok. 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 TikTok: la parte che morde

Imposta la privacy nel comando, ogni volta. TikTok non ammette un valore predefinito, quindi un passaggio che la omette viene rifiutato prima di caricare qualsiasi cosa, che è il fallimento giusto per un'esecuzione senza sorveglianza. Una pubblicazione ancora in elaborazione torna come in sospeso; interroga tiktok_post_status con l'id di pubblicazione anziché riprovare, perché un nuovo tentativo è un secondo post.

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 TikTok prima di pubblicare

Hermoso non ha una ricerca nella libreria annunci TikTok del tipo che usa su Meta, quindi la ricerca su TikTok è organica: search_tiktok trova ciò che funziona per parola chiave, e analyze_video scompone una clip nel suo gancio, nei beat e nel testo a schermo, così che lo schema possa essere riutilizzato invece che indovinato.

La parte a pagamento

TikTok Ads è una delle dodici piattaforme a pagamento su cui Hermoso costruisce e legge le campagne, comprese le campagne Smart+ e gli Spark Ads che promuovono un post organico, ed è una connessione separata da quella organica. Le campagne girano sulla Marketing API di TikTok e la pubblicazione sull'approvazione per la pubblicazione di contenuti, quindi Hermoso riporta ciascuna separatamente invece di lasciare che una implichi l'altra. Solo un cambio di stato con conferma arma denaro reale.

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

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

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 TikTok, più quelli che cercano gli annunci già attivi nel tuo mercato e generano il creativo da zero.

Come collego TikTok 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 TikTok dentro Hermoso in Impostazioni → Connettori, che è una schermata di consenso OAuth nel browser. Dopo, Claude Code pubblica su TikTok come una normale chiamata di strumento.

Claude Code può pubblicare un carosello su TikTok?

Sì. Un post fotografico TikTok accetta fino a 35 immagini, nell'ordine in cui le passi, e l'ordine è la presentazione. Il video non può essere mischiato. Claude Code chiama lo stesso strumento di pubblicazione in entrambi i casi, e un canale che non può ospitare un carosello viene rifiutato con il motivo reale allegato.

Claude Code può programmare un post TikTok 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. TikTok è uno degli undici canali che accettano la coda.

Claude Code ha bisogno della mia password di TikTok?

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

Quanto costa pubblicare su TikTok da Claude Code?

Pubblicare su TikTok non costa crediti; TikTok non addebita nulla per chiamata API. I crediti si spendono sul render. 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.