Mag-run ng Ads sa Command Line: Ang Hermoso CLI

Halos lahat ng ad tooling ay dashboard, kaya halos hindi ito ma-automate. Hindi mo mai-cron ang dashboard, hindi mo mai-pipe ang dashboard sa jq, at hindi mo maipapa-click sa terminal agent ang isa. Umiiral ang Hermoso CLI para hindi na maging lugar na binibisita ang ad loop, at para maging bagay na puwede mong i-script.

I-install at mag-sign in:

npm install -g hermoso
hermoso auth login

auth login ay nagbubukas ng loopback listener at ng browser, parehong pattern na ginagamit ng gh at firebase, kaya wala kang kailangang ipaste. Ang nabuong key ay isinusulat sa ~/.hermoso/config.json na may permisyong para lang sa may-ari (directory 0700, file 0600), dahil may tunay itong spend authority. Para sa CI, ang hermoso auth login --token <key> ay nagse-store ng isa nang hindi interactive, at ang HERMOSO_TOKEN / HERMOSO_API_BASE ay nag-o-override ng config mula sa environment.

Ang mga command

Bawat command ay tumatanggap ng --json, at iyon ang buong punto: ang human-readable na linya ay pang-kaginhawahan lang, ang JSON ang kontrata.

Command	Ano ang ginagawa nito
`hermoso capabilities`	Mga valid na model id at ang eksaktong credit cost nila. Patakbuhin ito muna. Libre at read-only ito, at dito ka titigil sa paghula ng pangalan ng model.
`hermoso credits`	Balanse, paggamit ng session, at mga kamakailang priced na tawag.
`hermoso brand --domain example.com`	Binabasa ang website papuntang brand profile (mga produkto, palette, logo, boses) na pinagbabatayan ng mga susunod na render.
`hermoso competitors --domain example.com`	Hinahanap ang direktang kakumpitensya at mga katulad na brand na sulit pag-aralan.
`hermoso ads --company "Brand"`	Kinukuha ang totoong tumatakbong ads ng advertiser na iyon mula sa ad libraries ng Meta, Google at LinkedIn, na na-dedupe at naayos.
`hermoso research "longest-running protein bar ads"`	Ad research sa natural na wika sa mga library, kasama ang organic TikTok, at ibinabalik ang mga ad na nahanap nito.
`hermoso create --brand … --product … --format video`	Ginagawang konsepto ng tapos na ad ang isang brief: mga copy variant kasama ang image concept o video storyboard, kasama ang mga model id para i-render ito.
`hermoso generate image --prompt "…" --ref ./bottle.png`	Nagre-render at nagbabalik ng served URL. Kino-composite ng `--ref` ang totoong produkto mo para ang label sa screen ay ang aktwal mong SKU.
`hermoso jobs` / `hermoso fetch <url>`	Sinusuri ang mga render na tumatakbo pa; nireresolba ang anumang asset sa clickable at direct-download na URL.
`hermoso mcp`	Naghahain ng buong 922+ tool na MCP surface sa stdio, ang parehong tools na inilalantad ng hosted server.

Dalawang surface, isang package, at bakit mahalaga iyon

Nagbabayad ang mga terminal agent para sa tools nang dalawang beses: minsan sa manifest na dala nila sa context, at minsan sa tokens na nagagastos ng bawat tawag. Hindi libre ang 922+ tool manifest. Kaya iisang package ang nagdadala ng dalawang surface, at ang agent ang pumipili:

MCP (hermoso mcp, o ang hosted https://app.hermoso.ai/mcp) kapag gusto mo ang buong surface at mayayamang typed na argumento.
Subprocess commands kapag gusto mo ang path na tipid sa token: nag-shell out ang agent, bumabasa ng JSON, at hindi nagla-load ng manifest kailanman. Ito ang pattern na ginagamit ng mga bundled na Claude skill.

Pareho silang tumatawag sa parehong API, nagbabayad ng parehong credits, at sumusulat sa parehong library, kaya walang naiiwang nakabitin sa isang panig.

Mga bagay na sulit i-script

Lingguhang pagsusuri ng kakumpitensya. hermoso competitors papuntang hermoso ads, ikumpara sa nakaraang linggo, at magkakaroon ka ng tuluy-tuloy na ulat kung ano ang sinimulan at itinigil ng merkado mo.
Batch creative para sa catalogue. Mag-loop sa mga SKU, mag-render ng isang grounded na ad bawat produkto, at kolektahin ang mga ibinalik na URL. Ito ang uri ng trabahong talagang nakakasawa sa UI.
Credit guard sa CI. hermoso credits --json | jq .balance at i-fail ang pipeline bago magsimula ang mahabang batch kapag walang laman ang balanse.
Pagpili ng model ayon sa gastos. Inilalantad ng hermoso capabilities --json ang eksaktong gastos ng bawat model, kaya puwedeng pumili ang script ng pinakamurang model na tumutugon sa brief sa halip na i-hardcode ang isa.

Pag-publish at mga campaign

Sumasaklaw ang mga CLI subcommand sa research at paggawa. Ang publishing, scheduling at pamamahala ng campaign sa Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads at AppLovin Ads ay nasa MCP surface, maaabot mula sa parehong package gamit ang hermoso mcp, mula sa hosted endpoint, o mula sa web studio. Mga target ng publishing ang Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram at Google Business Profile.

Ang hindi nito gagawin nang hindi nagtatanong

Kailangan ng agent na may budget ng malinaw na hangganan para maging kapaki-pakinabang, kaya nakapaloob ang spend authority sa server at hindi sa prompt. Ginagawang PAUSED ang Meta campaigns, ad sets at ads nang walang override mula sa tumatawag. Ang mga status switch na puwedeng magpagana ng totoong ad spend (isa sa bawat ad platform: 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 at set_openai_ads_status, bukod sa iba) ay tumatangging tumakbo nang walang tahasang confirmation flag, at ang parehong gate ay sumasaklaw din sa paggawa ng naka-enable na Google Ads ad group, ad o keyword sa ilalim ng naka-enable nang parent, dahil agad itong maisisilbi sa susunod na auction. Kailangan ding i-confirm ang mga delete. Sa panig ng generation, inilalathala ng hermoso_capabilities ang eksaktong credit cost ng bawat model bago tumakbo ang anuman, at ang bawat render ay nagre-reserve ng tantiyang halaga at pagkatapos ay sinisettle ang tunay na gastos, kaya ang pumalyang dispatch ay ibinabalik sa iyo sa halip na tahimik kang singilin.

Nagtatrabaho sa loob ng agent sa halip na shell? Tingnan ang Claude Code marketing automation at ang buong MCP & CLI reference.

Madalas itanong

May command-line tool ba para mag-run ng ads?

Mayroon. Ini-install ng npm install -g hermoso ang Hermoso CLI, na nagsasaliksik ng ads ng kakumpitensya sa Meta, Google at LinkedIn ad libraries, gumagawa ng brand profile mula sa website, nagpaplano at nagre-render ng tapos na image at video ads, at nag-uulat ng credits at jobs, na may --json output sa bawat command para sa scripting. Naglilingkod din ang parehong package ng buong 922+ tool MCP server sa stdio.

Paano ako mag-a-authenticate sa Hermoso CLI?

Patakbuhin ang hermoso auth login. Nagbubukas ito ng loopback browser sign-in (parehong pattern ng gh at firebase) at iniimbak ang nabuong key sa ~/.hermoso/config.json na para lang sa may-ari (directory 0700, file 0600). Para sa CI, ang hermoso auth login --token <key> ay nagse-store ng isa nang hindi interactive, at ang HERMOSO_TOKEN at HERMOSO_API_BASE ay nag-o-override ng config mula sa environment.

Puwede ko bang i-pipe ang output sa jq?

Oo. Tumatanggap ang bawat command ng --json at naglalabas ng structured na object. Iyon ang sinadyang kontrata; ang human-readable na linya ay pang-kaginhawahan lang. Ang hermoso credits --json | jq .balance ay kapaki-pakinabang na CI guard bago ang mahabang render batch.

Bakit gamitin ang CLI sa halip na MCP server?

Gastos sa token. Naglo-load ang isang MCP client ng tool manifest sa context, at hindi libre ang 922+ tools. Ang terminal agent na nag-shell out sa subprocess commands at bumabasa ng JSON ay walang dinadalang manifest. Pareho silang tumatawag sa parehong API, nagbabayad ng parehong credits, at sumusulat sa parehong library, kaya puwede mo silang paghaluin.

Kaya bang mag-publish ng CLI sa Facebook o mamahala ng Meta ads?

Ang publishing, scheduling at pamamahala ng campaign sa Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads at AppLovin Ads ay nasa MCP surface sa halip na sa mga CLI subcommand, na maaabot mula sa parehong package sa pamamagitan ng pagpapatakbo ng hermoso mcp, mula sa hosted endpoint sa https://app.hermoso.ai/mcp, o mula sa web studio. Mga target ng publishing ang Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram at Google Business Profile.

Gumagana ba ito sa local server?

Oo. Itakda ang HERMOSO_API_BASE sa sarili mong origin (halimbawa http://localhost:3000) at tatama sa iyon ang CLI at ang MCP server. Hindi kailangan ng auth token ang localhost base.

Kaugnay

Tumatakbo ang renders bilang server-side jobs na pino-poll mo, at ligtas i-retry ang post kahit hindi alam ang kinalabasan ng unang subok. Nasa jobs and idempotency ang mga detalye.

Gusto mo bang nasa loob ng agent, hindi sa shell? Tingnan ang Claude Code marketing.

I-install ang CLI, mag-sign in mula sa browser, at isang command na lang ang layo ng una mong pagsusuri ng kakumpitensya. Libreng account, 250+ libreng credits na maaari mong kitain, walang card.

Magsimula nang libre → Basahin ang MCP docs →

Mag-run ng ads mula sa command line