Perché gli agenti (e chi li usa) scelgono Hermoso: un solo connettore è un punto unico per oltre 100 modelli di immagini, video, voce e scrittura: Seedance, Veo, Kling, MiniMax H3 e Gemini Omni per i video; Nano Banana, Imagen, Flux, Seedream e GPT Image per le immagini fisse; più voci premium e modelli di scrittura di classe Claude, Gemini e GPT, tutto su un solo contatore di crediti, senza chiavi API o account di ciascun fornitore da gestire. E oltre ai modelli grezzi, lo stesso connettore copre l'intero flusso pubblicitario: ricerca dei concorrenti nelle librerie annunci di Meta, Google e LinkedIn, pianificazione creativa, render finiti con il brand, post-produzione, valutazione, pubblicazione e gestione delle campagne. I costi esatti in crediti per ogni render sono pubblicati in hermoso_capabilities, quindi un agente ben fatto può darti un numero prima di spendere qualsiasi cosa.
Hermoso è l'MCP di marketing che gestisce l'intero ciclo pubblicitario. La maggior parte degli MCP di marketing si limita a gestire le campagne; Hermoso crea e pubblica anche l'annuncio. Collegalo al tuo agente e ricerca, crea, pubblica e gestisci annunci finiti direttamente dai tuoi prompt, con oltre 922 strumenti, il contesto del tuo brand salvato e i tuoi crediti. Installalo da npm (npm install -g hermoso). È open source su github.com/hermoso-ai/hermoso.
Connessione con un clic: Apri in ChatGPT · Aggiungi a Cursor · Installa in VS Code · Claude Code: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso (Codex, Gemini CLI e Cursor: un comando ciascuno, nella configurazione qui sopra) · Claude.ai: incolla https://app.hermoso.ai/mcp in Impostazioni → Connettori · Meta Muse: un solo messaggio in chat lo configura, vedi Hermoso in Muse. Gli agenti possono trovare automaticamente la scheda del server su /.well-known/mcp.json. Presente anche nel registro ufficiale MCP (io.github.hermoso-ai/hermoso), su Smithery e su Glama.
Preferisci lo studio? Tutto ciò che fanno gli strumenti è disponibile anche nell'app web, su app.hermoso.ai.
Tre richieste da digitare una volta collegato
Sono frasi normali, non un linguaggio di programmazione. L'agente sceglie gli strumenti; tu approvi la spesa.
- Ricerca. “Quali sono i tre concorrenti più vicini a
oatly.com, e quali sono i loro annunci Meta attivi da più tempo? Dimmi quale hook continua a ripetersi.” Questo percorrefind_competitors→pull_competitor_ads→mine_angles. - Crea. “Fammi un video annuncio UGC 9:16 per il mio brand con quell'hook, con la foto reale del mio prodotto e i sottotitoli impressi.” Questo percorre
get_brand→plan_ad→render_ad, e restituisce l'URL del file mp4 finito. - Pubblica. “Programma il post per Instagram e TikTok martedì alle 9, e crea una campagna Meta in pausa costruita attorno a questo, rivolta agli Stati Uniti con $30 al giorno.” Questo percorre
schedule_post→create_meta_campaign→create_meta_ad.
Gli strumenti, per mansione
Tutti i 922+ strumenti su un unico server con OAuth. Richiamane uno qualsiasi da ChatGPT, Claude, Claude Desktop, Codex, Cursor, Cline, OpenClaw, Hermes, Grok Bot o qualsiasi altro client MCP. Ognuno restituisce un URL di asset durevole o un risultato strutturato, non un testo che il modello deve rileggere.
Cerchi l'elenco completo? Si trova in il riferimento degli strumenti, con lo schema reale dei parametri di ogni strumento e il JSON leggibile dalle macchine accanto. Quel riferimento è generato: viene costruito eseguendo il server MCP in produzione e leggendo indietro tools/list su un trasporto reale, quindi è esattamente la superficie che riceve il tuo client. Le categorie qui sotto sono un giro guidato, scritto a mano, degli strumenti che vale la pena conoscere per nome. Se i due non coincidono, fidati del riferimento. Documentazione completa per sviluppatori: hermoso.ai/docs.
Ricerca e spy sugli annunci: find_competitors, competitor_teardown, pull_competitor_ads, research_ads, mine_angles, score_ad, check_ad_policy, analyze_video; librerie annunci search_meta_ads, search_google_ads, search_linkedin_ads; social organici search_tiktok, search_instagram, search_youtube, search_reddit, search_threads, search_threads_keyword; fetch_social_data; playbook creativi list_skills, get_skill, save_skill.
Crea annunci finiti: brand draft_brand, get_brand, update_brand, use_brand, list_brands; piano plan_ad, plan_variations; render render_ad, generate_image, generate_video, generate_avatar, generate_voice, generate_text, make_template_ad (formati annuncio HTML nativi resi direttamente, quindi il tipo è pixel-perfect), make_explainer, product_sizzle, make_thumbnail; modifica e rifinitura remix_static, recast_motion, reframe_video, upscale_video, dub_video, change_voice, finish_video, fix_beat, post_edit, stitch_video, clip_video; asset list_product_photos, set_product_image, list_library, fetch_asset, upload_file.
Pubblica e programma sui tuoi canali: post_to_meta (Facebook / Instagram / Threads), post_to_tiktok, post_to_youtube, schedule_post (una coda unica per Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram e Google Business Profile), list_scheduled, cancel_scheduled, manage_meta_post, update_youtube_video, upload_meta_asset, list_meta_pages, youtube_channel, tiktok_account, list_tiktok_videos. YouTube va oltre il caricamento: list_youtube_videos, update_youtube_video, set_youtube_thumbnail (mette una miniatura Hermoso su un caricamento; è la leva più forte sul tasso di clic, e altrimenti YouTube sceglie un fotogramma a caso) e youtube_video_insights (visualizzazioni, tempo di visione, percentuale media di visione, iscritti guadagnati). Engagement: list_meta_comments, reply_to_meta_comment, moderate_meta_comment, list_threads_replies, reply_to_thread, list_youtube_comments, reply_to_youtube_comment. X / Twitter: post_to_x (testo, immagine, video, risposte, post citati, sondaggi e interi thread; 280 caratteri su un account normale e fino a 25.000 su uno con X Premium, letti dall'account e non dati per scontati, e mai troncati), post_x_article (l'Article lungo nativo di X, scritto in Markdown, con titoli, elenchi, citazioni, blocchi di codice e tabelle riportati), edit_x_post (riscrive un post già pubblicato, entro l'ora concessa da X), delete_x_post, x_post_metrics e x_post_insights (impression, mi piace, repost, risposte, citazioni, segnalibri), x_post_insights_historical (gli stessi numeri degli inserzionisti per qualsiasi intervallo di date, mentre x_post_insights vede solo le ultime 28 ore), x_mentions. X è l'unico connettore che addebita crediti per chiamata API, perché X ci addebita ogni richiesta, e un post che contiene un link costa circa 13× uno senza; il tuo agente riceve il prezzo prima di pubblicare. LinkedIn: list_linkedin_pages, post_to_linkedin_page, post_to_linkedin, manage_linkedin_post, linkedin_page_analytics (rendimento organico della Pagina: follower e crescita dei follower, visualizzazioni della Pagina, e impression, clic ed engagement dei post, per il totale della Pagina o per post). La pubblicazione su LinkedIn va alle Pagine aziendali che selezioni. Anche il profilo personale è disponibile, ma resta disattivato finché non lo condividi esplicitamente. Pinterest: list_pinterest_boards, create_pinterest_board, post_to_pinterest (Pin con immagine o video su una bacheca che scegli). Threads va oltre la pubblicazione: list_threads_posts, list_threads_replies, reply_to_thread, hide_thread_reply, delete_thread, list_threads_mentions, threads_insights.
Leggi e rispondi ai DM. list_inbox mette in un'unica lista tutto ciò che qualcuno ha scritto al brand: commenti di Facebook e Instagram, risposte e menzioni di Threads, commenti di YouTube e Reddit, recensioni Google, risposte Bluesky e menzioni X, più i messaggi diretti su Messenger, Instagram Direct, X, Bluesky e Telegram. reply_to_inbox_item risponde a uno qualsiasi di questi tramite id e instrada la risposta al canale giusto, così l'agente non deve mai sapere quale strumento di risposta usa una piattaforma. Per canale, quando vuoi l'intera conversazione invece dell'ultima riga: list_meta_conversations, read_meta_conversation, reply_to_meta_message; list_x_dms, send_x_dm; list_bluesky_convos, read_bluesky_dm, send_bluesky_dm, mark_bluesky_convo_read; list_telegram_dms, list_telegram_chats, post_to_telegram; e su WhatsApp send_whatsapp_message, send_whatsapp_broadcast, list_whatsapp_templates, create_whatsapp_template. instagram_profile trasforma un @handle Instagram nell'id numerico dell'account che Meta richiede davvero. Ciò che ogni piattaforma consente è diverso, e Hermoso ti dice quale regola stai affrontando invece di farti scoprire tutto da un rifiuto: Meta consente una risposta entro 24 ore da quando la persona ha scritto, e quella finestra viene verificata gratis prima di qualsiasi invio; Telegram è una finestra mobile di 24 ore e non una casella di posta, perché la Bot API non pubblica alcun endpoint di cronologia; X conserva 30 giorni di messaggi diretti e fattura per messaggio letto. WhatsApp va considerato a parte, perché rispondere lì non è una risposta nella casella: Hermoso invia su WhatsApp tramite send_whatsapp_message, sia un modello approvato da Meta per aprire una conversazione sia una risposta libera entro la finestra di 24 ore del servizio clienti di Meta, e ti chiede di confermare il testo esatto e il numero esatto prima, perché raggiunge un telefono vero e Meta addebita al business la conversazione. Meta inoltre non pubblica alcun endpoint di cronologia per WhatsApp, quindi una conversazione precedente al collegamento non può essere recuperata a nessun prezzo. LinkedIn e Threads non pubblicano un'API di messaggi diretti utilizzabile, quindi nessuna delle due è offerta.
Invia un messaggio WhatsApp, o trasmettilo a tutta la lista. send_whatsapp_broadcast porta un modello approvato a una lista di clienti, a un segmento o a un lancio, e compila per ciascuna persona i valori {{1}} e {{2}}, così mille persone ricevono un messaggio che le nomina invece dello stesso messaggio di massa ripetuto mille volte. Meta non pubblica un endpoint in blocco, quindi è un invio scaglionato di un messaggio per destinatario, e viene eseguito come job in coda che interroghi invece di una chiamata che aspetta: i numeri duplicati vengono rimossi prima di qualsiasi invio, un numero che Meta non può usare viene rifiutato per nome invece di essere scartato in silenzio, e ogni destinatario porta il proprio esito nel risultato, così un fallimento parziale viene segnalato come parziale e mai come successo. Eseguilo prima con dryRun: non costa nulla, non invia nulla, e riporta il numero reale di destinatari, la categoria attuale del modello, quanto Meta addebiterà per esso, e se la lista rientra nel limite mobile di messaggi nelle 24 ore del tuo portfolio business. Meta addebita direttamente i messaggi, per messaggio, alle tariffe del suo paese, quindi una trasmissione non spende crediti Hermoso. Due regole sono di Meta e non nostre, e sono entrambe permanenti: una trasmissione è sempre un modello approvato, perché il testo libero è legale solo nella finestra di 24 ore che si apre quando quella persona scrive per prima; e WhatsApp richiede che il destinatario abbia dato il consenso, cosa che l'API non verifica e che resta responsabilità del business.
Un unico calendario di contenuti per tutti i canali: schedule_post mette in coda un render finito su uno o più canali a un orario scelto, con didascalie per canale; list_scheduled legge ciò che è in coda e ciò che è già partito, con gli esiti per canale; cancel_scheduled ritira un post prima che esca. Nello studio la stessa coda è un vero calendario con viste mensile, settimanale ed elenco: trascini un post per riprogrammarlo, modifichi o duplichi qualsiasi voce, e hai fasce orarie fisse in cui inserire i lavori. Hermoso pubblica all'orario stabilito; non serve tenere aperto nulla.
Gestisci le campagne pubblicitarie Meta: create_meta_campaign, create_meta_adset, create_meta_ad, find_meta_audiences, list_meta_ads, meta_insights, meta_page_insights, meta_post_insights, update_meta_object, set_meta_campaign_status, delete_meta_object. Gli oggetti vengono creati in pausa, e ogni spesa ed eliminazione richiede conferma. Prima di impegnare un budget: preview_meta_ad mostra l'annuncio reale per posizionamento come link da visionare, e estimate_meta_reach dice quante persone raggiunge davvero una specifica di targeting. Pubblici: list_meta_audiences e create_meta_audience creano retargeting da pixel del sito, pubblici di engagement di Pagina e Instagram, e lookalike, e creare un pubblico non costa nulla. meta_insights suddivide il rendimento per età, genere, posizionamento e paese. La pagina Facebook Ads MCP illustra ogni strumento Meta e il targeting che espone.
Gestisci le campagne Google Ads: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, add_google_ads_keywords, set_google_ads_budget, set_google_ads_bidding, set_google_ads_targeting, set_google_ads_status, find_google_ads_locations, upload_google_ads_asset, list_google_ads_campaigns, google_ads_report (GAQL). L'intero albero viene costruito in un'unica operazione atomica, poi riletto da Google prima che l'agente descriva ciò che ha creato. Oltre all'albero: create_google_ads_conversion_action e list_google_ads_conversion_actions (ciò che Google conta come risultato; TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS e ogni campagna Performance Max non sono realizzabili senza di esso, quindi Hermoso rifiuta di costruirli su un account che non ne ha), create_google_ads_performance_max_campaign (il tipo di campagna cross-superficie di Google), add_google_ads_assets (sitelink, callout e snippet strutturati, creati e collegati, perché un asset non collegato non mostra nulla) e google_ads_keyword_ideas (Keyword Planner: volume di ricerca mensile reale, concorrenza e offerte medie in cima alla pagina, così le parole chiave si scelgono dai dati e non si indovinano).
Gestisci LinkedIn, Pinterest, Microsoft, X, TikTok, Snapchat, ChatGPT, Apple Search Ads e AppLovin Ads: lo stesso schema, in pausa per default e con conferma, su ogni altra piattaforma a pagamento. LinkedIn: list_linkedin_ads_campaigns, linkedin_ads_report, create_linkedin_ads_campaign_group, create_linkedin_ads_campaign, create_linkedin_ads_creative, search_linkedin_ads_targeting, set_linkedin_ads_budget, set_linkedin_ads_status, delete_linkedin_ads_object. Pinterest: list_pinterest_ads_campaigns, pinterest_ads_report, create_pinterest_ads_campaign, create_pinterest_ads_ad_group, create_pinterest_ads_ad, set_pinterest_ads_budget, set_pinterest_ads_status. Microsoft Advertising (Bing): list_microsoft_ads_campaigns, microsoft_ads_report, create_microsoft_ads_campaign, create_microsoft_ads_ad_group, create_microsoft_ads_ad, add_microsoft_ads_keywords, set_microsoft_ads_budget, set_microsoft_ads_status, microsoft_ads_geo_search (risolve i nomi di paese, regione e città negli id di località Microsoft che una campagna richiede; senza località una campagna Microsoft viene creata per servire in tutto il mondo, che è il default di Microsoft stesso, e la rilettura ti avvisa in modo esplicito). Reddit Ads, l'albero completo: list_reddit_ads_campaigns, reddit_ads_report, create_reddit_ads_campaign, create_reddit_ads_ad_group, create_reddit_ads_ad, create_reddit_ads_post (un annuncio Reddit promuove un post, quindi il creativo è un post), set_reddit_ads_status, più pianificazione gratuita con search_reddit_ads_targeting, reddit_ads_forecast e reddit_ads_bid_suggestion, tracciamento delle conversioni tramite list_reddit_ads_pixels e send_reddit_ads_conversions, retargeting e pubblici salvati, moduli lead, e reddit_ads_history. ChatGPT Ads (gli annunci che girano dentro una risposta di ChatGPT), tramite l'Advertiser API di OpenAI: list_openai_ads_campaigns, openai_ads_report, openai_ads_geo_search, create_openai_ads_campaign, create_openai_ads_ad_group, create_openai_ads_ad, update_openai_ads_object, set_openai_ads_budget, set_openai_ads_status. ChatGPT Ads ha esattamente un formato creativo, una scheda con testo e immagine, e nessun video, quindi l'agente ricaverà un fermo immagine dal tuo film invece di proporti lì un annuncio video. X Ads, l'albero completo dei post promossi, disponibile da agosto 2026: list_x_ads_accounts, list_x_ads_funding_instruments, x_ads_report, create_x_ads_campaign, create_x_ads_line_item (il nome X per un gruppo di annunci), create_x_ads_promoted_tweet, add_x_ads_targeting, x_ads_targeting_search, x_ads_geo_search, update_x_ads_campaign, update_x_ads_line_item, set_x_ads_status, delete_x_ads_object. Un annuncio X promuove un post, quindi il creativo è un post, lo stesso che post_to_x pubblica. TikTok Ads è una connessione SEPARATA dal connettore di pubblicazione TikTok, ed è l'unica piattaforma che crea oggetti ATTIVI per default, quindi Hermoso forza ogni livello in PAUSA senza eccezioni: list_tiktok_ads_accounts, list_tiktok_ads_campaigns, list_tiktok_ads_identities, search_tiktok_ads_targeting, tiktok_ads_report, create_tiktok_ads_campaign, create_tiktok_ads_ad_group, upload_tiktok_ads_creative, create_tiktok_ads_ad, set_tiktok_ads_budget, set_tiktok_ads_status, delete_tiktok_ads_object. Snapchat Ads: list_snapchat_ads_accounts, list_snapchat_ads_campaigns, list_snapchat_ads_profiles, search_snapchat_ads_targeting, snapchat_ads_report, upload_snapchat_ads_creative, create_snapchat_ads_campaign, create_snapchat_ads_ad_squad, create_snapchat_ads_ad, set_snapchat_ads_budget, set_snapchat_ads_status, delete_snapchat_ads_object. I budget sono in micro-valuta (1.000.000 = un'unità), il titolo del creativo è limitato a 34 caratteri, e un annuncio Snapchat punta a un CREATIVO e non a un id media. Tre note sull'accesso da avere prima di pianificare un budget: LinkedIn e Pinterest regolano entrambi le scritture degli annunci in base al livello di API che il tuo account pubblicitario possiede. Letture e report sono illimitati, mentre la creazione di campagne dipende dall'accesso che la piattaforma ha concesso al tuo account. Meta, Google Ads, Microsoft Advertising, Reddit Ads e ChatGPT Ads non hanno nessun livello del genere. X concede l'accesso API Ads per account pubblicitario e non per app, quindi invece di un pulsante OAuth aggiungi l'utente X di Hermoso al tuo account pubblicitario su business.x.com → Account access, e compare in list_x_ads_accounts con il permesso che X gli ha dato. AppLovin Ads si collega con una chiave incollata: applovin_ads_report funziona su qualsiasi account con la sua Reporting Key e applovin_ads_pixel con la sua Event Key, send_applovin_ads_events richiede la chiave Conversion API di AppLovin, e list_applovin_ads_campaigns, create_applovin_ads_campaign, update_applovin_ads_campaign, set_applovin_ads_status, gli strumenti dei set creativi e upload_applovin_ads_assets usano l'API Campaign Management di AppLovin, che AppLovin abilita account per account, come fa con la chiave Conversion API. Chiedi al tuo referente AppLovin di attivarle, poi incolla anche quelle chiavi.
Costruisci Apple Search Ads e leggile fino al termine di ricerca: annunci di ricerca App Store, dall'inizio alla fine. Costruzione: create_apple_ads_campaign, create_apple_ads_ad_group, add_apple_ads_keywords, add_apple_ads_negative_keywords, create_apple_ads_creative, create_apple_ads_ad, upload_apple_ads_asset, update_apple_ads_object, set_apple_ads_status, delete_apple_ads_object. Ogni oggetto viene creato in pausa senza eccezioni, attivarlo è l'unico interruttore che abilita una spesa reale e richiede conferma, e ogni riepilogo viene costruito da una rilettura di ciò che Apple ha effettivamente salvato. Gli annunci girano nel posizionamento scheda Search; una campagna dei risultati di ricerca non richiede né annuncio né creativo, perché Apple mostra da sola la tua pagina prodotto App Store, e Hermoso lo dice gratis invece di lasciare che Apple rifiuti la build. Lettura: list_apple_ads_campaigns (stato, stato di pubblicazione, budget giornaliero e totale, i paesi in cui gira, e il motivo indicato da Apple quando una campagna non può andare in onda), list_apple_ads_ad_groups (offerta predefinita, e se lo Search Match di Apple è attivo), list_apple_ads_keywords (targeting e negative, con tipo di corrispondenza e offerta), apple_ads_report (impression, tap, installazioni, spesa, TTR, CPT e CPA, a livello di campagna, gruppo di annunci, parola chiave, termine di ricerca o annuncio), list_apple_ads_creatives, list_apple_ads_ads, list_apple_ads_assets, list_apple_ads_product_pages (la tua scheda App Store e le eventuali pagine prodotto personalizzate, con il contenuto per lingua), search_apple_ads_apps e check_apple_ads_app_eligibility (quali posizionamenti, paesi e dispositivi la tua app può pubblicizzare, da leggere prima di costruire) e list_apple_ads_orgs. Non esiste un pulsante OAuth, perché Apple non pubblica alcun flusso OAuth: Hermoso genera la chiave di firma, tu incolli la sua metà pubblica in Apple Ads → Account Settings → API e incolli indietro tre id. Apple mostra quel campo solo a un utente con un ruolo API, quindi un Account Admin deve prima invitare o passare a un ruolo del genere. La guida Apple Search Ads connector illustra l'intero procedimento. Ogni connessione è legata all'unica organizzazione Apple Ads che hai scelto quando l'hai creata.
Report ed esportazione: Google Drive save_to_drive, list_drive_files, get_drive_file, update_drive_file, delete_drive_file, create_drive_folder; Sheets create_sheet, append_to_sheet, read_sheet; Docs create_doc, append_to_doc, read_doc; Microsoft OneDrive save_to_onedrive, list_onedrive_files, get_onedrive_file, update_onedrive_file, create_onedrive_folder, delete_onedrive_file. I lead vanno nel tuo CRM tramite l'HubSpot MCP: sync_leads_to_hubspot inserisce i lead dei moduli lead di Meta e LinkedIn come contatti, e hubspot_deals_report riporta le trattative per fase e fonte.
Memoria, profili, skill e team: remember, forget, list_memory, store_get; profili create_brand, delete_brand, use_brand, list_brands, così un'agenzia può prendere un nuovo cliente e chiuderne uno senza aprire l'app, e i profili sono illimitati su ogni piano; skill, ora un'unica libreria che ha assorbito il vecchio archivio “dipendenti IA”: save_skill, list_skills, get_skill, delete_skill; team invite_member, list_team, set_role, remove_member.
Account, impostazioni e connettori: hermoso_capabilities (verifica i modelli e i costi esatti per render; richiamalo per primo), hermoso_credits, buy_credits, billing_status, upgrade_plan, set_auto_reload, get_job, list_jobs, report_bug, request_feature; impostazioni get_settings, update_settings (lingua e aspetto, salvati sull'account e non nel browser, così un cliente che usa solo l'agente non resta in inglese); connettori list_connectors, list_connector_accounts, set_connector_accounts (scegli esattamente quali Pagine, account pubblicitari e bacheche sono utilizzabili; lo strumento riporta la rilettura del server, mai la richiesta), disconnect_connector. Collegare un account è una schermata di consenso OAuth, quindi è l'unico passaggio che richiede ancora un browser; tutto il resto è richiamabile dall'agente.