Lancia annunci dalla riga di comando

Gli strumenti pubblicitari sono quasi interamente dashboard, il che li rende quasi impossibili da automatizzare. Non puoi pianificare con cron una dashboard, non puoi inviare una dashboard a jq e non puoi chiedere a un agente da terminale di cliccarne una. La CLI di Hermoso esiste perché il ciclo pubblicitario smetta di essere un posto che visiti e diventi qualcosa che puoi programmare.

Installa e accedi:

npm install -g hermoso
hermoso auth login

auth login avvia un listener locale e apre il browser, con lo stesso schema usato da gh e firebase, quindi non c'è nulla da incollare. La chiave generata viene scritta in ~/.hermoso/config.json con permessi riservati al proprietario (cartella 0700, file 0600), perché porta con sé una vera autorità di spesa. Per la CI, hermoso auth login --token <key> ne salva una in modo non interattivo, e HERMOSO_TOKEN / HERMOSO_API_BASE sovrascrivono la configurazione dall'ambiente.

I comandi

Ogni comando accetta --json, che è il punto di tutto: la riga leggibile è una comodità, il JSON è il contratto.

Due superfici, un pacchetto, e perché conta

Gli agenti da terminale pagano gli strumenti due volte: una volta nel manifesto che portano nel contesto, e una volta nei token che costa ogni chiamata. Un manifesto con oltre 922 strumenti non è gratuito. Quindi lo stesso pacchetto offre entrambe le superfici e lascia scegliere l'agente:

• MCP (hermoso mcp, oppure l'endpoint ospitato https://app.hermoso.ai/mcp) quando vuoi la superficie completa e argomenti tipizzati ricchi.
• Comandi da sottoprocesso quando vuoi il percorso economico in token: l'agente lancia il comando, legge il JSON e non carica mai un manifesto. È lo schema usato dalle competenze Claude incluse.

Entrambe usano la stessa API, addebitano gli stessi crediti e scrivono nella stessa libreria, quindi nulla resta bloccato da un lato.

Cose utili da automatizzare

• Un controllo settimanale dei concorrenti. hermoso competitors in hermoso ads, confronto con la settimana precedente, e hai un report permanente su cosa il tuo mercato ha iniziato e smesso di pubblicizzare.
• Creatività in lotto per un catalogo. Cicla sugli SKU, genera un annuncio basato su ciascun prodotto e raccogli gli URL restituiti. È il genere di lavoro davvero noioso in un'interfaccia.
• Un controllo dei crediti in CI. hermoso credits --json | jq .balance e far fallire la pipeline prima che inizi un lungo lotto con un saldo vuoto.
• Scelta del modello in base al costo. hermoso capabilities --json espone i costi esatti per modello, quindi uno script può scegliere il modello più economico che soddisfa il brief invece di fissarne uno.

Pubblicazione e campagne

I sottocomandi della CLI coprono ricerca e creazione. Pubblicazione, programmazione 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 vivono nella superficie MCP, raggiungibile dallo stesso pacchetto con hermoso mcp, dall'endpoint ospitato o dallo studio web. Le destinazioni di pubblicazione sono Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram e Google Business Profile.

Cosa non farà senza chiedere

Un agente con un budget è utile solo se il raggio d'azione è limitato, quindi l'autorità di spesa è vincolata nel server e non in un prompt. Campagne, set di annunci e annunci Meta vengono creati PAUSED senza possibilità di sostituire il valore dal chiamante. Gli interruttori di stato che possono attivare una spesa pubblicitaria reale (uno su ogni piattaforma pubblicitaria: set_meta_campaign_status, set_google_ads_status, set_microsoft_ads_status, set_reddit_ads_status, set_linkedin_ads_status, set_pinterest_ads_status, set_x_ads_status e set_openai_ads_status, tra gli altri) si rifiutano di funzionare senza un flag di conferma esplicito, e lo stesso controllo copre la creazione di un gruppo di annunci, di un annuncio o di una parola chiave Google Ads attivi sotto un elemento padre già attivo, perché questo viene mostrato alla prossima asta. Anche le eliminazioni richiedono conferma. Sul fronte della generazione, hermoso_capabilities pubblica il costo esatto in crediti di ogni modello prima che qualsiasi cosa venga eseguita, e ogni render riserva una stima e poi addebita il costo reale, quindi un invio fallito viene rimborsato invece di farti pagare in silenzio.

Lavori dentro un agente invece che in una shell? Vedi marketing con Claude Code e la documentazione completa MCP e CLI.

Domande frequenti

Esiste uno strumento da riga di comando per lanciare annunci?

Sì. npm install -g hermoso installa la CLI di Hermoso, che ricerca annunci dei concorrenti nelle librerie di Meta, Google e LinkedIn, crea un profilo di brand da un sito, pianifica e genera annunci finiti immagine e video, e riporta crediti e lavori, con output --json su ogni comando per la programmazione. Lo stesso pacchetto serve anche il server MCP completo con oltre 922 strumenti via stdio.

Come mi autentico con la CLI di Hermoso?

Esegui hermoso auth login. Apre un accesso dal browser tramite listener locale (lo stesso schema usato da gh e firebase) e salva la chiave generata in ~/.hermoso/config.json con permessi riservati al proprietario (cartella 0700, file 0600). Per la CI, hermoso auth login --token <key> ne salva una in modo non interattivo, e HERMOSO_TOKEN e HERMOSO_API_BASE sovrascrivono la configurazione dall'ambiente.

Posso inviare l'output a jq?

Sì. Ogni comando accetta --json e stampa un oggetto strutturato. Quello è il contratto previsto; la riga leggibile è solo una comodità. hermoso credits --json | jq .balance è un utile controllo in CI prima di un lungo lotto di render.

Perché usare la CLI invece del server MCP?

Il costo in token. Un client MCP carica il manifesto degli strumenti nel contesto, e oltre 922 strumenti non sono gratuiti. Un agente da terminale che lancia comandi da sottoprocesso e legge il JSON non porta con sé alcun manifesto. Entrambe le superfici usano la stessa API, addebitano gli stessi crediti e scrivono nella stessa libreria, quindi puoi combinarle.

La CLI può pubblicare su Facebook o gestire gli annunci Meta?

Pubblicazione, programmazione 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 vivono nella superficie MCP invece che nei sottocomandi della CLI, raggiungibile dallo stesso pacchetto eseguendo hermoso mcp, dall'endpoint ospitato su https://app.hermoso.ai/mcp o dallo studio web. Le destinazioni di pubblicazione sono Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram e Google Business Profile.

Funziona con un server locale?

Sì. Imposta HERMOSO_API_BASE sulla tua origine (per esempio http://localhost:3000) e sia la CLI sia il server MCP la useranno come destinazione. Una base localhost non richiede un token di autenticazione.

Correlati

I render girano come lavori lato server che interroghi, e un post ritentato è sicuro anche quando non si conosce l'esito del primo tentativo. I dettagli sono in lavori e idempotenza.

Lavori già in Claude Code? Vedi marketing con Claude Code.