Reklam araçları neredeyse tamamen panellerden oluşur ve bu yüzden neredeyse tamamen otomatikleştirilemez. Bir paneli cron ile çalıştıramazsınız, bir paneli jq'ya yönlendiremezsiniz ve bir terminal ajanından birine tıklamasını isteyemezsiniz. Hermoso CLI, reklam döngüsünün ziyaret ettiğiniz bir yer olmaktan çıkıp betiklenebilir bir şeye dönüşmesi için var.
Kurun ve oturum açın:
npm install -g hermoso
hermoso auth loginauth login, bir loopback dinleyicisi başlatır ve tarayıcıyı açar; gh ve firebase'in kullandığı desenin aynısı. Yapıştırılacak bir şey yoktur. Üretilen anahtar, gerçek harcama yetkisi taşıdığı için ~/.hermoso/config.json dosyasına yalnızca sahibinin izinleriyle (dizin 0700, dosya 0600) yazılır. CI için hermoso auth login --token <key> etkileşimsiz olarak bir anahtar saklar; HERMOSO_TOKEN ve HERMOSO_API_BASE ise yapılandırmayı ortamdan geçersiz kılar.
Komutlar
Her komut --json alır; asıl önemli olan budur: insanların okuduğu satır bir kolaylıktır, JSON ise sözleşmedir.
| Komut | Ne yapar |
|---|---|
hermoso capabilities | Geçerli model kimlikleri ve kesin kredi maliyetleri. Önce bunu çalıştırın. Ücretsiz ve salt okunurdur; model adlarını tahmin etmeyi bırakmanın yoludur. |
hermoso credits | Bakiye, oturum kullanımı ve son ücretli çağrılar. |
hermoso brand --domain example.com | Bir web sitesini, sonraki renderların dayanacağı bir marka profiline (ürünler, renk paleti, logo, ses) dönüştürür. |
hermoso competitors --domain example.com | Doğrudan rakipleri ve öğrenmeye değer benzer markaları bulur. |
hermoso ads --company "Brand" | Bu reklamverenin Meta, Google ve LinkedIn reklam kütüphanelerindeki gerçek yayındaki reklamlarını çeker; tekilleştirilmiş ve sıralanmış. |
hermoso research "longest-running protein bar ads" | Kütüphanelerde ve organik TikTok'ta doğal dille reklam araştırması yapar; bulduğu reklamları döndürür. |
hermoso create --brand … --product … --format video | Bir brifi bitmiş bir reklam konseptine çevirir: metin varyantları artı bir görsel konsept ya da bir video storyboard'u, render için model kimlikleriyle birlikte. |
hermoso generate image --prompt "…" --ref ./bottle.png | Render eder ve sunulan bir URL döndürür. --ref, gerçek ürününüzü bileşime katar; böylece ekrandaki etiket gerçek SKU'nuz olur. |
hermoso jobs / hermoso fetch <url> | Devam eden renderları inceler; herhangi bir varlığı tıklanabilir ve doğrudan indirilebilir bir URL'ye çözer. |
hermoso mcp | Hosted sunucunun sunduğu aynı araçları, tam 922+ araçlık MCP yüzeyi olarak stdio üzerinden sunar. |
Tek paket, iki yüzey ve bunun neden önemli olduğu
Terminal ajanları araçların bedelini iki kez öder: bir kez bağlamlarında taşıdıkları manifestte, bir kez de her çağrının harcadığı tokenlarda. 922+ araçlık bir manifest bedava değildir. Bu yüzden aynı paket iki yüzeyi de sunar ve seçimi ajana bırakır:
- MCP (
hermoso mcpveya barındırılanhttps://app.hermoso.ai/mcp), tam yüzeyi ve zengin tipli argümanları istediğinizde. - Alt süreç komutları, token açısından ucuz yolu istediğinizde: ajan komut çalıştırır, JSON okur ve hiç manifest yüklemez. Paketle gelen Claude becerilerinin kullandığı desen budur.
İkisi de aynı API'ye gider, aynı kredileri harcar ve aynı kütüphaneye yazar; bu yüzden bir tarafta hiçbir şey yalnız kalmaz.
Betiklemeye değer şeyler
- Haftalık bir rakip taraması.
hermoso competitorsçıktısınıhermoso ads'e verin, geçen haftayla karşılaştırın ve pazarınızın neyi yayınlamaya başlayıp neyi bıraktığına dair sürekli bir rapor elde edin. - Bir katalog için toplu kreatif. SKU'lar üzerinde döngü kurun, ürün başına bir gerçek ürün bazlı reklam render edin ve dönen URL'leri toplayın. Arayüzde gerçekten sıkıcı olan iş türü budur.
- CI'da kredi koruması.
hermoso credits --json | jq .balancekomutunu çalıştırın ve uzun bir toplu işe bakiye boşken başlamadan önce pipeline'ı durdurun. - Maliyete duyarlı model seçimi.
hermoso capabilities --json, model başına kesin maliyetleri verir; böylece bir betik bir modeli sabit kodlamak yerine brife uyan en ucuz modeli seçebilir.
Paylaşım ve kampanyalar
CLI alt komutları araştırma ve üretimi kapsar. Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads ve AppLovin Ads üzerinde paylaşım, planlama ve kampanya yönetimi ise MCP yüzeyinde yaşar; aynı paketten hermoso mcp ile, barındırılan uç noktadan ya da web stüdyosundan erişilir. Paylaşım hedefleri Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram ve Google Business Profile'dır.
Sormadan yapmayacakları
Bütçesi olan bir ajan, etki alanı sınırlı olduğunda işe yarar; bu yüzden harcama yetkisi bir yönergede değil, sunucuda sınırlandırılır. Meta kampanyaları, reklam setleri ve reklamlar, çağıranın geçersiz kılma seçeneği olmadan PAUSED olarak oluşturulur. Gerçek reklam harcamasını açabilen durum anahtarları (her reklam platformunda biri: 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 ve set_openai_ads_status bunlar arasında), açık bir onay bayrağı olmadan çalışmayı reddeder. Aynı kapı, zaten etkin bir üst öğenin altında etkin bir Google Ads reklam grubu, reklam veya anahtar kelime oluşturmayı da kapsar; çünkü bu, bir sonraki açık artırmada hemen gösterilir. Silme işlemleri de onay gerektirir. Üretim tarafında ise hermoso_capabilities, her modelin kesin kredi maliyetini bir şey çalışmadan önce yayınlar; her render önce bir tahmini ayırır, sonra gerçek maliyeti kesinleştirir. Böylece başarısız bir gönderim sessizce ücretlendirilmek yerine iade edilir.
Bir kabuk yerine bir ajanın içinde mi çalışıyorsunuz? Claude Code ile pazarlama otomasyonuna ve tam MCP ve CLI başvurusuna bakın.
Sık sorulanlar
Reklam yürütmek için bir komut satırı aracı var mı?
Evet. npm install -g hermoso, Hermoso CLI'yi kurar; bu CLI Meta, Google ve LinkedIn reklam kütüphanelerinde rakip reklamlarını araştırır, bir web sitesinden marka profili hazırlar, bitmiş görsel ve video reklamları planlar ve render eder, kredileri ve işleri raporlar. Her komut betikleme için --json çıktısı verir. Aynı paket, stdio üzerinden tam 922+ araçlık MCP sunucusunu da sunar.
Hermoso CLI'de nasıl kimlik doğrularım?
hermoso auth login komutunu çalıştırın. Bu, bir loopback tarayıcı oturumu açar (gh ve firebase'in kullandığı desen) ve üretilen anahtarı ~/.hermoso/config.json dosyasına yalnızca sahibinin izinleriyle (dizin 0700, dosya 0600) kaydeder. CI için hermoso auth login --token <key> anahtarı etkileşimsiz olarak saklar; HERMOSO_TOKEN ve HERMOSO_API_BASE ise yapılandırmayı ortamdan geçersiz kılar.
Çıktıyı jq'ya yönlendirebilir miyim?
Evet. Her komut --json kabul eder ve yapılandırılmış bir nesne yazdırır. Amaçlanan sözleşme budur; insanların okuduğu satır yalnızca bir kolaylıktır. Uzun bir render toplu işinden önce hermoso credits --json | jq .balance kullanışlı bir CI korumasıdır.
MCP sunucusu yerine neden CLI kullanayım?
Token maliyeti. Bir MCP istemcisi araç manifestini bağlamına yükler ve 922+ araç bedava değildir. Alt süreç komutlarını çalıştırıp JSON okuyan bir terminal ajanının hiç manifesti yoktur. İki yüzey de aynı API'ye gider, aynı kredileri harcar ve aynı kütüphaneye yazar; bu yüzden ikisini birlikte kullanabilirsiniz.
CLI ile Facebook'a paylaşım yapabilir ya da Meta reklamlarını yönetebilir miyim?
Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads ve AppLovin Ads üzerinde paylaşım, planlama ve kampanya yönetimi, CLI alt komutları yerine MCP yüzeyinde yaşar; aynı paketten hermoso mcp çalıştırarak, https://app.hermoso.ai/mcp adresindeki barındırılan uç noktadan ya da web stüdyosundan erişilir. Paylaşım hedefleri Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram ve Google Business Profile'dır.
Yerel bir sunucuya karşı çalışır mı?
Evet. HERMOSO_API_BASE değerini kendi kaynağınıza (örneğin http://localhost:3000) ayarlayın; hem CLI hem MCP sunucusu buna yönelir. Localhost tabanı bir kimlik doğrulama belirteci gerektirmez.
İlgili
Renderlar, yoklayabileceğiniz sunucu tarafı işler olarak çalışır ve ilk denemenin sonucu bilinmese bile yeniden denenen bir paylaşım güvenlidir. Ayrıntılar için işler ve idempotency sayfasına bakın.
Bunu bunun yerine Claude Code içinde kurmak mı istiyorsunuz? Claude Code pazarlaması sayfasına bakın.
CLI'yi kurun, tarayıcınızdan oturum açın; ilk rakip taramanız tek bir komut uzaklığında. Ücretsiz hesap, kazanılabilir 250+ ücretsiz kredi, kart yok.
Ücretsiz başla → MCP belgelerini oku →