Annonceværktøjer er næsten udelukkende dashboards, og det gør dem næsten umulige at automatisere. Du kan ikke sætte et dashboard i cron, du kan ikke sende et dashboard gennem jq, og du kan ikke bede en terminalagent klikke i et. Hermoso CLI'en findes, så annoncekredsløbet holder op med at være et sted, du besøger, og bliver noget, du kan scripte.
Installér og log ind:
npm install -g hermoso
hermoso auth loginauth login starter en loopback-lytter og åbner browseren, samme mønster som gh og firebase bruger, så der er intet at indsætte. Den udstedte nøgle skrives til ~/.hermoso/config.json med rettigheder, kun din bruger kan læse (mappen 0700, filen 0600), fordi den bærer reel udgiftsautoritet. Til CI gemmer hermoso auth login --token <key> en nøgle uden interaktion, og HERMOSO_TOKEN / HERMOSO_API_BASE overskriver konfigurationen fra miljøet.
Kommandoerne
Hver kommando tager --json, og det er hele pointen: den menneskelæsbare linje er en bekvemmelighed, mens JSON'en er kontrakten.
| Kommando | Hvad den gør |
|---|---|
hermoso capabilities | Gyldige model-id'er og deres præcise kreditomkostninger. Kør den først. Den er gratis og skrivebeskyttet, og det er sådan, du holder op med at gætte modelnavne. |
hermoso credits | Saldo, forbrug i sessionen og seneste prisede kald. |
hermoso brand --domain example.com | Læser en hjemmeside ind i en brandprofil (produkter, farver, logo, tone), som senere renders bygger på. |
hermoso competitors --domain example.com | Finder direkte konkurrenter og lignende brands, det er værd at lære af. |
hermoso ads --company "Brand" | Henter den pågældende annoncørs rigtige kørende annoncer fra Meta-, Google- og LinkedIn-annoncebibliotekerne, uden dubletter og sorteret. |
hermoso research "longest-running protein bar ads" | Research i annoncer med naturligt sprog på tværs af bibliotekerne plus organisk TikTok, og returnerer de annoncer, den fandt. |
hermoso create --brand … --product … --format video | Omsætter et brief til et færdigt annoncekoncept: tekstvarianter plus et billedkoncept eller et videostoryboard, med model-id'erne til at rendere det. |
hermoso generate image --prompt "…" --ref ./bottle.png | Renderer og returnerer en serveret URL. --ref indsætter dit rigtige produkt, så etiketten på skærmen er din faktiske SKU. |
hermoso jobs / hermoso fetch <url> | Undersøg renders, der kører; find en URL til enhver asset, både en klikbar og en direkte download-URL. |
hermoso mcp | Serverer den fulde 922+ værktøjers MCP-overflade over stdio, de samme værktøjer som den hostede server eksponerer. |
To overflader, én pakke, og hvorfor det betyder noget
Terminalagenter betaler for værktøjer to gange: én gang i manifestet, de bærer i konteksten, og én gang i tokens hvert kald koster. Et manifest med 922+ værktøjer er ikke gratis. Derfor leverer den samme pakke begge overflader og lader agenten vælge:
- MCP (
hermoso mcp, eller den hostedehttps://app.hermoso.ai/mcp), når du vil have hele overfladen og rige typede argumenter. - Underprocess-kommandoer, når du vil have den token-billige vej: agenten kører i shell, læser JSON og indlæser aldrig et manifest. Det er mønsteret de medfølgende Claude-skills bruger.
Begge rammer den samme API, bruger de samme kreditter og skriver til det samme bibliotek, så intet ender fast på den ene side.
Ting, der er værd at scripte
- En ugentlig konkurrentgennemgang.
hermoso competitorsind ihermoso ads, sammenlign med sidste uge, og du har en fast rapport over, hvad dit marked er begyndt og holdt op med at køre. - Batch-kreativt indhold til et katalog. Gennemgå SKU'erne, render én grundet annonce pr. produkt, og saml de returnerede URL'er. Det er den slags opgave, der er rigtig kedelig i et UI.
- En kreditvagt i CI.
hermoso credits --json | jq .balance, og lad pipelinen fejle, før en lang batch starter mod en tom saldo. - Omkostningsbevidst modelvalg.
hermoso capabilities --jsonviser præcise omkostninger pr. model, så et script kan vælge den billigste model, der opfylder briefet, i stedet for at hardcode én.
Udgivelse og kampagner
CLI-underkommandoerne dækker research og oprettelse. Udgivelse, planlægning og kampagnestyring 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-overfladen. Den er tilgængelig fra samme pakke med hermoso mcp, fra det hostede endpoint eller fra den webbaserede studio. Udgivelsesmål er Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram og Google Business Profile.
Hvad den ikke gør uden at spørge
En agent med et budget er kun nyttig, hvis det, den kan ramme, er afgrænset. Derfor styres udgiftsrettighederne i serveren og ikke i en prompt. Meta-kampagner, annoncesæt og annoncer oprettes som PAUSED uden mulighed for at overskrive det fra kalderen. Statusskifterne, der kan slå rigtige annonceudgifter til (én på hver annonceplatform: 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 blandt dem), kører ikke uden et eksplicit bekræftelsesflag. Den samme gate dækker oprettelse af en aktiveret Google Ads-annoncegruppe, annonce eller søgeord under en allerede aktiveret forælder, fordi den vises ved næste auktion. Sletninger kræver også bekræftelse. På genereringssiden publicerer hermoso_capabilities hver models præcise kreditomkostning, før noget kører, og hver render reserverer et estimat og afregner så den faktiske pris. En fejlet afsendelse bliver dermed refunderet i stedet for stille at blive faktureret.
Arbejder du inde i en agent i stedet for en shell? Se Claude Code-markedsføring og den fulde MCP & CLI-reference.
Ofte stillede spørgsmål
Findes der et kommandolinjeværktøj til at køre annoncer?
Ja. npm install -g hermoso installerer Hermoso CLI'en, som researcher konkurrenters annoncer på tværs af Meta-, Google- og LinkedIn-annoncebibliotekerne, laver en brandprofil ud fra en hjemmeside, planlægger og renderer færdige billed- og videoannoncer og rapporterer kreditter og jobs, med --json-output på hver kommando til scripting. Samme pakke serverer også den fulde 922+ værktøjers MCP-server over stdio.
Hvordan autentificerer jeg Hermoso CLI'en?
Kør hermoso auth login. Det åbner et loopback-login i browseren (samme mønster som gh og firebase bruger) og gemmer den udstedte nøgle i ~/.hermoso/config.json med rettigheder, kun din bruger kan læse (mappen 0700, filen 0600). Til CI gemmer hermoso auth login --token <key> en nøgle uden interaktion, og HERMOSO_TOKEN og HERMOSO_API_BASE overskriver konfigurationen fra miljøet.
Kan jeg pipe outputtet til jq?
Ja. Hver kommando accepterer --json og udskriver et struktureret objekt. Det er den tilsigtede kontrakt; den menneskelæsbare linje er kun en bekvemmelighed. hermoso credits --json | jq .balance er en nyttig CI-vagt før en lang renderbatch.
Hvorfor bruge CLI'en i stedet for MCP-serveren?
Tokenomkostning. En MCP-klient indlæser værktøjsmanifestet i konteksten, og 922+ værktøjer er ikke gratis. En terminalagent, der kører underprocess-kommandoer i shell og læser JSON, bærer slet intet manifest. Begge overflader rammer den samme API, bruger de samme kreditter og skriver til det samme bibliotek, så du kan blande dem.
Kan CLI'en udgive til Facebook eller styre Meta-annoncer?
Udgivelse, planlægning og kampagnestyring 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-overfladen og ikke i CLI-underkommandoerne. Den er tilgængelig fra samme pakke ved at køre hermoso mcp, fra det hostede endpoint på https://app.hermoso.ai/mcp eller fra den webbaserede studio. Udgivelsesmål er Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram og Google Business Profile.
Virker det mod en lokal server?
Ja. Sæt HERMOSO_API_BASE til din egen origin (for eksempel http://localhost:3000), så sigter både CLI'en og MCP-serveren mod den. En localhost-base kræver ingen auth-token.
Relateret
Renders kører som serverjobs, du poller, og et genforsøgt opslag er sikkert, også når udfaldet af første forsøg er ukendt. Detaljerne står under jobs og idempotens.
Vil du i stedet sætte det op inde i Claude Code? Se Claude Code-markedsføring.
Installér CLI'en, log ind fra din browser, og din første konkurrentgennemgang er én kommando væk. Gratis konto, 250+ kreditter du kan optjene, intet kort.
Start gratis → Læs MCP-dokumentationen →