Perangkat pemasaran iklan hampir seluruhnya berupa dashboard, sehingga hampir seluruhnya tidak bisa diotomatisasi. Anda tidak bisa menjadwalkan dashboard lewat cron, tidak bisa mengalirkan dashboard ke jq, dan tidak bisa meminta agen terminal mengkliknya. CLI Hermoso ada supaya loop iklan berhenti menjadi tempat yang Anda datangi dan mulai menjadi sesuatu yang bisa Anda script.
Pasang dan masuk:
npm install -g hermoso
hermoso auth loginauth login membuka listener loopback dan membuka browser, pola yang sama dengan yang dipakai gh dan firebase, jadi tidak ada yang perlu ditempel. Kunci yang dibuat ditulis ke ~/.hermoso/config.json dengan izin hanya untuk pemilik (direktori 0700, file 0600), karena kunci itu membawa kewenangan belanja sungguhan. Untuk CI, hermoso auth login --token <key> menyimpan satu kunci tanpa interaksi, dan HERMOSO_TOKEN / HERMOSO_API_BASE menimpa config dari environment.
Perintahnya
Setiap perintah menerima --json, dan itulah intinya: baris yang bisa dibaca manusia hanyalah kemudahan, sedangkan JSON adalah kontraknya.
| Perintah | Fungsinya |
|---|---|
hermoso capabilities | ID model yang valid dan biaya kredit pastinya. Jalankan ini dulu. Gratis dan hanya-baca, dan inilah cara Anda berhenti menebak nama model. |
hermoso credits | Saldo, pemakaian sesi, dan panggilan berbayar terakhir. |
hermoso brand --domain example.com | Membaca situs web menjadi profil brand (produk, palet warna, logo, nada bicara) yang menjadi dasar render berikutnya. |
hermoso competitors --domain example.com | Menemukan pesaing langsung dan brand serupa yang layak dipelajari. |
hermoso ads --company "Brand" | Mengambil iklan yang sedang tayang dari advertiser tersebut di perpustakaan iklan Meta, Google, dan LinkedIn, sudah dideduplikasi dan diurutkan. |
hermoso research "longest-running protein bar ads" | Riset iklan dengan bahasa natural di perpustakaan iklan ditambah TikTok organik, mengembalikan iklan yang ditemukan. |
hermoso create --brand … --product … --format video | Mengubah brief menjadi konsep iklan jadi: varian salinan ditambah konsep gambar atau storyboard video, dengan ID model untuk merendernya. |
hermoso generate image --prompt "…" --ref ./bottle.png | Merender dan mengembalikan URL yang disajikan. --ref menyisipkan produk asli Anda sehingga label di layar adalah SKU Anda yang sebenarnya. |
hermoso jobs / hermoso fetch <url> | Memeriksa render yang sedang berjalan; mengubah aset apa pun menjadi URL yang bisa diklik dan URL unduh langsung. |
hermoso mcp | Menyajikan permukaan MCP 922+ alat lengkap lewat stdio, alat yang sama dengan yang disediakan server yang di-host. |
Dua permukaan, satu paket, dan mengapa itu penting
Agen terminal membayar alat dua kali: sekali di manifest yang mereka bawa dalam konteks, dan sekali lagi di token yang dihabiskan tiap panggilan. Manifest 922+ alat tidak gratis. Karena itu paket yang sama menyediakan kedua permukaan dan membiarkan agen memilih:
- MCP (
hermoso mcp, atauhttps://app.hermoso.ai/mcpyang di-host) saat Anda menginginkan permukaan lengkap dan argumen bertipe yang kaya. - Perintah subproses saat Anda menginginkan jalur hemat token: agen menjalankan perintah shell, membaca JSON, dan tidak pernah memuat manifest sama sekali. Ini pola yang dipakai skill Claude bawaan.
Keduanya memanggil API yang sama, membebankan kredit yang sama, dan menulis ke perpustakaan yang sama, jadi tidak ada yang tertinggal di salah satu sisi.
Hal-hal yang layak di-script
- Pemindaian pesaing mingguan.
hermoso competitorskehermoso ads, bandingkan dengan minggu lalu, dan Anda punya laporan tetap tentang apa yang mulai dan berhenti dijalankan pasar Anda. - Kreatif batch untuk katalog. Ulangi per SKU, render satu iklan berpijak untuk setiap produk, lalu kumpulkan URL yang dikembalikan. Ini jenis pekerjaan yang benar-benar membosankan di antarmuka.
- Penjaga kredit di CI.
hermoso credits --json | jq .balance, lalu gagalkan pipeline sebelum batch panjang dimulai dengan saldo kosong. - Pemilihan model yang sadar biaya.
hermoso capabilities --jsonmenampilkan biaya pasti per model, sehingga script bisa memilih model termurah yang memenuhi brief alih-alih mengunci satu model.
Publikasi dan kampanye
Subperintah CLI mencakup riset dan pembuatan. Publikasi, penjadwalan, dan pengelolaan kampanye di Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads, dan AppLovin Ads ada di permukaan MCP. Anda bisa menjangkaunya dari paket yang sama dengan hermoso mcp, dari endpoint yang di-host, atau dari studio web. Target publikasinya adalah Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, dan Google Business Profile.
Yang tidak akan dilakukannya tanpa bertanya
Agen dengan anggaran hanya berguna jika dampaknya terbatas, jadi kewenangan belanja dikunci di server, bukan di prompt. Kampanye, ad set, dan iklan Meta dibuat dengan PAUSED tanpa cara bagi pemanggil untuk menggantinya. Sakelar status yang bisa menyalakan belanja iklan sungguhan (satu di 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, di antaranya) semuanya menolak berjalan tanpa flag konfirmasi eksplisit, dan gerbang yang sama juga mencakup pembuatan ad group, iklan, atau kata kunci Google Ads yang aktif di bawah induk yang sudah aktif, karena itu akan tayang pada lelang berikutnya. Penghapusan juga memerlukan konfirmasi. Dari sisi generasi, hermoso_capabilities menampilkan biaya kredit pasti setiap model sebelum apa pun berjalan, dan setiap render memesan estimasi lalu menyelesaikan biaya sebenarnya, sehingga pengiriman yang gagal dikembalikan, bukan diam-diam ditagihkan ke Anda.
Bekerja di dalam agen, bukan shell? Lihat pemasaran Claude Code dan referensi MCP & CLI lengkap.
Pertanyaan yang sering diajukan
Adakah alat baris perintah untuk menjalankan iklan?
Ada. npm install -g hermoso memasang CLI Hermoso, yang meriset iklan pesaing di perpustakaan iklan Meta, Google, dan LinkedIn, menyusun profil brand dari situs web, merencanakan dan merender iklan gambar dan video jadi, serta melaporkan kredit dan pekerjaan, dengan output --json di setiap perintah untuk scripting. Paket yang sama juga menyajikan server MCP lengkap 922+ alat lewat stdio.
Bagaimana cara melakukan autentikasi CLI Hermoso?
Jalankan hermoso auth login. Perintah ini membuka proses masuk di browser lewat loopback (pola yang sama dengan gh dan firebase) dan menyimpan kunci yang dibuat di ~/.hermoso/config.json dengan izin hanya untuk pemilik (direktori 0700, file 0600). Untuk CI, hermoso auth login --token <key> menyimpan satu kunci tanpa interaksi, dan HERMOSO_TOKEN serta HERMOSO_API_BASE menimpa config dari environment.
Bisakah saya mengalirkan output ke jq?
Bisa. Setiap perintah menerima --json dan mencetak objek terstruktur. Itulah kontrak yang dimaksud; baris yang bisa dibaca manusia hanyalah kemudahan. hermoso credits --json | jq .balance adalah penjaga CI yang berguna sebelum batch render panjang.
Mengapa memakai CLI alih-alih server MCP?
Biaya token. Klien MCP memuat manifest alat ke dalam konteks, dan 922+ alat tidak gratis. Agen terminal yang menjalankan perintah subproses dan membaca JSON tidak membawa manifest sama sekali. Kedua permukaan memanggil API yang sama, membebankan kredit yang sama, dan menulis ke perpustakaan yang sama, sehingga Anda bisa mencampurkannya.
Bisakah CLI memublikasikan ke Facebook atau mengelola iklan Meta?
Publikasi, penjadwalan, dan pengelolaan kampanye di Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads, dan AppLovin Ads ada di permukaan MCP, bukan di subperintah CLI. Anda bisa menjangkaunya dari paket yang sama dengan menjalankan hermoso mcp, dari endpoint yang di-host di https://app.hermoso.ai/mcp, atau dari studio web. Target publikasinya adalah Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, dan Google Business Profile.
Apakah ini bekerja dengan server lokal?
Bisa. Atur HERMOSO_API_BASE ke origin Anda sendiri (misalnya http://localhost:3000) dan CLI serta server MCP sama-sama menargetkannya. Basis localhost tidak memerlukan token autentikasi.
Terkait
Render berjalan sebagai pekerjaan sisi server yang Anda polling, dan posting yang diulang aman meski hasil percobaan pertama tidak diketahui. Detailnya ada di pekerjaan dan idempotensi.
Ingin menyiapkannya di dalam Claude Code? Lihat pemasaran Claude Code.
Pasang CLI, masuk dari browser Anda, dan pemindaian pesaing pertama Anda tinggal satu perintah. Akun gratis, 250+ kredit gratis yang bisa diperoleh, tanpa kartu.
Mulai gratis → Baca dokumentasi MCP →