Narzędzia reklamowe to prawie wyłącznie panele, co czyni je prawie niemożliwymi do zautomatyzowania. Nie da się dodać panelu do crona, nie przepuścisz panelu przez jq i nie poprosisz agenta terminalowego, by kliknął w panel. CLI Hermoso istnieje po to, by pętla reklamowa przestała być miejscem, które odwiedzasz, a zaczęła być czymś, co można skryptować.
Zainstaluj i zaloguj się:
npm install -g hermoso
hermoso auth loginauth login uruchamia lokalny nasłuch zwrotny i otwiera przeglądarkę, tym samym wzorcem, którego używają gh i firebase, więc nic nie trzeba wklejać. Wygenerowany klucz zapisywany jest w ~/.hermoso/config.json z uprawnieniami tylko dla właściciela (katalog 0700, plik 0600), bo daje realną władzę nad wydatkami. Do CI hermoso auth login --token <key> zapisuje klucz bez interakcji, a HERMOSO_TOKEN i HERMOSO_API_BASE nadpisują konfigurację ze środowiska.
Polecenia
Każde polecenie przyjmuje --json, i o to właśnie chodzi: czytelna dla człowieka linia to wygoda, a JSON to kontrakt.
| Polecenie | Co robi |
|---|---|
hermoso capabilities | Poprawne identyfikatory modeli i ich dokładne koszty w kredytach. Uruchom to najpierw. Jest bezpłatne i tylko do odczytu, i tak przestajesz zgadywać nazwy modeli. |
hermoso credits | Saldo, zużycie w sesji i ostatnie płatne wywołania. |
hermoso brand --domain example.com | Odczytuje stronę internetową do profilu marki (produkty, paleta, logo, głos), na którym opierają się późniejsze renderowania. |
hermoso competitors --domain example.com | Wykrywa bezpośrednich konkurentów i podobne marki, warte podpatrzenia. |
hermoso ads --company "Brand" | Pobiera prawdziwe, działające reklamy tego reklamodawcy z bibliotek Meta, Google i LinkedIn, zdeduplikowane i posortowane. |
hermoso research "longest-running protein bar ads" | Research reklam w języku naturalnym w bibliotekach oraz w organicznym TikToku, zwraca znalezione reklamy. |
hermoso create --brand … --product … --format video | Zamienia brief w gotową koncepcję reklamy: warianty tekstu oraz koncepcję obrazu albo storyboard wideo, z identyfikatorami modeli do wyrenderowania. |
hermoso generate image --prompt "…" --ref ./bottle.png | Renderuje i zwraca obsługiwany adres URL. --ref wkomponowuje twój prawdziwy produkt, więc etykieta na ekranie to twój faktyczny SKU. |
hermoso jobs / hermoso fetch <url> | Sprawdza renderowania w toku; rozwiązuje dowolny zasób do klikalnego adresu i adresu bezpośredniego pobrania. |
hermoso mcp | Udostępnia pełną powierzchnię MCP z ponad 922 narzędziami przez stdio, te same narzędzia, które oferuje hostowany serwer. |
Dwie powierzchnie, jeden pakiet i dlaczego to ważne
Agenci terminalowi płacą za narzędzia dwa razy: raz za manifest, który noszą w kontekście, i raz za tokeny, które kosztuje każde wywołanie. Manifest z ponad 922 narzędziami nie jest darmowy. Dlatego ten sam pakiet dostarcza obie powierzchnie i pozwala agentowi wybrać:
- MCP (
hermoso mcpalbo hostowanehttps://app.hermoso.ai/mcp), gdy chcesz pełnej powierzchni i bogatych, typowanych argumentów. - Polecenia podprocesów, gdy chcesz ścieżki oszczędnej w tokenach: agent wywołuje polecenie z powłoki, czyta JSON i nigdy nie ładuje manifestu. Tak działają dołączone umiejętności Claude.
Oba korzystają z tego samego API, płacą tymi samymi kredytami i zapisują do tej samej biblioteki, więc nic nie zostaje utknięte po jednej stronie.
Rzeczy warte skryptowania
- Cotygodniowy przegląd konkurencji.
hermoso competitorsprzekazany dohermoso ads, porównanie z zeszłym tygodniem i masz stały raport o tym, co twój rynek zaczął i przestał puszczać. - Seryjne kreacje dla katalogu. Przejdź po SKU, wyrenderuj jedną ugruntowaną reklamę na produkt i zbierz zwrócone adresy URL. To zadanie, które w interfejsie jest po prostu żmudne.
- Strażnik kredytów w CI.
hermoso credits --json | jq .balancei przerwij potok, zanim długa partia ruszy na pustym saldzie. - Wybór modelu zależny od kosztu.
hermoso capabilities --jsonudostępnia dokładne koszty na model, więc skrypt może wybrać najtańszy model spełniający brief, zamiast mieć jeden na sztywno.
Publikowanie i kampanie
Podpolecenia CLI obejmują research i tworzenie. Publikowanie, planowanie i zarządzanie kampaniami w Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads i AppLovin Ads znajdują się w powierzchni MCP, dostępnej z tego samego pakietu przez hermoso mcp, z hostowanego adresu albo ze studia w przeglądarce. Celami publikacji są Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram i Google Business Profile.
Czego nie zrobi bez pytania
Agent z budżetem jest użyteczny tylko wtedy, gdy zakres jego działania jest ograniczony, dlatego uprawnienia do wydawania są egzekwowane w serwerze, a nie w prompcie. Kampanie Meta, zestawy reklam i reklamy są tworzone jako PAUSED, bez możliwości nadpisania przez wywołującego. Przełączniki statusu, które mogą uruchomić prawdziwe wydatki na reklamy (jeden na każdej platformie reklamowej: 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, między innymi), odmawiają działania bez jawnej flagi potwierdzenia. Ta sama bramka obejmuje tworzenie włączonej grupy reklam, reklamy lub słowa kluczowego w Google Ads pod już włączonym elementem nadrzędnym, bo taka reklama wyświetla się przy najbliższej aukcji. Usuwanie też wymaga potwierdzenia. Po stronie generowania hermoso_capabilities publikuje dokładny koszt w kredytach każdego modelu, zanim cokolwiek się uruchomi, a każdy render najpierw rezerwuje szacunek, a potem rozlicza prawdziwy koszt, więc nieudane wysłanie zwraca kredyty zamiast po cichu cię obciążać.
Pracujesz w agencie, a nie w powłoce? Zobacz marketing w Claude Code i pełną dokumentację MCP i CLI.
Często zadawane pytania
Czy istnieje narzędzie wiersza poleceń do prowadzenia reklam?
Tak. npm install -g hermoso instaluje CLI Hermoso, które bada reklamy konkurencji w bibliotekach Meta, Google i LinkedIn, tworzy profil marki ze strony internetowej, planuje i renderuje gotowe reklamy graficzne i wideo oraz raportuje kredyty i zadania, z wyjściem --json w każdym poleceniu do skryptów. Ten sam pakiet udostępnia też pełny serwer MCP z ponad 922 narzędziami przez stdio.
Jak uwierzytelnić CLI Hermoso?
Uruchom hermoso auth login. Otwiera ono logowanie w przeglądarce przez lokalny nasłuch zwrotny (tym samym wzorcem co gh i firebase) i zapisuje wygenerowany klucz w ~/.hermoso/config.json z uprawnieniami tylko dla właściciela (katalog 0700, plik 0600). Do CI hermoso auth login --token <key> zapisuje klucz bez interakcji, a HERMOSO_TOKEN i HERMOSO_API_BASE nadpisują konfigurację ze środowiska.
Czy mogę przepuścić wynik przez jq?
Tak. Każde polecenie przyjmuje --json i wypisuje ustrukturyzowany obiekt. To zamierzony kontrakt; czytelna dla człowieka linia to tylko wygoda. hermoso credits --json | jq .balance to przydatny strażnik w CI przed długą partią renderów.
Po co używać CLI zamiast serwera MCP?
Koszt w tokenach. Klient MCP ładuje manifest narzędzi do kontekstu, a ponad 922 narzędzia nie są darmowe. Agent terminalowy, który wywołuje polecenia podprocesów i czyta JSON, nie dźwiga żadnego manifestu. Obie powierzchnie korzystają z tego samego API, płacą te same kredyty i zapisują do tej samej biblioteki, więc możesz je mieszać.
Czy CLI może publikować na Facebooku lub zarządzać reklamami Meta?
Publikowanie, planowanie i zarządzanie kampaniami w Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads i AppLovin Ads znajdują się w powierzchni MCP, a nie w podpoleceniach CLI. Są dostępne z tego samego pakietu przez uruchomienie hermoso mcp, z hostowanego adresu https://app.hermoso.ai/mcp albo ze studia w przeglądarce. Celami publikacji są Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram i Google Business Profile.
Czy działa to z lokalnym serwerem?
Tak. Ustaw HERMOSO_API_BASE na własny adres źródłowy (na przykład http://localhost:3000), a CLI i serwer MCP będą się do niego łączyć. Lokalny adres bazowy nie wymaga tokenu uwierzytelniającego.
Powiązane
Rendery działają jako zadania po stronie serwera, które odpytujesz, a ponowiona publikacja jest bezpieczna nawet wtedy, gdy wynik pierwszej próby jest nieznany. Szczegóły znajdziesz w zadaniach i idempotentności.
Konfigurujesz to w Claude Code? Zobacz marketing w Claude Code.
Zainstaluj CLI, zaloguj się z przeglądarki, a pierwszy przegląd konkurencji dzieli cię od jednego polecenia. Darmowe konto, ponad 250 kredytów do zdobycia, bez karty.
Zacznij za darmo → Przeczytaj dokumentację MCP →