A hirdetéseszközök szinte teljesen irányítópultokból állnak, ezért szinte teljesen nem automatizálhatók. Irányítópultot nem ütemezhetsz cronnal, nem vezethetsz jq-ba, és nem kérheted meg egy terminálos ügynököt, hogy kattintson rajta. A Hermoso CLI azért van, hogy a hirdetési munka ne egy hely legyen, ahová látogatsz, hanem valami, amit szkriptelhetsz.
Telepítés és bejelentkezés:
npm install -g hermoso
hermoso auth loginAz auth login helyi visszacsatolási figyelőt indít, és megnyitja a böngészőt, ugyanazzal a mintával, amit a gh és a firebase használ, így nincs mit bemásolnod. A kiadott kulcs a ~/.hermoso/config.json fájlba kerül, csak tulajdonosi jogosultsággal (könyvtár 0700, fájl 0600), mert valódi költési jogosultságot hordoz. CI-hez a hermoso auth login --token <key> nem interaktívan tárol egyet, a HERMOSO_TOKEN és a HERMOSO_API_BASE pedig környezeti változókból felülírja a konfigurációt.
A parancsok
Minden parancs elfogadja a --json kapcsolót, ez a lényeg: az emberi olvasható sor kényelmi funkció, a JSON a szerződés.
| Parancs | Mit tesz |
|---|---|
hermoso capabilities | Érvényes modellazonosítók és azok pontos kreditköltségei. Ezt futtasd először. Ingyenes és csak olvasható, és így nem kell modellneveket találgatnod. |
hermoso credits | Egyenleg, a munkamenet használata és a legutóbbi díjköteles hívások. |
hermoso brand --domain example.com | Egy weboldalt márkaprofillá olvas (termékek, paletta, logó, hang), amelyre a későbbi renderelések épülnek. |
hermoso competitors --domain example.com | Felderíti a közvetlen versenytársakat és a hasonló márkákat, amelyektől érdemes tanulni. |
hermoso ads --company "Brand" | Lekéri annak a hirdetőnek a valódi futó hirdetéseit a Meta, a Google és a LinkedIn hirdetési könyvtáraiból, deduplikálva és rendezve. |
hermoso research "longest-running protein bar ads" | Természetes nyelvű hirdetéskutatás a könyvtárakban, plusz az organikus TikTok, és visszaadja a talált hirdetéseket. |
hermoso create --brand … --product … --format video | Egy briefet kész hirdetési koncepcióvá alakít: szövegváltozatok, plusz egy képkoncepció vagy egy videó-storyboard, a renderelésükhöz szükséges modellazonosítókkal. |
hermoso generate image --prompt "…" --ref ./bottle.png | Renderel, és kiszolgált URL-t ad vissza. A --ref a valódi termékedet komponálja be, így a képen látható címke a valódi SKU-d lesz. |
hermoso jobs / hermoso fetch <url> | A folyamatban lévő renderelések megnézése; bármely eszközt feloldja kattintható és közvetlen letöltési URL-re. |
hermoso mcp | Kiszolgálja a teljes, 922+ eszközös MCP-felületet stdio-n, ugyanazokat az eszközöket, mint a hosztolt szerver. |
Két felület, egy csomag, és miért számít ez
A terminálos ügynökök kétszer fizetnek az eszközökért: egyszer a kontextusban hordozott manifesztben, és egyszer az egyes hívások tokenjeiben. Egy 922+ eszközös manifeszt nem ingyen van. Ezért ugyanaz a csomag mindkét felületet tartalmazza, és az ügynök dönt:
- MCP (
hermoso mcp, vagy a hosztolthttps://app.hermoso.ai/mcp), ha a teljes felületre és a gazdag, típusos argumentumokra van szükséged. - Alfolyamat-parancsok, ha a tokentakarékos utat szeretnéd: az ügynök parancsot futtat, JSON-t olvas, és egyáltalán nem tölt be manifesztet. Ezt a mintát használják a csomagolt Claude-skillek is.
Mindkettő ugyanazt az API-t éri el, ugyanazokat a krediteket számlázza, és ugyanabba a könyvtárba ír, így egyik oldalon sem ragad semmi.
Érdemes szkriptelni
- Heti versenytárs-átnézés. A
hermoso competitorseredménye ahermoso ads-be megy, összevetjük az előző héttel, és kész állandó riportod van arról, mit kezdett el és mit hagyott abba a piacod. - Kötegelt kreatív egy katalógushoz. Fuss végig a cikkszámokon, renderelj termékenként egy, a termékre szabott hirdetést, és gyűjtsd össze a visszaadott URL-eket. Egy felületen ez valóban macerás munka lenne.
- Költségkapu CI-ben.
hermoso credits --json | jq .balance, és állítsd le a pipeline-t, mielőtt egy hosszú köteg üres egyenleggel indulna. - Költségtudatos modellválasztás. A
hermoso capabilities --jsonminden modell pontos költségét kiteszi, így egy szkript a briefnek megfelelő legolcsóbb modellt választhatja, nem egyet kódol be fixen.
Közzététel és kampányok
Az alparancsok a kutatást és a létrehozást fedik le. A közzététel, az ütemezés és a kampánykezelés a Meta, a Google Ads, a Microsoft Advertising, a Reddit Ads, a LinkedIn, a Pinterest, az X Ads, a TikTok Ads, a Snapchat Ads, a ChatGPT Ads, az Apple Search Ads és az AppLovin Ads platformokon az MCP-felületen él, amelyet ugyanabból a csomagból érhetsz el a hermoso mcp futtatásával, a hosztolt végpontról, vagy a webes stúdióból. A közzétételi célok: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram és Google Business Profile.
Amit engedély nélkül nem tesz meg
Egy költségkerettel rendelkező ügynök csak akkor hasznos, ha a kockázata korlátos, ezért a költési jogosultságot a szerver zárja, nem egy utasítás. A Meta-kampányok, hirdetéskészletek és hirdetések PAUSED állapotban jönnek létre, és a hívó ezt nem írhatja felül. A kapcsolók, amelyekkel valódi hirdetési költés indulhat (minden hirdetési platformon egy: 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 és set_openai_ads_status, többek között), mind megtagadják a futtatást kifejezett megerősítő jelzés nélkül. Ugyanez a kapu vonatkozik egy engedélyezett Google Ads-hirdetéscsoport, hirdetés vagy kulcsszó létrehozására már engedélyezett szülő alatt, mert az a következő aukciótól azonnal megjelenik. A törlések is megerősítéshez kötöttek. A generálás oldalán a hermoso_capabilities minden modell pontos kreditköltségét közzéteszi, mielőtt bármi futna, és minden renderelés először becsült összeget foglal le, majd a valódi költséggel számol el, így egy meghiúsult indítás visszatérít, nem csendben számláz.
Ha egy ügynökben dolgozol, nem pedig shellben, nézd meg a Claude Code marketinget és a teljes MCP & CLI referenciát.
Gyakori kérdések
Van parancssori eszköz hirdetések futtatásához?
Igen. Az npm install -g hermoso telepíti a Hermoso CLI-t, amely versenytárs-hirdetéseket kutat a Meta, a Google és a LinkedIn hirdetési könyvtáraiban, márkaprofilt készít egy weboldalból, kész képi és videós hirdetéseket tervez és renderel, valamint a krediteket és a feladatokat jelenti. Minden parancs elfogadja a --json kapcsolót a szkriptelés kedvéért. Ugyanez a csomag a teljes, 922+ eszközös MCP-szervert is kiszolgálja stdio-n.
Hogyan hitelesítem a Hermoso CLI-t?
Futtasd a hermoso auth login parancsot. Böngészős bejelentkezést nyit helyi visszacsatoláson keresztül (ugyanaz a minta, mint a gh és a firebase esetében), és a kiadott kulcsot a ~/.hermoso/config.json fájlba menti csak tulajdonosi jogosultsággal (könyvtár 0700, fájl 0600). CI-hez a hermoso auth login --token <key> nem interaktívan tárol egyet, a HERMOSO_TOKEN és a HERMOSO_API_BASE pedig környezeti változókból felülírja a konfigurációt.
Bevezethetem a kimenetet jq-ba?
Igen. Minden parancs elfogadja a --json kapcsolót, és strukturált objektumot ír ki. Ez a tervezett szerződés; az emberi olvasható sor csak kényelmi funkció. A hermoso credits --json | jq .balance hasznos CI-kapu egy hosszú renderelési köteg előtt.
Miért a CLI, és miért nem az MCP-szerver?
Tokenköltség. Egy MCP-kliens betölti az eszközmanifesztet a kontextusba, és 922+ eszköz nem ingyen van. Egy terminálos ügynök, amely alfolyamat-parancsokat futtat és JSON-t olvas, egyáltalán nem visz magával manifesztet. Mindkét felület ugyanazt az API-t éri el, ugyanazokat a krediteket számlázza és ugyanabba a könyvtárba ír, így kombinálhatod őket.
Tud a CLI Facebookra publikálni, vagy Meta-hirdetéseket kezelni?
A Meta, a Google Ads, a Microsoft Advertising, a Reddit Ads, a LinkedIn, a Pinterest, az X Ads, a TikTok Ads, a Snapchat Ads, a ChatGPT Ads, az Apple Search Ads és az AppLovin Ads közzététele, ütemezése és kampánykezelése az MCP-felületen él, nem a CLI alparancsaiban. Ugyanabból a csomagból érhető el a hermoso mcp futtatásával, a hosztolt végpontról (https://app.hermoso.ai/mcp), vagy a webes stúdióból. A közzétételi célok: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram és Google Business Profile.
Működik helyi szerverrel?
Igen. Állítsd a HERMOSO_API_BASE értékét a saját origin-odra (például http://localhost:3000), és a CLI és az MCP-szerver is oda céloz. Helyi alapcímhez nincs szükség hitelesítési tokenre.
Kapcsolódó
A renderelések szerveroldali feladatként futnak, amelyeket lekérdezel, és egy újrapróbált poszt biztonságos akkor is, ha az első kísérlet kimenetele nem ismert. A részleteket a feladatok és idempotencia oldalon találod.
Ha egy ügynökön belül dolgozol, nem a Hermoso CLI-n keresztül, nézd meg a Claude Code marketinget.
Telepítsd a CLI-t, jelentkezz be a böngészőből, és az első versenytárs-átnézésed egy parancsnyira van. Ingyenes fiók, 250+ megszerezhető ingyenes kredit, bankkártya nélkül.
Kezdd el ingyen → Olvasd el az MCP-dokumentációt →