Рекламні інструменти майже повністю складаються з панелей, а тому майже повністю не автоматизуються. Панель не запустиш через cron, її не передаси в jq, і термінальний агент не може на ній клацнути. CLI Hermoso існує для того, щоб рекламний цикл перестав бути місцем, куди ви ходите, і став тим, що можна скриптувати.
Встановлення і вхід:
npm install -g hermoso
hermoso auth loginauth login запускає локальний слухач на loopback і відкриває браузер, за тим самим принципом, що використовують gh і firebase, тож нічого вставляти не треба. Створений ключ записується в ~/.hermoso/config.json з правами лише для власника (тека 0700, файл 0600), бо він несе реальні повноваження щодо витрат. Для CI hermoso auth login --token <key> зберігає ключ без інтерактиву, а HERMOSO_TOKEN і HERMOSO_API_BASE перевизначають конфіг із середовища.
Команди
Кожна команда приймає --json, і в цьому вся суть: рядок для людини це зручність, а JSON це контракт.
| Команда | Що робить |
|---|---|
hermoso capabilities | Дійсні ідентифікатори моделей і їхня точна вартість кредитів. Запускайте першою. Команда безкоштовна і лише читає дані, і саме так ви перестаєте вгадувати назви моделей. |
hermoso credits | Баланс, використання в сесії та останні платні виклики. |
hermoso brand --domain example.com | Зчитує сайт у профіль бренду (товари, палітра, логотип, голос), на якому ґрунтуватимуться наступні рендери. |
hermoso competitors --domain example.com | Знаходить прямих конкурентів і схожі бренди, з яких варто повчитися. |
hermoso ads --company "Brand" | Витягує реальні оголошення цього рекламодавця з бібліотек Meta, Google і LinkedIn, без дублів і відсортовані. |
hermoso research "longest-running protein bar ads" | Дослідження реклами природною мовою в бібліотеках плюс органічний TikTok, повертає знайдені оголошення. |
hermoso create --brand … --product … --format video | Перетворює бриф на готову концепцію оголошення: варіанти тексту плюс концепцію зображення або розкадровку відео з ідентифікаторами моделей для рендеру. |
hermoso generate image --prompt "…" --ref ./bottle.png | Рендерить і повертає обслуговувану URL-адресу. --ref вбудовує ваш реальний товар, тож етикетка на екрані є вашим справжнім SKU. |
hermoso jobs / hermoso fetch <url> | Перевіряє рендери, що в роботі; перетворює будь-який актив на посилання для перегляду і пряме завантаження. |
hermoso mcp | Віддає повну поверхню MCP на 922+ інструменти через stdio, ті самі інструменти, що й хмарний сервер. |
Дві поверхні, один пакет і чому це важливо
Термінальні агенти платять за інструменти двічі: раз у маніфесті, який тримають у контексті, і вдруге в токенах за кожен виклик. Маніфест на 922+ інструменти не безкоштовний. Тому той самий пакет постачає обидві поверхні, і агент сам обирає:
- MCP (
hermoso mcpабо хмарнийhttps://app.hermoso.ai/mcp), коли потрібна повна поверхня і типізовані аргументи. - Команди підпроцесів, коли потрібен дешевий за токенами шлях: агент викликає команди оболонки, читає JSON і не тримає маніфест узагалі. Саме так працюють вбудовані навички Claude.
Обидва звертаються до того самого API, списують ті самі кредити і пишуть у ту саму бібліотеку, тож ніщо не застрягає на одній стороні.
Що варто скриптувати
- Щотижневий огляд конкурентів.
hermoso competitorsуhermoso ads, порівняти з минулим тижнем, і ви маєте постійний звіт про те, що ваш ринок почав і перестав показувати. - Пакетний креатив для каталогу. Пройдіть по SKU, відрендерте по одному обґрунтованому оголошенню на товар і зберіть повернені URL. Це робота, яка в інтерфейсі справді виснажлива.
- Захист кредитів у CI.
hermoso credits --json | jq .balance, і зупиняйте конвеєр до початку великої партії, якщо баланс порожній. - Вибір моделі з урахуванням вартості.
hermoso capabilities --jsonпоказує точну вартість кожної моделі, тож скрипт може вибрати найдешевшу модель, що відповідає брифу, замість жорсткого прив'язування до однієї.
Публікації та кампанії
Підкоманди CLI покривають дослідження і створення. Публікація, планування та керування кампаніями в Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads і AppLovin Ads живуть у поверхні MCP, доступній із того самого пакета через hermoso mcp, з хмарної кінцевої точки або з веб-студії. Цілі публікації: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram і Google Business Profile.
Що він не зробить без запиту
Агент із бюджетом корисний лише тоді, коли радіус дії обмежений, тож повноваження щодо витрат закріплено на сервері, а не в промпті. Кампанії, групи оголошень і оголошення Meta створюються з PAUSED без можливості перевизначити це з боку викликача. Перемикачі статусу, які можуть запустити реальні витрати на рекламу (один на кожній рекламній платформі: 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 та set_openai_ads_status серед них), відмовляються працювати без явного прапорця підтвердження. Та сама перевірка охоплює створення увімкненої групи оголошень, оголошення або ключового слова Google Ads під уже увімкненим батьківським елементом, бо такі показуються на найближчому аукціоні. Видалення теж потребують підтвердження. Щодо генерації: hermoso_capabilities публікує точну вартість кожної моделі до будь-якого запуску, а кожен рендер спершу резервує оцінку, а потім списує фактичну вартість, тож невдала відправка повертає кошти, а не тихо списує їх.
Працюєте в агенті, а не в оболонці? Див. маркетинг у Claude Code і повний довідник MCP і CLI.
Поширені запитання
Чи є інструмент командного рядка для запуску реклами?
Так. npm install -g hermoso встановлює CLI Hermoso, який досліджує рекламу конкурентів у бібліотеках Meta, Google і LinkedIn, складає профіль бренду з сайту, планує і рендерить готові відео та зображення, а також показує кредити і завдання, з виводом --json для кожної команди, призначеним для скриптів. Той самий пакет також віддає повний MCP-сервер на 922+ інструменти через stdio.
Як автентифікуватися в CLI Hermoso?
Виконайте hermoso auth login. Це відкриває вхід через браузер на loopback (за тим самим принципом, що gh і firebase) і зберігає створений ключ у ~/.hermoso/config.json з правами лише для власника (тека 0700, файл 0600). Для CI hermoso auth login --token <key> зберігає ключ без інтерактиву, а HERMOSO_TOKEN і HERMOSO_API_BASE перевизначають конфіг із середовища.
Чи можна передати вивід у jq?
Так. Кожна команда приймає --json і виводить структурований об'єкт. Це задуманий контракт; рядок для людини є лише зручністю. Корисний захист у CI перед довгою партією рендерів: hermoso credits --json | jq .balance.
Навіщо використовувати CLI, а не MCP-сервер?
Через вартість токенів. MCP-клієнт завантажує маніфест інструментів у контекст, а 922+ інструменти не безкоштовні. Термінальний агент, який викликає команди підпроцесів і читає JSON, не тримає маніфест узагалі. Обидві поверхні звертаються до одного API, списують ті самі кредити і пишуть у ту саму бібліотеку, тож їх можна змішувати.
Чи може CLI публікувати у Facebook або керувати рекламою Meta?
Публікація, планування та керування кампаніями в Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads і AppLovin Ads живуть у поверхні MCP, а не в підкомандах CLI. До них можна дістатися з того самого пакета через hermoso mcp, з хмарної кінцевої точки https://app.hermoso.ai/mcp або з веб-студії. Цілі публікації: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram і Google Business Profile.
Чи працює це з локальним сервером?
Так. Установіть HERMOSO_API_BASE на свою адресу (наприклад, http://localhost:3000), і CLI та MCP-сервер звертатимуться до неї. Для localhost токен автентифікації не потрібен.
Пов'язане
Рендери виконуються як серверні завдання, які ви опитуєте, а повторна публікація безпечна, навіть коли результат першої спроби невідомий. Деталі в завданнях та ідемпотентності.
Налаштовуєте це всередині Claude Code? Див. маркетинг у Claude Code.
Встановіть CLI, увійдіть через браузер, і перший огляд конкурентів буде за одну команду. Безкоштовний акаунт, 250+ кредитів, які можна заробити безкоштовно, без картки.
Почніть безкоштовно → Читати документацію MCP →