Jalankan Iklan dari Baris Arahan: CLI Hermoso

Alat iklan hampir keseluruhannya papan pemuka, yang menjadikannya hampir mustahil untuk diautomasikan. Anda tidak boleh menjadualkan papan pemuka dengan cron, anda tidak boleh menyalurkan papan pemuka ke jq, dan anda tidak boleh meminta ejen terminal mengkliknya. CLI Hermoso wujud supaya gelung iklan berhenti menjadi tempat yang anda lawati dan mula menjadi sesuatu yang boleh anda skrip.

Pasang dan log masuk:

npm install -g hermoso
hermoso auth login

auth login memulakan pendengar gelung balik dan membuka pelayar, corak yang sama digunakan oleh gh dan firebase, jadi tiada apa untuk ditampal. Kunci yang dicipta ditulis ke ~/.hermoso/config.json dengan kebenaran hak milik sahaja (direktori 0700, fail 0600), kerana ia membawa kuasa perbelanjaan sebenar. Untuk CI, hermoso auth login --token <key> menyimpannya tanpa interaksi, dan HERMOSO_TOKEN / HERMOSO_API_BASE mengatasi konfigurasi daripada persekitaran.

Arahan

Setiap arahan menerima --json, dan itulah intipatinya: baris yang boleh dibaca manusia ialah kemudahan, JSON ialah kontraknya.

Arahan	Apa yang dilakukannya
`hermoso capabilities`	ID model yang sah dan kos kredit tepat. Jalankan ini dahulu. Ia percuma dan baca sahaja, dan inilah cara anda berhenti meneka nama model.
`hermoso credits`	Baki, penggunaan sesi dan panggilan berbayar terkini.
`hermoso brand --domain example.com`	Membaca laman web menjadi profil jenama (produk, palet, logo, suara) yang render kemudian berdasarkan.
`hermoso competitors --domain example.com`	Mencari pesaing langsung dan jenama serupa yang berbaloi untuk dipelajari.
`hermoso ads --company "Brand"`	Menarik iklan sebenar pengiklan itu yang sedang berjalan daripada perpustakaan iklan Meta, Google dan LinkedIn, dinyahduplikasi dan disusun.
`hermoso research "longest-running protein bar ads"`	Kajian iklan dalam bahasa semula jadi merentas perpustakaan serta TikTok organik, memulangkan iklan yang dijumpainya.
`hermoso create --brand … --product … --format video`	Menukar taklimat kepada konsep iklan siap: varian salinan serta konsep imej atau storyboard video, dengan ID model untuk merendernya.
`hermoso generate image --prompt "…" --ref ./bottle.png`	Merender dan memulangkan URL yang disajikan. `--ref` menggabungkan produk sebenar anda supaya label yang kelihatan di skrin ialah SKU sebenar anda.
`hermoso jobs` / `hermoso fetch <url>`	Periksa render yang sedang berjalan; selesaikan mana-mana aset kepada URL yang boleh diklik dan URL muat turun terus.
`hermoso mcp`	Menyajikan permukaan MCP 922+ alat yang penuh melalui stdio, alat yang sama yang didedahkan oleh pelayan hos.

Dua permukaan, satu pakej, dan mengapa itu penting

Ejen terminal membayar untuk alat dua kali: sekali dalam manifes yang dibawanya dalam konteks, dan sekali dalam token yang dibelanjakan oleh setiap panggilan. Manifes 922+ alat bukan percuma. Jadi pakej yang sama menghantar kedua-dua permukaan dan membiarkan ejen memilih:

MCP (hermoso mcp, atau hos https://app.hermoso.ai/mcp) apabila anda mahu permukaan penuh dan argumen bertaip yang kaya.
Arahan subproses apabila anda mahu laluan yang murah dari segi token: ejen memanggil shell, membaca JSON, dan tidak memuatkan manifes langsung. Inilah corak yang digunakan oleh skill Claude yang disertakan.

Kedua-duanya memanggil API yang sama, membelanjakan kredit yang sama dan menulis ke perpustakaan yang sama, jadi tiada apa yang tersekat di satu sisi.

Perkara yang berbaloi untuk diskrip

Sapuan pesaing mingguan. hermoso competitors dialirkan ke hermoso ads, dibandingkan dengan minggu lepas, dan anda mempunyai laporan tetap tentang apa yang pasaran anda mula dan henti jalankan.
Kreatif berkelompok untuk katalog. Gelung merentas SKU, render satu iklan berasaskan produk bagi setiap produk, dan kumpulkan URL yang dikembalikan. Inilah jenis kerja yang sangat membosankan dalam UI.
Penjaga kredit dalam CI. hermoso credits --json | jq .balance dan gagalkan saluran paip sebelum kumpulan panjang bermula dengan baki kosong.
Pemilihan model yang sedar kos. hermoso capabilities --json mendedahkan kos tepat setiap model, jadi skrip boleh memilih model termurah yang memenuhi taklimat dan bukannya mengunci satu model dalam kod.

Penerbitan dan kempen

Subarahan CLI meliputi kajian dan penciptaan. Penerbitan, penjadualan dan pengurusan kempen di Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads dan AppLovin Ads berada dalam permukaan MCP, boleh dicapai dari pakej yang sama dengan hermoso mcp, dari titik akhir hos, atau dari studio web. Sasaran penerbitan ialah Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram dan Google Business Profile.

Apa yang ia tidak akan buat tanpa bertanya

Ejen dengan bajet hanya berguna jika skop tindakannya terhad, jadi kuasa perbelanjaan dikuatkuasakan dalam pelayan dan bukan dalam arahan. Kempen Meta, set iklan dan iklan dicipta dengan PAUSED tanpa sebarang penggantian daripada pemanggil. Suis status yang boleh mengaktifkan belanja iklan sebenar (satu pada setiap platform iklan: 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 dan set_openai_ads_status antara lain) semuanya enggan dijalankan tanpa bendera pengesahan yang jelas, dan peraturan pengesahan yang sama meliputi mencipta kumpulan iklan Google Ads, iklan atau kata kunci yang diaktifkan di bawah induk yang sudah diaktifkan, kerana ia akan disajikan pada lelongan seterusnya. Pemadaman juga memerlukan pengesahan. Di bahagian penjanaan, hermoso_capabilities menerbitkan kos kredit tepat setiap model sebelum apa-apa dijalankan, dan setiap render menempah anggaran dahulu kemudian menyelesaikan kos sebenar, jadi penghantaran yang gagal dikembalikan dan bukannya diam-diam dicaj.

Bekerja di dalam ejen dan bukan shell? Lihat pemasaran Claude Code dan rujukan penuh MCP & CLI.

Soalan lazim

Adakah terdapat alat baris arahan untuk menjalankan iklan?

Ada. npm install -g hermoso memasang CLI Hermoso, yang mengkaji iklan pesaing merentas perpustakaan iklan Meta, Google dan LinkedIn, merangka profil jenama daripada laman web, merancang dan merender iklan imej dan video siap, serta melaporkan kredit dan tugas, dengan output --json pada setiap arahan untuk skrip. Pakej yang sama juga menyajikan pelayan MCP 922+ alat melalui stdio.

Bagaimana saya mengesahkan CLI Hermoso?

Jalankan hermoso auth login. Ia membuka log masuk pelayar gelung balik (corak yang sama digunakan oleh gh dan firebase) dan menyimpan kunci yang dicipta di ~/.hermoso/config.json dengan kebenaran hak milik sahaja (direktori 0700, fail 0600). Untuk CI, hermoso auth login --token <key> menyimpannya tanpa interaksi, dan HERMOSO_TOKEN serta HERMOSO_API_BASE mengatasi konfigurasi daripada persekitaran.

Bolehkah saya salurkan output ke jq?

Boleh. Setiap arahan menerima --json dan mencetak objek berstruktur. Itulah kontrak yang dimaksudkan; baris yang boleh dibaca manusia hanyalah kemudahan. hermoso credits --json | jq .balance ialah penjaga CI yang berguna sebelum kumpulan render yang panjang.

Mengapa guna CLI dan bukan pelayan MCP?

Kos token. Klien MCP memuatkan manifes alat ke dalam konteks, dan 922+ alat bukan percuma. Ejen terminal yang memanggil arahan subproses dan membaca JSON tidak membawa manifes langsung. Kedua-dua permukaan memanggil API yang sama, membelanjakan kredit yang sama dan menulis ke perpustakaan yang sama, jadi anda boleh mencampurkannya.

Bolehkah CLI menerbitkan ke Facebook atau mengurus iklan Meta?

Penerbitan, penjadualan dan pengurusan kempen di Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads dan AppLovin Ads berada dalam permukaan MCP dan bukan subarahan CLI, boleh dicapai dari pakej yang sama dengan menjalankan hermoso mcp, dari titik akhir hos di https://app.hermoso.ai/mcp, atau dari studio web. Sasaran penerbitan ialah Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram dan Google Business Profile.

Adakah ia berfungsi terhadap pelayan tempatan?

Ya. Tetapkan HERMOSO_API_BASE ke asal anda sendiri (contohnya http://localhost:3000) dan CLI serta pelayan MCP kedua-duanya menyasarkannya. Asas localhost tidak memerlukan token auth.

Berkaitan

Render dijalankan sebagai tugas pelayan yang anda undi, dan siaran yang dicuba semula selamat walaupun hasil percubaan pertama tidak diketahui. Butirannya ada dalam tugas dan idempotensi.

Sedang menyediakannya dalam Claude Code? Lihat pemasaran Claude Code.

Pasang CLI, log masuk dari pelayar anda, dan sapuan pesaing pertama anda hanya satu arahan lagi. Akaun percuma, 250+ kredit percuma yang boleh diperoleh, tanpa kad.

Mulakan percuma → Baca dokumen MCP →

Jalankan iklan dari baris arahan