Pubblica, pianifica e gestisci annunci da Codex

Cos'è Codex?

Codex è l'agente di programmazione di OpenAI, usato dal terminale, dall'estensione IDE o dall'app desktop di ChatGPT. Funziona sia in modo interattivo sia non interattivo, il che lo rende il client a cui si ricorre quando un lavoro di marketing deve girare su una pianificazione anziché in una conversazione.

Codex o ChatGPT? Codex è l'agente di programmazione di OpenAI e accetta Hermoso come plugin o come server MCP. La app chat di ChatGPT aggiunge invece Hermoso dalla sua directory di app.

Hermoso è marketing in automatico: 922+ strumenti su un unico endpoint MCP che coprono la ricerca di annunci dei concorrenti, annunci finiti in immagine e video con oltre 100 modelli, pubblicazione e programmazione su undici canali social, e gestione delle campagne su Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads e AppLovin Ads. Una sola connessione, e Codex ha tutto.

Collega Hermoso a Codex

1. Un comando, nessuna chiave.

   codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso

   Codex legge il file del marketplace nel repository pubblico di Hermoso e installa le sue cinque skill (research, ad-from-brand, generate, product-photoshoot e marketing). Le skill eseguono il comando hermoso tramite npx, quindi nelle tue sessioni non viene caricato nessun elenco di strumenti e nulla costa contesto finché non viene eseguito un comando.
2. Accedi una volta.

   npx -y hermoso auth login

   Si apre l'accesso nel browser e viene salvata una credenziale con permessi solo per il proprietario in ~/.hermoso/config.json. Nessun browser su quella macchina, per esempio in CI o in un container? Crea una chiave in MCP e CLI → Terminale e chiavi API ed esegui npx -y hermoso auth login --token hmk_…. Una chiave dà piena facoltà di spesa, quindi trattala come una password.
3. Facoltativo: anche il server MCP.

   codex mcp add hermoso -- npx -y hermoso mcp

   Questo scrive il server in ~/.codex/config.toml e legge la stessa credenziale salvata, quindi nel file non va nessuna chiave. Preferisci l'endpoint ospitato? codex mcp add hermoso --url https://app.hermoso.ai/mcp, poi codex mcp login hermoso per l'accesso OAuth. Le skill raggiungono tutti gli strumenti senza nessuna delle due.
4. Chiedi qualcosa a Codex. “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.

Codex conserva i server MCP in ~/.codex/config.toml, oppure in .codex/config.toml in un progetto attendibile, e quel file è TOML, non JSON: un blocco mcpServers copiato non si caricherà, e una voce scritta a mano è [mcp_servers.hermoso] con command = "npx" e args = ["-y", "hermoso", "mcp"]. Il mcp finale è essenziale: npx -y hermoso senza sottocomando stampa l'aiuto ed esce. Codex legge i marketplace dei plugin nello stesso formato .claude-plugin usato da Claude Code, ed è per questo che un solo repository si installa in entrambi.

Ogni canale su cui Codex può pubblicare

Ognuno di questi ha la sua pagina, con il limite reale di caratteri della didascalia, le opzioni di visibilità reali, cosa rifiuta e perché, e un esempio formulato per Codex.

Tutti passano da un unico calendario schedule_post con didascalie per canale, e list_scheduled riporta l'esito per canale invece di un semplice segno verde, perché “il job è riuscito” e “il post è uscito” sono domande diverse. Un post programmato vive in Hermoso, quindi esce in orario anche se Codex non è più in funzione.

Google Business Profile è il canale più recente: post con una foto e un pulsante sulla tua scheda di Google Ricerca e Maps, risposte alle recensioni, modifiche alla scheda, e le chiamate, i clic sul sito e le richieste di indicazioni che la scheda genera. Codex lo raggiunge con gli stessi strumenti, e schedule_post lo mette in coda sullo stesso calendario.

Un canale costruito ma non offerto

Essere diretti su questo vale più di un elenco più lungo. Nel codice esiste una superficie di pubblicazione che è trattenuta, in attesa della piattaforma e non di noi:

• Reddit: la pubblicazione organica e le statistiche dei post sono costruite, ma la Responsible Builder Policy di Reddit richiede un'approvazione scritta esplicita prima che un'app possa usare la Data API, e quella approvazione non è ancora arrivata. Il connettore è trattenuto invece di essere offerto come schermata OAuth che porta a un'API inattiva. Reddit Ads è un'altra connessione ed è attiva: l'intera struttura di campagne, le previsioni, la ricerca di targeting, i pixel e i moduli lead.

Un connettore che ti darebbe un OAuth riuscito e un'API inattiva è peggio di uno non ancora offerto, quindi non è elencato come disponibile.

Tre cose da digitare una volta collegato

1. Ricerca. “Chi sono i miei tre concorrenti più vicini, e quali sono le loro inserzioni Meta più longeve? Dimmi quale gancio continua a ripetersi.” Esegue find_competitors → pull_competitor_ads → mine_angles.
2. Crea. “Fammi un video annuncio UGC 9:16 con quel gancio, con la foto reale del mio prodotto e i sottotitoli applicati.” Esegue get_brand → plan_ad → render_ad, e restituisce un URL di un mp4 finito.
3. Pubblica. “Programma la pubblicazione su Instagram e TikTok per martedì alle 9, e costruisci attorno ad essa una campagna Meta in pausa rivolta agli Stati Uniti con $30 al giorno.” Esegue schedule_post → create_meta_campaign → create_meta_ad.

Cosa Codex 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 è deliberatamente tuo: collegare ogni account, una volta. La maggior parte dei canali si collega tramite la schermata di consenso OAuth della piattaforma nel browser; Bluesky richiede una password per le app e Telegram un token del bot, incollati in Hermoso. Tutto il resto è una chiamata di strumento.

In modalità interattiva Codex mostra la chiamata prima di eseguirla. In modalità non interattiva non c'è nessuno a cui chiedere, cosa che conviene tenere presente per ogni passaggio che pubblica o spende.

Quanto costa

Aggiungere Hermoso a Codex non costa nulla in più: c'è un solo contatore di crediti, e non importa quale client lo ha chiamato. Un account gratuito parte con 30 crediti alla registrazione e altri 250+ da guadagnare. I crediti si spendono solo per i modelli IA e per la ricerca Ad Spy; pubblicazione, programmazione, gestione degli annunci e analisi sono gratuite su ogni canale tranne X, che addebita per chiamata perché X ci addebita ogni richiesta API. I piani a pagamento costano $29, $69 e $149 al mese per 1.200, 3.000 e 7.000 crediti, e ogni funzione è inclusa in ogni piano. hermoso_capabilities indica il prezzo esatto in crediti di ogni render prima che parta.

Risoluzione dei problemi

• Un server locale stampa l'aiuto ed esce. Mancano gli argomenti: il mcp finale. npx -y hermoso da solo stampa l'aiuto; npx -y hermoso mcp avvia il server.
• Su quella macchina non c'è un browser. Crea una chiave in MCP & CLI → Terminal & API keys ed esegui invece npx -y hermoso auth login --token hmk_….
• Manca un canale. Collegalo in Hermoso in Impostazioni → Connettori, poi chiedi a Codex di eseguire di nuovo list_connectors.
• Codex risponde senza usare Hermoso. Nominalo nella richiesta: “usa Hermoso per …”. Così non ci sono dubbi su quali strumenti debbano fare il lavoro.

Oltre la pubblicazione

La pubblicazione è l'ultimo passo, ed è quello più piccolo. La stessa connessione dà a Codex le librerie di annunci di Meta, Google e LinkedIn, più TikTok, Instagram, YouTube, Reddit e Threads organici per la ricerca; oltre 100 modelli di immagini, video, voce e scrittura su un unico contatore di crediti, con avatar UGC, doppiaggio, upscaling e formati annuncio HTML nativi; e l'intera struttura di campagne su dodici piattaforme a pagamento. Non ci sono chiavi API di fornitori da custodire né un'app separata da imparare.

Vedi l'elenco completo degli strumenti, ogni agente con cui lavora Hermoso, oppure cos'è un MCP per il marketing. Per la storia più lunga su questo client in particolare, vedi Inserzioni dalla riga di comando.

Hermoso negli altri agenti

Lo stesso account Hermoso funziona in ogni agente qui sotto, quindi il tuo brand, la libreria, il calendario e i crediti ti seguono da uno all'altro.

Domande frequenti

Codex può pubblicare sui social?

Sì, una volta installato Hermoso. Codex può pubblicare su Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram e Google Business Profile, e programmare su tutti e undici da un'unica coda, con didascalie per canale.

Come aggiungo Hermoso a Codex?

Esegui codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, che installa le skill di Hermoso, poi accedi una volta con npx -y hermoso auth login. L'accesso apre il browser e salva da solo la credenziale, quindi non c'è nessuna chiave da creare né da incollare. Per il server MCP esegui anche codex mcp add hermoso -- npx -y hermoso mcp. Codex conserva i server MCP in ~/.codex/config.toml, oppure in .codex/config.toml in un progetto attendibile, e quel file è TOML, non JSON: un blocco mcpServers copiato non si caricherà, e una voce scritta a mano è [mcp_servers.hermoso] con command = "npx" e args = ["-y", "hermoso", "mcp"]. Il mcp finale è essenziale: npx -y hermoso senza sottocomando stampa l'aiuto ed esce. Codex legge i marketplace dei plugin nello stesso formato .claude-plugin usato da Claude Code, ed è per questo che un solo repository si installa in entrambi.

Codex può fare ricerche sulle inserzioni dei miei concorrenti?

Sì. Da Codex si possono cercare le librerie inserzioni di Meta, Google e LinkedIn insieme a TikTok, Instagram, YouTube, Reddit e Threads organici, ordinate per durata, perché un'inserzione ancora attiva dopo mesi è un'inserzione che si ripaga da sola. Può anche analizzare a fondo la strategia di un concorrente e restituire il voiceover di un video, il testo a schermo e l'elenco dei beat con i timestamp.

Mi serve un account separato per usare Hermoso in Codex?

No. Basta un account Hermoso, e Codex si autentica con quello. Il passaggio di accesso salva la credenziale da solo, quindi non c'è nulla da incollare. Lo studio web su app.hermoso.ai è lo stesso motore e gli stessi crediti.

È sicuro lasciare che Codex pubblichi e gestisca annunci per me?

Hermoso tiene dietro a gate sul proprio server i passaggi che costano denaro o non si possono annullare, qualunque sia l'impostazione di Codex: ogni campagna viene creata in pausa, l'attivazione della spesa e le eliminazioni richiedono una conferma esplicita, e un post raggiunge solo un account che hai collegato e selezionato in Hermoso. In modalità interattiva Codex mostra la chiamata prima di eseguirla. In modalità non interattiva non c'è nessuno a cui chiedere, cosa che conviene tenere presente per ogni passaggio che pubblica o spende.

Codex condivide la configurazione Hermoso tra CLI e app desktop?

Sì, per i server MCP. OpenAI documenta un solo file di configurazione, ~/.codex/config.toml, condiviso dalla CLI di Codex, dall'estensione IDE e da Codex nell'app desktop di ChatGPT, quindi un server aggiunto con codex mcp add compare in tutti e tre.