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 Pinterest e cosa Pinterest 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 Pinterest 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 Pinterest che ottiene Claude Code
list_pinterest_boards: le bacheche dell'account, incluse quelle segrete, con i loro id.create_pinterest_board: crea una nuova bacheca.post_to_pinterest: crea un Pin immagine o video su una bacheca che indichi, con titolo, descrizione, link di destinazione e testo alternativo.schedule_post: mette in coda il Pin, portandoboardId.list_pinterest_ads_campaigns / pinterest_ads_report: leggono il lato a pagamento.
Il limite di cui hai bisogno prima di pianificare un flusso su Pinterest: questa app ha l'accesso Trial, e Pinterest rifiuta la creazione di Pin in produzione con accesso Trial. Le sue parole, rilevate sul primo Pin reale: «Le app con accesso Trial non possono creare Pin in produzione.» Bacheche e letture funzionano con Trial (elencare bacheche, crearle, leggere i Pin), e l'errore di Hermoso nomina il livello di accesso anziché dirti di ricollegare, perché ricollegare non può risolverlo. Un upgrade all'accesso Standard è ciò che sblocca la creazione dei Pin, ed è in attesa di revisione. Lo stesso livello limita il lato a pagamento: con Trial, Pinterest non espone alcun account pubblicitario.
Limiti di Pinterest da conoscere prima di automatizzare qualsiasi cosa
| Testo | La descrizione di un Pin è limitata a 800 caratteri e il titolo a 100. Il limite è 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 durante la pubblicazione. |
|---|---|
| Visibilità | Pubblico, e il controllo è la bacheca, non il Pin. Un Pin eredita lo stato pubblico o segreto della sua bacheca, quindi «pubblicalo in un posto privato» si esprime scegliendo una bacheca segreta. Per questo la bacheca è un argomento obbligatorio e non un valore predefinito. |
| Carosello | Da 2 a 5 immagini, solo immagini. Entrambi i limiti vengono direttamente dall'OpenAPI v5 di Pinterest (minItems: 2, maxItems: 5), che è l'unica fonte leggibile a macchina pubblicata da Pinterest (il loro sito per sviluppatori è un'app renderizzata lato client che non restituisce nulla a un fetch). Non esiste una fonte per più video, quindi uno slide video viene rifiutato anziché scartato. |
| Quale account | boardId, ed è l'unico campo di identità rifiutato al momento della messa in coda anziché al momento della pubblicazione. Se lo ometti, non viene programmato nulla, perché «un Pin sulla bacheca sbagliata è un errore pubblico, quindi non ne scegliamo mai una per te». |
Provalo in Claude Code
Chiedilo con un linguaggio normale. Sono frasi semplici, non un DSL:
“Crea una board per ogni linea di prodotto, genera cinque Pin verticali per ciascuna con titoli e descrizioni, e scrivi l'intero piano in ./out/pinterest.json, pronto per la pubblicazione.”
Il flusso è list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. 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 Pinterest: la parte che morde
Uno script che prepara tutto e si ferma prima del Pin è la forma giusta per ora. Le board si leggono e si scrivono con l'accesso Trial; la creazione del Pin viene rifiutata in produzione da Pinterest stessa. Nota anche che boardId è l'unico campo identificativo che Hermoso rifiuta al momento dell'accodamento e non al momento della pubblicazione, perché «un Pin sulla board sbagliata è un errore pubblico, quindi non ne scegliamo mai uno al posto tuo».
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 Pinterest prima di pubblicare
Non esiste una libreria annunci di Pinterest, quindi Hermoso non rivendica una ricerca concorrenti lì. Il creativo che potresti far girare lì è coperto bene dal resto dello studio: make_template_ad e i modelli di immagini producono le immagini verticali, ricche di testo, che la piattaforma premia.
La parte a pagamento
Esistono strumenti per gli annunci Pinterest: una campagna, un gruppo di annunci e un annuncio che promuove un Pin esistente, con l'archiviazione al posto dell'eliminazione, perché l'API Ads di Pinterest non ha un verbo di eliminazione (i Pin e le bacheche organici si eliminano, con delete_pinterest_pin e delete_pinterest_board; sono gli oggetti a pagamento che si possono solo archiviare). Ma lo stesso livello Trial che blocca la creazione dei Pin non espone account pubblicitari, quindi le scritture pubblicitarie non sono utilizzabili finché non arriva l'accesso Standard. Questo è lo stato onesto, ed è meglio dirlo in una frase qui che scoprirlo sotto scadenza.
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 · X · LinkedIn · Bluesky · Telegram. Oppure vedi tutto ciò su cui Claude Code può pubblicare.
Pubblica su Pinterest 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 Pinterest?
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 Pinterest, più quelli che cercano gli annunci già attivi nel tuo mercato e generano il creativo da zero.
Come collego Pinterest 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 Pinterest dentro Hermoso in Impostazioni → Connettori, che è una schermata di consenso OAuth nel browser. Dopo, Claude Code pubblica su Pinterest come una normale chiamata di strumento.
Claude Code può pubblicare un carosello su Pinterest?
Sì in linea di principio: da 2 a 5 immagini, solo immagini, direttamente dall'OpenAPI v5 di Pinterest. In pratica la creazione del Pin in produzione è bloccata finché questa app ha l'accesso Trial. 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.
Claude Code può programmare un post Pinterest 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. Pinterest è uno degli undici canali che accettano la coda.
Claude Code ha bisogno della mia password di Pinterest?
No. Colleghi Pinterest 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 Pinterest da Claude Code?
Pinterest non fa pagare nulla per chiamata API, quindi pubblicare non costa crediti. I crediti si spendono per generare il creativo dei Pin. 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.
Inizia gratis con 30 crediti alla registrazione e altri 250+ da guadagnare. Ogni funzione è inclusa in ogni piano.
Inizia gratis → Vedi i prezzi