Kjør annonser fra kommandolinjen

Annonseverktøy er nesten utelukkende dashbord, og det gjør dem nesten umulige å automatisere. Du kan ikke sette opp cron-jobber for et dashbord, du kan ikke sende et dashbord inn i jq, og du kan ikke be en terminalagent klikke i ett. Hermoso CLI finnes slik at annonsearbeidet slutter å være et sted du besøker, og blir noe du kan skripte.

Installer og logg inn:

npm install -g hermoso
hermoso auth login

auth login starter en lytter på loopback og åpner nettleseren, samme mønster som gh og firebase bruker, så det er ingenting å lime inn. Nøkkelen som lages, skrives til ~/.hermoso/config.json med tillatelser bare eieren har (mappen 0700, filen 0600), fordi den har ekte fullmakt til å bruke penger. For CI lagrer hermoso auth login --token <key> en nøkkel uten interaksjon, og HERMOSO_TOKEN / HERMOSO_API_BASE overstyrer konfigurasjonen fra miljøet.

Kommandoene

Hver kommando tar --json, og det er hele poenget: den lesbare linjen er en bekvemmelighet, mens JSON-en er kontrakten.

To flater, én pakke, og hvorfor det betyr noe

Terminalagenter betaler for verktøy to ganger: én gang i manifesten de bærer i konteksten, og én gang i tokenene hvert kall koster. En manifest med over 922 verktøy er ikke gratis. Derfor leverer den samme pakken begge flatene og lar agenten velge:

• MCP (hermoso mcp, eller den hostede https://app.hermoso.ai/mcp) når du vil ha hele flaten og rike, typede argumenter.
• Underprosesskommandoer når du vil ha den token-billige veien: agenten kjører kommandoer i skallet, leser JSON og laster aldri inn en manifest i det hele tatt. Dette er mønsteret de medfølgende Claude-skillsene bruker.

Begge treffer det samme API-et, belaster de samme kreditene og skriver til det samme biblioteket, så ingenting blir liggende hengende på den ene siden.

Ting det er verdt å skripte

• En ukentlig konkurrentsjekk. hermoso competitors inn i hermoso ads, sammenlign med forrige uke, og du har en fast rapport over hva markedet ditt begynte og sluttet å kjøre.
• Batchkreativt materiale for et katalog. Gå gjennom SKU-ene, render én forankret annonse per produkt, og samle URL-ene som returneres. Det er den typen jobb som er virkelig kjedelig i et grensesnitt.
• En kredittvakt i CI. hermoso credits --json | jq .balance og stopp pipelinen før en lang batch starter mot en tom saldo.
• Kostnadsbevisst valg av modell. hermoso capabilities --json viser eksakte kostnader per modell, så et skript kan velge billigste modell som oppfyller briefen, i stedet for å hardkode én.

Publisering og kampanjer

CLI-underkommandoene dekker research og produksjon. Publisering, planlegging og kampanjestyring på Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads og AppLovin Ads ligger i MCP-flaten. Du når den fra samme pakke med hermoso mcp, fra det hostede endepunktet eller fra web-studioet. Publiseringsmål er Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram og Google Business Profile.

Det den ikke gjør uten å spørre

En agent med et budsjett er bare nyttig hvis det som kan gå galt, er begrenset. Derfor styres bruken av penger i serveren, ikke i en prompt. Meta-kampanjer, annonsesett og annonser opprettes som PAUSED, og ingen kan overstyre det fra klienten. Statusbryterne som kan aktivere ekte annonsebruk (én på hver annonseplattform: 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 og set_openai_ads_status blant andre) nekter å kjøre uten et eksplisitt bekreftelsesflagg. Det samme gjelder for å opprette en aktivert Google Ads-annonsegruppe, annonse eller nøkkelord under en allerede aktivert forelder, fordi den da vises i neste auksjon. Sletting krever også bekreftelse. På genereringssiden publiserer hermoso_capabilities den eksakte kreditkostnaden for hver modell før noe kjøres, og hvert render reserverer et estimat og gjør opp den faktiske kostnaden etterpå. Feiler en utsending, får du pengene tilbake i stedet for at du stille og rolig blir belastet.

Jobber du inne i en agent i stedet for et skall? Se markedsføringsautomatisering i Claude Code og den fulle MCP- og CLI-referansen.

Ofte stilte spørsmål

Finnes det et kommandolinjeverktøy for å kjøre annonser?

Ja. npm install -g hermoso installerer Hermoso CLI, som researcher konkurrentannonser på tvers av annonsebibliotekene til Meta, Google og LinkedIn, lager en merkevareprofil fra et nettsted, planlegger og rendrer ferdige bilde- og videoannonser, og rapporterer kreditter og jobber. Hver kommando har --json-utdata for skripting. Den samme pakken serverer også hele MCP-serveren med over 922 verktøy over stdio.

Hvordan autentiserer jeg Hermoso CLI?

Kjør hermoso auth login. Den åpner en innlogging i nettleseren via loopback (samme mønster som gh og firebase bruker) og lagrer nøkkelen som lages i ~/.hermoso/config.json med tillatelser bare eieren har (mappen 0700, filen 0600). For CI lagrer hermoso auth login --token <key> en nøkkel uten interaksjon, og HERMOSO_TOKEN og HERMOSO_API_BASE overstyrer konfigurasjonen fra miljøet.

Kan jeg sende utdataen videre til jq?

Ja. Hver kommando godtar --json og skriver ut et strukturert objekt. Det er den tiltenkte kontrakten. Den lesbare linjen er bare en bekvemmelighet. hermoso credits --json | jq .balance er en nyttig CI-vakt før en lang renderbatch.

Hvorfor bruke CLI-en i stedet for MCP-serveren?

Tokenkostnad. En MCP-klient laster verktøymanifesten inn i konteksten, og over 922 verktøy er ikke gratis. En terminalagent som kjører underprosesskommandoer og leser JSON, bærer ingen manifest i det hele tatt. Begge flatene treffer det samme API-et, belaster de samme kreditene og skriver til det samme biblioteket, så du kan blande dem.

Kan CLI-en publisere til Facebook eller styre Meta-annonser?

Publisering, planlegging og kampanjestyring på Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads og AppLovin Ads ligger i MCP-flaten og ikke i CLI-underkommandoene. Du når den fra samme pakke ved å kjøre hermoso mcp, fra det hostede endepunktet på https://app.hermoso.ai/mcp, eller fra web-studioet. Publiseringsmål er Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram og Google Business Profile.

Fungerer det mot en lokal server?

Ja. Sett HERMOSO_API_BASE til din egen origin (for eksempel http://localhost:3000), så peker både CLI-en og MCP-serveren dit. En localhost-base trenger ingen autentiseringstoken.

Relatert

Render kjøres som jobber på serveren som du spør etter, og et nytt forsøk på et innlegg er trygt selv når utfallet av det første forsøket er ukjent. Detaljene står i jobber og idempotens.

Setter du det opp inne i Claude Code i stedet? Se markedsføring med Claude Code.