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 Facebook e cosa Facebook 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 Facebook 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 Facebook che ottiene Claude Code
post_to_meta: pubblica testo, un'immagine, un video o un post con più foto sulla Pagina, e accettapageIdcosì non deve indovinare quale Pagina.schedule_post: mette in coda lo stesso post per un orario che scegli, su un calendario condiviso con tutti gli altri canali.list_meta_pages: elenca le Pagine collegate all'account, con i loro id.manage_meta_post: modifica il testo di un post pubblicato, oppure lo elimina.list_meta_comments / reply_to_meta_comment / moderate_meta_comment: legge i commenti sotto un post, risponde come Pagina, e nasconde o elimina ciò che non dovrebbe esserci.meta_page_insights / meta_post_insights: portata, impressioni e interazioni a livello di Pagina e per post.upload_meta_asset: inserisce un render finito nella libreria asset dell'account pubblicitario.
Facebook è anche l'unico canale con la programmazione remota nativa. post_to_meta accetta un scheduleAt tra dieci minuti e trenta giorni da adesso e affida la tempistica a Meta stessa. Instagram e Threads non hanno nulla di simile nell'API di Meta, e passarlo per loro viene rifiutato invece di pubblicare subito in silenzio.
Limiti di Facebook da conoscere prima di automatizzare qualsiasi cosa
| Testo | Un post Facebook può arrivare a 63.206 caratteri, cioè di fatto nessun limite. Viene applicato 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 o bozza. Una bozza è una vera bozza di post di Pagina non pubblicata, che è quella utile per la revisione: esiste in Meta Business Suite e nessuno fuori può vederla. Non ci sono opzioni non in elenco né private: “un post di Pagina Facebook è o pubblicato o trattenuto come bozza non pubblicata”. |
| Carosello | Da 2 diapositive in su, solo foto. Meta non pubblica un massimo per attached_media che si possa reperire, quindi Hermoso non ne inventa uno e non lo attribuisce a Facebook. L'unico limite è il nostro, a 30 diapositive, e il rifiuto dice di chi è: “Facebook non pubblica un massimo documentato per attached_media, quindi questo limite è nostro, non loro.” Il video non può far parte di un carosello di foto su Facebook; è un altro vincolo dell'API di Meta, e Hermoso rifiuta invece di scartare in silenzio la clip. |
| Quale account | pageId. Conta nel momento in cui un brand collega più di una Pagina: il percorso di pubblicazione rifiuta esplicitamente invece di sceglierne una al posto tuo, e una programmazione che non riuscisse a trasportare la risposta trasformerebbe quel rifiuto in un errore ore dopo, con nessuno che guarda. |
Provalo in Claude Code
Chiedilo con un linguaggio normale. Sono frasi semplici, non un DSL:
«Prendi l'mp4 in ./renders, scrivi una didascalia dalla voce del brand, pubblicalo sulla Pagina come bozza non pubblicata, e scrivi l'id del post in ./out/posts.json.»
Questo percorre find_competitors → search_meta_ads → plan_ad → render_ad → list_meta_pages → post_to_meta. 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 Facebook: la parte che morde
Qui un agente da terminale è davvero meglio di una chat: l'id del post torna come risultato strutturato che puoi scrivere su un file e verificare in seguito. Facebook è anche l'unico canale con programmazione remota nativa (post_to_meta accetta un scheduleAt tra dieci minuti e trenta giorni), quindi uno script può affidare la tempistica a Meta stesso invece di tenere una coda.
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 Facebook prima di pubblicare
La Meta Ad Library è il più ricco archivio pubblico di creatività che esista, e search_meta_ads la legge per parola chiave o per pagina, coprendo i posizionamenti sia su Facebook sia su Instagram. pull_competitor_ads e competitor_teardown si basano su di essa, e find_competitors stabilisce a chi puntarle.
La parte a pagamento
Facebook è la superficie a pagamento più profonda che Hermoso ha. create_meta_campaign, create_meta_adset e create_meta_ad costruiscono l'intera struttura con un targeting reale: area geografica fino a un raggio attorno a una città, interessi, comportamenti, pubblici personalizzati e lookalike, posizionamenti, programmazione oraria, limiti di offerta e di costo. Tutto viene creato IN PAUSA, senza che il chiamante possa modificarlo, e il riepilogo che il tuo agente riporta è costruito rileggendo ciò che Meta ha effettivamente salvato, mai da ciò che è stato richiesto. Prima di impegnare un budget, preview_meta_ad genera l'annuncio reale per posizionamento come link da guardare, e estimate_meta_reach dice quante persone raggiunge davvero il targeting. Un avvertimento che fa risparmiare denaro: un set di inserzioni creato senza località ha come predefinito solo gli Stati Uniti, e la rilettura lo dice a voce alta.
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: Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Oppure vedi tutto ciò su cui Claude Code può pubblicare.
Pubblica su Facebook 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 Facebook?
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 Facebook, più quelli che cercano gli annunci già attivi nel tuo mercato e generano il creativo da zero.
Come collego Facebook 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 Facebook dentro Hermoso in Impostazioni → Connettori, che è una schermata di consenso OAuth nel browser. Dopo, Claude Code pubblica su Facebook come una normale chiamata di strumento.
Claude Code può pubblicare un post privato o come bozza su Facebook?
Sì. Facebook è l'unico canale con una vera bozza: un post di Pagina non pubblicato che esiste in Meta Business Suite e che nessuno fuori può vedere. Hermoso rifiuta una visibilità che Facebook non può garantire nel momento in cui la chiedi, invece di pubblicare silenziosamente qualcosa di più debole.
Quanto costa pubblicare su Facebook da Claude Code?
Pubblicare su Facebook non costa crediti, perché Meta non addebita nulla per chiamata API. I crediti si spendono per la generazione: il render dell'immagine o del video che il post contiene. 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 Facebook quando pubblico da Claude Code?
Un post Facebook può arrivare a 63.206 caratteri, cioè di fatto nessun limite. 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 Facebook 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. Facebook è 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