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 Instagram e cosa Instagram 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 Instagram 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 Instagram che ottiene Claude Code
post_to_meta: pubblica su Instagram contarget: "instagram". Instagram è un canale visivo e l'API è d'accordo: un post richiede un'immagine o un video.schedule_post: lo mette in coda sul calendario condiviso, con una didascalia per canale se il testo deve differire dalla tua versione Facebook o LinkedIn.list_meta_comments / reply_to_meta_comment / moderate_meta_comment: legge, risponde e modera sotto un post.meta_page_insights / meta_post_insights: portata, impressioni, salvataggi e interazioni, per account e per post.search_instagram: ricerca per parola chiave tra i Reel pubblici di Instagram, per la ricerca anziché la pubblicazione.
Due fatti su Instagram da conoscere prima di automatizzare qualsiasi cosa. Nell'API di Meta non c'è una programmazione nativa di Instagram, quindi una programmazione è la coda di Hermoso e non quella di Instagram, e passare il scheduleAt di Facebook per Instagram viene rifiutato invece di pubblicare subito in silenzio. E una didascalia Instagram non può essere modificata una volta che il post è online: l'unica cosa che Meta permette di cambiare su un post pubblicato è se i commenti sono attivi. Eliminarne uno è supportato: manage_meta_post rimuove post normali, Storie, Reel e interi album a carosello, ma mai una singola scheda da un album.
Limiti di Instagram da conoscere prima di automatizzare qualsiasi cosa
| Testo | Una didascalia Instagram è limitata a 2.200 caratteri. 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à | Solo pubblico. L'API di pubblicazione dei contenuti di Meta pubblica subito o per niente, e Instagram “non ha post non in elenco, privati o in bozza.” Se vuoi una revisione su Instagram, deve avvenire prima della chiamata, non dopo. |
| Carosello | Da 2 a 10 diapositive, e immagini e video possono essere mischiati. Quel limite superiore è di Meta, citato nella tabella delle capacità che applica: “I caroselli sono limitati a 10 immagini, video o un mix dei due.” Il minimo di 2 è nostro, perché una sola diapositiva non è un carosello su nessuna piattaforma. Una richiesta con una sola diapositiva viene pubblicata come post normale invece di essere rifiutata. |
| Quale account | pageId. Instagram pubblica tramite la Pagina Facebook collegata, quindi lo stesso campo di identità la seleziona. |
Provalo in Claude Code
Chiedilo con un linguaggio normale. Sono frasi semplici, non un DSL:
«Crea un carosello di 5 slide da ./assets/slides, controlla che ciascuna rientri nei limiti di Instagram, pubblicalo e salva il permalink nelle note di rilascio.»
Questo percorre search_instagram → plan_ad → render_ad → post_to_meta (target: "instagram"). 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 Instagram: la parte che morde
Una didascalia Instagram non si può modificare una volta che il post è online, quindi costruisci la verifica nello script anziché nelle scuse: fai mostrare a Claude Code l'ordine delle slide e la didascalia, e solo dopo chiama lo strumento di pubblicazione. Se un render risulta sbagliato, manage_meta_post elimina l'intero post, album compresi. L'ordine conta più di quanto si pensi. La slide 2 deve seguire la slide 1, e Hermoso mantiene esattamente l'ordine che passi.
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 Instagram prima di pubblicare
search_meta_ads copre anche i posizionamenti Instagram oltre a Facebook, dato che è una sola libreria. Per l'organico, search_instagram cerca i Reel pubblici per parola chiave, che è la superficie in cui il formato si muove davvero; i recuperi di profili e hashtag passano da fetch_social_data e search_instagram_hashtag.
La parte a pagamento
I posizionamenti Instagram si acquistano attraverso la stessa struttura di campagne Meta di Facebook: create_meta_campaign → create_meta_adset → create_meta_ad, con posizionamenti selezionabili per piattaforma e posizione. preview_meta_ad mostra l'annuncio reale renderizzato per posizionamento prima che tu spenda, e meta_insights scompone i risultati per età, genere, posizionamento e paese. Quella scomposizione è ciò che modella il creativo successivo.
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 · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Oppure vedi tutto ciò su cui Claude Code può pubblicare.
Pubblica su Instagram 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 Instagram?
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 Instagram, più quelli che cercano gli annunci già attivi nel tuo mercato e generano il creativo da zero.
Come collego Instagram 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 Instagram dentro Hermoso in Impostazioni → Connettori, che è una schermata di consenso OAuth nel browser. Dopo, Claude Code pubblica su Instagram come una normale chiamata di strumento.
Claude Code ha bisogno della mia password di Instagram?
No. Colleghi Instagram 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.
Claude Code può programmare un post Instagram 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. Instagram è uno degli undici canali che accettano la coda.
Claude Code può pubblicare un carosello su Instagram?
Sì, da 2 a 10 diapositive, e immagini e video possono essere mischiati. Dieci è il limite pubblicato da Meta stessa, non uno inventato da Hermoso. 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.
Quanto costa pubblicare su Instagram da Claude Code?
Pubblicare su Instagram non costa crediti; Meta non addebita nulla per chiamata API. I crediti vanno sul render stesso. 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.
Inizia gratis con 30 crediti alla registrazione e altri 250+ da guadagnare. Ogni funzione è inclusa in ogni piano.
Inizia gratis → Vedi i prezzi