Mainostyökalut ovat lähes kokonaan kojelautoja, ja siksi ne ovat lähes kokonaan automatisoimattomia. Kojelautaa ei voi ajastaa cronilla, sitä ei voi putkittaa jq:lle, eikä terminaaliagenttia voi pyytää klikkaamaan sitä. Hermoso CLI on olemassa, jotta mainossilmukasta tulee asia, jota voi skriptata, eikä paikka, jossa käydään.
Asenna ja kirjaudu sisään:
npm install -g hermoso
hermoso auth loginauth login avaa paikallisen takaisinkutsukuuntelijan ja selaimen, samalla mallilla kuin gh ja firebase, joten mitään ei tarvitse liittää. Syntynyt avain kirjoitetaan tiedostoon ~/.hermoso/config.json vain omistajalle luettavin oikeuksin (hakemisto 0700, tiedosto 0600), koska se kantaa oikeaa kulutusvaltuutta. CI-ympäristöön hermoso auth login --token <key> tallentaa avaimen ilman vuorovaikutusta, ja HERMOSO_TOKEN ja HERMOSO_API_BASE ohittavat asetukset ympäristömuuttujista.
Komennot
Jokainen komento hyväksyy --json-lipun, ja juuri se on koko idea: ihmisille luettava rivi on mukavuus, JSON on sopimus.
| Komento | Mitä se tekee |
|---|---|
hermoso capabilities | Kelvolliset mallitunnukset ja niiden tarkat krediittihinnat. Aja tämä ensin. Se on ilmainen ja vain luku, ja sillä lopetat mallinimien arvailun. |
hermoso credits | Saldo, istunnon käyttö ja viimeisimmät hintalliset kutsut. |
hermoso brand --domain example.com | Lukee verkkosivun brändiprofiiliksi (tuotteet, väripaletti, logo, ääni), jolla myöhemmät renderöinnit perustetaan. |
hermoso competitors --domain example.com | Löytää suorat kilpailijat ja samankaltaiset brändit, joista kannattaa oppia. |
hermoso ads --company "Brand" | Hakee tuon mainostajan todelliset käynnissä olevat mainokset Metan, Googlen ja LinkedInin mainoskirjastoista, poistettuna kaksoiskappaleista ja lajiteltuna. |
hermoso research "longest-running protein bar ads" | Luonnollisen kielen mainostutkimus kirjastoista sekä orgaanisesta TikTokista, palauttaen löydetyt mainokset. |
hermoso create --brand … --product … --format video | Muuttaa tiivistelmän valmiiksi mainoskonseptiksi: tekstivariantit sekä kuvakonsepti tai videokäsikirjoitus, mallitunnuksineen renderöintiä varten. |
hermoso generate image --prompt "…" --ref ./bottle.png | Renderöi ja palauttaa palvellun URL-osoitteen. --ref lisää oikean tuotteesi kuvaan, joten näytöllä oleva etiketti on todellinen SKU sinulle. |
hermoso jobs / hermoso fetch <url> | Tarkista kesken olevat renderöinnit; ratkaise mikä tahansa resurssi klikattavaksi ja suoraan ladattavaksi URL-osoitteeksi. |
hermoso mcp | Palvelee täyden 922+ työkalun MCP-pinnan stdio-yhteydellä, samat työkalut kuin isännöity palvelin. |
Kaksi pintaa, yksi paketti, ja miksi sillä on väliä
Terminaaliagentit maksavat työkaluista kahdesti: kerran manifestissa, jonka ne kantavat kontekstissaan, ja kerran jokaisen kutsun tokeneissa. 922+ työkalun manifesti ei ole ilmainen. Siksi sama paketti toimittaa molemmat pinnat ja antaa agentin valita:
- MCP (
hermoso mcptai isännöityhttps://app.hermoso.ai/mcp), kun haluat koko pinnan ja rikkaat tyypitetyt argumentit. - Aliprosessikomennot, kun haluat edullisen tokenipolun: agentti kutsuu komentoa, lukee JSONin eikä lataa manifestia lainkaan. Juuri tätä mallia käyttävät mukana tulevat Claude-taidot.
Molemmat kutsuvat samaa API:a, veloittavat samat krediitit ja kirjoittavat samaan kirjastoon, joten mikään ei jää roikkumaan toisen puolen varaan.
Asioita, jotka kannattaa skriptata
- Viikoittainen kilpailijakatsaus.
hermoso competitorssyötetään komentoonhermoso ads, verrataan viime viikkoon, ja sinulla on jatkuva raportti siitä, mitä markkinasi aloitti ja lopetti ajamasta. - Erätuotanto luovista mainoksista katalogille. Käy läpi SKU:t, renderöi yksi perusteltu mainos per tuote ja kerää palautetut URL-osoitteet. Tämä on sellainen työ, joka on käyttöliittymässä todella tylsää.
- Krediittivahti CI:ssä.
hermoso credits --json | jq .balance, ja keskeytä putki ennen pitkää erää, jos saldo on tyhjä. - Kustannustietoinen mallivalinta.
hermoso capabilities --jsonantaa mallikohtaiset tarkat hinnat, joten skripti voi valita halvimman mallin, joka täyttää briiffin, eikä kovakoodata yhtä mallia.
Julkaisu ja kampanjat
CLI-alikomennot kattavat tutkimuksen ja luomisen. Julkaisu, ajastus ja kampanjoiden hallinta Metassa, Google Adsissa, Microsoft Advertisingissa, Reddit Adsissa, LinkedInissä, Pinterestissä, X Adsissa, TikTok Adsissa, Snapchat Adsissa, ChatGPT Adsissa, Apple Search Adsissa ja AppLovin Adsissa asuvat MCP-pinnalla. Sen saa samasta paketista komennolla hermoso mcp, isännöidystä päätepisteestä tai verkkostudiosta. Julkaisun kohteina ovat Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram ja Google Business Profile.
Mitä se ei tee ilman lupaasi
Agentilla, jolla on budjetti, on hyötyä vain, jos sen vaikutusala on rajattu. Siksi mainosbudjetin käyttöoikeus on lukittu palvelimeen eikä kehotteeseen. Metan kampanjat, mainosryhmät ja mainokset luodaan aina PAUSED-tilassa, eikä kutsuja voi ohittaa sitä. Tilanvaihdot, jotka voivat käynnistää oikeaa mainosbudjettia (yksi jokaiselle mainosalustalle: 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 ja set_openai_ads_status), eivät suostu toimimaan ilman nimenomaista vahvistuslippua. Sama vahvistus koskee myös aktiivisen Google Ads -mainosryhmän, mainoksen tai avainsanan luomista jo aktiivisen vanhemman alle, koska se näkyy seuraavassa huutokaupassa. Myös poistot vaativat vahvistuksen. Renderöintien puolella hermoso_capabilities kertoo jokaisen mallin tarkan krediittihinnan ennen kuin mitään ajetaan, ja jokainen renderöinti varaa arvion ja maksaa lopulta todellisen hinnan. Epäonnistunut käynnistys hyvitetään, eikä se veloita sinua turhaan.
Töitä agentin sisällä eikä kuoressa? Katso Claude Coden markkinointiautomaatio ja koko MCP- ja CLI-viite.
Usein kysytyt kysymykset
Onko olemassa komentorivityökalua mainosten ajamiseen?
On. npm install -g hermoso asentaa Hermoso CLI:n, joka tutkii kilpailijoiden mainoksia Metan, Googlen ja LinkedInin mainoskirjastoista, laatii brändiprofiilin verkkosivusta, suunnittelee ja renderöi valmiita kuva- ja videomainoksia ja raportoi krediitit sekä työt, ja jokaisessa komennossa on --json-tuloste skriptausta varten. Sama paketti palvelee myös täyden 922+ työkalun MCP-palvelimen stdio-yhteydellä.
Miten todennan Hermoso CLI:n?
Aja hermoso auth login. Se avaa selaimen kirjautumisen paikallisen takaisinkutsun kautta (sama malli kuin gh ja firebase) ja tallentaa syntyvän avaimen tiedostoon ~/.hermoso/config.json vain omistajalle luettavin oikeuksin (hakemisto 0700, tiedosto 0600). CI-ympäristöön hermoso auth login --token <key> tallentaa avaimen ilman vuorovaikutusta, ja HERMOSO_TOKEN ja HERMOSO_API_BASE ohittavat asetukset ympäristömuuttujista.
Voinko putkittaa tulosteen jq:lle?
Kyllä. Jokainen komento hyväksyy --json-lipun ja tulostaa jäsennellyn olion. Se on tarkoitettu sopimus; ihmisille luettava rivi on vain mukavuus. hermoso credits --json | jq .balance on hyödyllinen CI-vahti ennen pitkää renderöintierää.
Miksi käyttää CLI:tä MCP-palvelimen sijaan?
Tokenikustannus. MCP-asiakas lataa työkalumanifestin kontekstiin, ja yli 922 työkalua eivät ole ilmaisia. Terminaaliagentti, joka kutsuu aliprosessikomentoja ja lukee JSONia, ei kanna mukanaan lainkaan manifestia. Molemmat pinnat kutsuvat samaa API:a, veloittavat samat krediitit ja kirjoittavat samaan kirjastoon, joten voit yhdistellä niitä.
Voiko CLI julkaista Facebookiin tai hallita Meta-mainoksia?
Julkaisu, ajastus ja kampanjoiden hallinta Metassa, Google Adsissa, Microsoft Advertisingissa, Reddit Adsissa, LinkedInissä, Pinterestissä, X Adsissa, TikTok Adsissa, Snapchat Adsissa, ChatGPT Adsissa, Apple Search Adsissa ja AppLovin Adsissa asuvat MCP-pinnalla eivätkä CLI-alikomennoissa. Sen saa samasta paketista ajamalla hermoso mcp, isännöidystä päätepisteestä osoitteessa https://app.hermoso.ai/mcp tai verkkostudiosta. Julkaisun kohteina ovat Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram ja Google Business Profile.
Toimiiko se paikallista palvelinta vastaan?
Toimii. Aseta HERMOSO_API_BASE omaan originiisi (esimerkiksi http://localhost:3000), ja sekä CLI että MCP-palvelin kohdistuvat siihen. Paikallinen osoite ei tarvitse todennustunnusta.
Liittyvää
Renderöinnit ajetaan palvelimella työnä, jota kysyt, ja uudelleen yritetty julkaisu on turvallinen, vaikka ensimmäisen yrityksen tulos ei olisi tiedossa. Yksityiskohdat ovat sivulla työt ja idempotenssi.
Haluatko asentaa sen Claude Coden sisälle? Katso Claude Code -markkinointi.
Asenna CLI, kirjaudu selaimesta, ja ensimmäinen kilpailijakatsauksesi on yhden komennon päässä. Ilmainen tili, 250+ ansaittavaa ilmaiskrediittiä, ei korttia.
Aloita ilmaiseksi → Lue MCP-dokumentaatio →