Rulează reclame din linia de comandă: CLI-ul Hermoso

Instrumentele de reclame sunt aproape în întregime tablouri de bord, ceea ce le face aproape imposibil de automatizat. Nu poți pune un tablou de bord în cron, nu poți trimite un tablou de bord în jq și nu poți cere unui agent de terminal să dea click pe unul. CLI-ul Hermoso există ca bucla cu reclame să nu mai fie un loc în care treci, ci un lucru pe care îl poți scripta.

Instalare și autentificare:

npm install -g hermoso
hermoso auth login

auth login pornește un listener loopback și deschide browserul, același model pe care îl folosesc gh și firebase, deci nu trebuie lipit nimic. Cheia emisă este scrisă în ~/.hermoso/config.json cu permisiuni doar pentru proprietar (directorul 0700, fișierul 0600), pentru că are autoritate reală de cheltuire. Pentru CI, hermoso auth login --token <key> stochează una non-interactiv, iar HERMOSO_TOKEN / HERMOSO_API_BASE suprascriu configul din mediu.

Comenzile

Fiecare comandă acceptă --json, și asta este tot rostul: linia citită de om este o comoditate, JSON-ul este contractul.

Comandă	Ce face
`hermoso capabilities`	Id-urile valide ale modelelor și costurile lor exacte în credite. Rulează-o prima. Este gratuită și doar pentru citire, iar așa încetezi să ghicești numele modelelor.
`hermoso credits`	Soldul, consumul din sesiune și apelurile recente cu preț.
`hermoso brand --domain example.com`	Citește un site web într-un profil de brand (produse, paletă, logo, voce) pe care se bazează randările ulterioare.
`hermoso competitors --domain example.com`	Descoperă rivalii direcți și brandurile similare din care merită să înveți.
`hermoso ads --company "Brand"`	Trage reclamele reale ale anunțătorului din bibliotecile Meta, Google și LinkedIn, deduplicate și sortate.
`hermoso research "longest-running protein bar ads"`	Cercetare de reclame în limbaj natural prin bibliotecile de reclame plus TikTok organic, întorcând reclamele pe care le-a găsit.
`hermoso create --brand … --product … --format video`	Transformă un brief într-un concept de reclamă finalizat: variante de text plus un concept de imagine sau un storyboard video, cu id-urile modelelor pentru a-l randa.
`hermoso generate image --prompt "…" --ref ./bottle.png`	Randează și întoarce un URL servit. `--ref` compune produsul tău real, astfel încât eticheta de pe ecran este SKU-ul tău real.
`hermoso jobs` / `hermoso fetch <url>`	Inspectează randările în curs; rezolvă orice activ într-un URL pe care se poate da click și într-un URL de descărcare directă.
`hermoso mcp`	Servește suprafața MCP completă, cu 922+ unelte, prin stdio: aceleași unelte pe care le expune serverul găzduit.

Două suprafețe, un pachet, și de ce contează

Agenții de terminal plătesc uneltele de două ori: o dată în manifestul pe care îl poartă în context și o dată în tokenii pe care îi costă fiecare apel. Un manifest de 922+ unelte nu este gratuit. Așa că același pachet livrează ambele suprafețe și îl lasă pe agent să aleagă:

MCP (hermoso mcp, sau endpointul găzduit https://app.hermoso.ai/mcp) când vrei suprafața completă și argumente tipizate bogate.
Comenzi de subproces când vrei calea ieftină în tokeni: agentul apelează prin shell, citește JSON și nu încarcă niciodată un manifest. Acesta este modelul pe care îl folosesc skill-urile Claude incluse.

Ambele lovesc aceeași API, consumă aceleași credite și scriu în aceeași bibliotecă, deci nimic nu rămâne blocat pe o parte.

Lucruri care merită scriptate

O sondare săptămânală a concurenței. hermoso competitors în hermoso ads, compari cu săptămâna trecută și ai un raport permanent despre ce au început și ce au încetat să ruleze concurenții din piața ta.
Creație în lot pentru un catalog. Parcurge SKU-urile, randează o reclamă ancorată pentru fiecare produs și colectează URL-urile întoarse. Este genul de job care e cu adevărat plictisitor într-o interfață.
O gardă de credite în CI. hermoso credits --json | jq .balance și oprești pipeline-ul înainte să înceapă un lot lung pe un sold gol.
Selecție de model conștientă de cost. hermoso capabilities --json expune costurile exacte pe model, deci un script poate alege cel mai ieftin model care respectă brief-ul, în loc să fixeze unul.

Publicare și campanii

Subcomenzile CLI acoperă cercetarea și crearea. Publicarea, programarea și gestionarea campaniilor pe Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads și AppLovin Ads trăiesc în suprafața MCP, accesibilă din același pachet cu hermoso mcp, de la endpointul găzduit sau din studioul web. Țintele de publicare sunt Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram și Google Business Profile.

Ce nu face fără să întrebe

Un agent cu buget este util doar dacă raza de acțiune este mărginită, deci autoritatea de a cheltui este fixată în server, nu într-un prompt. Campaniile, grupurile de anunțuri și reclamele Meta sunt create PAUSED, fără ca apelantul să le poată suprascrie. Comutatoarele de stare care pot activa cheltuieli reale (câte unul pe fiecare platformă de reclame: 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 și set_openai_ads_status, printre altele) refuză toate să ruleze fără un indicator explicit de confirmare, iar aceeași poartă acoperă și crearea unui grup de anunțuri Google Ads, a unei reclame sau a unui cuvânt cheie activ sub un părinte deja activ, pentru că acestea se difuzează la următoarea licitație. Ștergerile cer și ele confirmare. Pe partea de generare, hermoso_capabilities publică costul exact în credite al fiecărui model înainte de orice rulare, iar fiecare randare rezervă o estimare, apoi decontează costul real, astfel încât o trimitere eșuată se rambursează în loc să te taxeze în tăcere.

Lucrezi într-un agent, nu într-un shell? Vezi automatizarea marketingului în Claude Code și referința completă MCP & CLI.

Întrebări frecvente

Există un instrument din linia de comandă pentru rularea reclamelor?

Da. npm install -g hermoso instalează CLI-ul Hermoso, care cercetează reclamele concurenților în bibliotecile Meta, Google și LinkedIn, creează un profil de brand dintr-un site web, planifică și randează reclame finalizate, imagine și video, și raportează credite și joburi, cu ieșire --json la fiecare comandă pentru scripting. Același pachet servește și serverul MCP complet, cu peste 922+ unelte, prin stdio.

Cum mă autentific în CLI-ul Hermoso?

Rulează hermoso auth login. Deschide o autentificare în browser prin loopback (același model ca gh și firebase) și stochează cheia emisă în ~/.hermoso/config.json cu permisiuni doar pentru proprietar (directorul 0700, fișierul 0600). Pentru CI, hermoso auth login --token <key> stochează una non-interactiv, iar HERMOSO_TOKEN și HERMOSO_API_BASE suprascriu configul din mediu.

Pot trimite ieșirea în jq?

Da. Fiecare comandă acceptă --json și afișează un obiect structurat. Acesta este contractul; linia citită de om este doar o comoditate. hermoso credits --json | jq .balance este o gardă utilă în CI înainte de un lot lung de randări.

De ce să folosesc CLI-ul în loc de serverul MCP?

Costul în tokeni. Un client MCP încarcă manifestul de unelte în context, iar peste 922+ unelte nu sunt gratuite. Un agent de terminal care apelează prin shell comenzi de subproces și citește JSON nu poartă niciun manifest. Ambele suprafețe lovesc aceeași API, consumă aceleași credite și scriu în aceeași bibliotecă, deci le poți amesteca.

Poate CLI-ul să posteze pe Facebook sau să gestioneze reclamele Meta?

Publicarea, programarea și gestionarea campaniilor pe Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads și AppLovin Ads trăiesc în suprafața MCP, nu în subcomenzile CLI. Sunt accesibile din același pachet, rulând hermoso mcp, de la endpointul găzduit la https://app.hermoso.ai/mcp sau din studioul web. Țintele de publicare sunt Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram și Google Business Profile.

Funcționează pe un server local?

Da. Setează HERMOSO_API_BASE la propria origine (de exemplu http://localhost:3000) și atât CLI-ul, cât și serverul MCP o vizează. O bază localhost nu are nevoie de token de autentificare.

Legate de subiect

Randările rulează ca joburi pe server, pe care le sondezi, iar o postare reîncercată este sigură chiar și atunci când rezultatul primei încercări este necunoscut. Detaliile sunt în joburi și idempotență.

Preferi să lucrezi în terminal? Vezi Claude Code marketing.

Instalează CLI-ul, autentifică-te din browser, iar prima ta sondare a concurenței este la o comandă distanță. Cont gratuit, cu peste 250 de credite gratuite câștigabile, fără card.

Începe gratuit → Citește documentația MCP →