Hermoso — MCP, CLI и Skills

Управляйте всей своей маркетинговой операцией из любого ИИ-агента: Claude Code, Claude.ai, Cursor, Codex или ваших собственных скриптов. Исследуйте рекламу, которая уже побеждает на рынке, генерируйте готовые изображения и видеорекламу (с композицией вашего реального продукта, включая текст и CTA), публикуйте их в свои социальные каналы, а также создавайте и управляйте рекламными кампаниями — всё через MCP инструменты, CLI или устанавливаемые навыки Claude.

718 инструментов. tools/list всегда является авторитетным набором; hermoso_capabilities (бесплатно) возвращает живую модель каталога с точной стоимостью кредитов за рендер, а также полную карту возможностей.

К чему это подключается. Рекламные платформы: Meta, Google Ads, TikTok Ads, LinkedIn Ads, Reddit Ads, X Ads, Pinterest Ads, Snapchat Ads, Microsoft Advertising, Apple Search Ads и ChatGPT Ads, плюс фиды товаров в Google Merchant Center. Публикация и планирование — десять каналов: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky и Telegram. Обмен сообщениями: WhatsApp (вы отправляете сообщение человеку, так что это не одиннадцатый канал публикации). Исследование рекламы: библиотеки рекламы Meta, Google и LinkedIn, а также органические TikTok, Instagram, YouTube, Threads и Reddit. Аналитика: Google Analytics 4, Google Search Console и собственные данные постов и кампаний каждой подключенной платформы. Файлы: Google Drive, Sheets, Docs и OneDrive.

Это не всё или ничего. Исследование, создание, публикация/планирование и управление рекламой — четыре независимые области — ни один инструмент не требует, чтобы вы сначала использовали другой. Публикуйте или планируйте уже имеющийся креатив и ничего здесь не генерируйте (upload_file превращает любой локальный или внешний файл в URL, который принимают все инструменты публикации, планирования и создания рекламы); создавайте и читайте кампании на своих рекламных аккаунтах со своим креативом; исследуйте конкурентов без разработанного бренда и без подключенного канала; или генерируйте файл без каких-либо подключений и просто скачивайте его. Используйте ту часть, которая вам нужна, или всё вместе.

Какую поверхность должен использовать ваш агент?

Две формы, и правильная определяется тем, что может делать ваш клиент, а не тем, что предпочитаем мы.

Измеренная разница (2026-08-27, посчитано как реальные определения инструментов, а не оценено по байтам):

CLI вместо этого отвечает на те же вопросы по запросу, и только когда его спрашивают:

npx -y hermoso tools --search reddit   # every matching tool, name + one line   2,459 tokens
npx -y hermoso tools plan_ad           # one tool's full argument schema           633 tokens
npx -y hermoso call plan_ad --json '{"product":"…"}'   # run it

Таким образом, терминальный агент достигает своего первого вызова примерно за 3,4K токенов со всем набором в диапазоне, против 182K для его части. tools и tools <name> читают реестр, встроенный в пакет — без ключа, без сети, без входа — так что агент может просмотреть весь продукт до того, как кто-либо войдет. Только call тратит средства, и только ему нужен hermoso auth login один раз.

Оба одновременно — это нормально, и именно это мы предлагаем для Claude Code. Один hermoso auth login покрывает CLI и позволяет claude mcp add hermoso -- npx -y hermoso mcp подхватить ключ без блока env, так что агент может обратиться к нативному инструменту, когда хочет структурированных результатов, и к оболочке, когда хочет широты. Если вам нужен только один, берите CLI: он покрывает строго больше.

Когда коннектор всё же является лучшим выбором для клиента с поддержкой оболочки: сессия, которая собирается сделать много вызовов в одну область. enable_tools({groups:['ads']}) включает управление кампаниями одним бесплатным вызовом, и инструменты становятся нативными — без экранирования в оболочке, структурированные результаты. Один круглый обход оболочки лучше, чем загрузка группы на 221K токенов для одного инструмента; обратное верно, когда сессия обосновывается в этой области.

Related MCP server: Prizmad

Ваш агент может зарегистрироваться сам

Агент без учетной записи Hermoso может создать ее, получить собственный ключ и рендерить рекламу в той же сессии. Никакого человека в браузере, никаких тикетов, никакого ожидания.

# 1. Start a signup. This call takes no credential, because the credential is what it creates.
curl -sX POST https://app.hermoso.ai/v1/signup \
  -H 'content-type: application/json' \
  -d '{"plan":"pro","period":"mo"}'
# -> { "id": "cs_...", "checkout_url": "https://checkout.stripe.com/...", "claim_token": "hsc_..." }

# 2. Pay at checkout_url. Store claim_token first: it is returned only in that response.

# 3. Claim it. Poll until status is "ready".
curl -sX POST https://app.hermoso.ai/v1/signup/cs_.../claim \
  -H 'content-type: application/json' \
  -d '{"claim_token":"hsc_..."}'
# -> { "status": "ready", "api_key": "hmk_...", "credits": 3000 }

Этот ключ hmk_ — те же учетные данные, которые принимает всё остальное на этой странице: /v1, MCP-сервер, CLI. Укажите на него вашему клиенту, и вся поверхность открыта.

Оплата — это то, что браузерный агент уже может сделать сам. Оформление заказа — это собственная размещенная страница Stripe, поэтому Claude в Chrome и подобные клиенты завершают его без участия человека уже сегодня. Всё остальное — это передача в один клик: отправьте checkout_url тому, у кого есть карта. Та же схема покроет вас позже, когда вы уже работаете: buy_credits и upgrade_plan создают готовую к оплате ссылку для дополнительных кредитов или большего плана, а billing_status читает баланс в любое время.

Агентный путь требует платного плана. Любого из них. Бесплатный план предназначен для человека, регистрирующегося на app.hermoso.ai, и запрос здесь возвращает отказ, который так и говорит. Ничего не создается до завершения платежа, поэтому неоплаченная регистрация не оставляет учетной записи и ничего не списывает.

Одна вещь всё еще требует человека, и об этом стоит знать заранее. Подключение социального или рекламного аккаунта означает экран согласия OAuth, а экран согласия нельзя пройти без головы ни на одной платформе. list_connectors показывает, что уже подключено, а что нет. Всё остальное работает вообще без браузера: исследование, генерация, публикация на уже подключенный канал, создание кампаний, отчетность.

Полные формы запросов и ответов, а также все остальные конечные точки находятся в документе OpenAPI по адресу app.hermoso.ai/openapi.json, который обслуживается вживую из той же таблицы, что монтирует маршруты.

Мгновенно: размещенный коннектор Claude.ai

Вставьте https://app.hermoso.ai/mcp в Claude → Settings → Connectors → Add custom connector, подтвердите своей учетной записью Hermoso — готово: полный набор инструментов с сохраненным контекстом бренда, оплачиваемый по вашему плану.

Быстрый старт для Claude Code (одна строка)

1. Получите учетную запись на app.hermoso.ai — бесплатный тариф включен; планы и кредиты те же, что использует веб-студия. Или пропустите браузер полностью и позвольте вашему агенту зарегистрироваться на платном плане с помощью POST /v1/signup (выше).

2. Выполните одну строку. Ваш браузер откроется один раз для входа. Ничего вставлять не нужно, и никакой ключ не попадает в .claude.json:

npm install -g hermoso && hermoso auth login && claude mcp add hermoso -- npx -y hermoso mcp

3. Попросите то, что хотите, обычными промптами. Claude Code обращается к инструменту или запускает команду hermoso в вашем терминале, в зависимости от того, что нужно задаче. Вы не вводите ни то, ни другое.

Инструменты рекламных кампаний и аналитики остаются вне списка инструментов, пока вы не включите их с помощью enable_tools, что сохраняет его компактным. На машине без браузера войдите с помощью hermoso auth login --token hmk_…, используя ключ из Settings → Agents & API, или пропустите вход и передайте ключ клиенту напрямую:

claude mcp add hermoso -e HERMOSO_TOKEN=hmk_… -- npx -y hermoso mcp

Размещенный URL также работает в Claude Code, но это худший путь там, и стоит знать почему: claude mcp add --transport http hermoso https://app.hermoso.ai/mcp принимается, и затем claude mcp list сообщает ! Needs authentication, потому что клиент не запустит поток OAuth сам — вам нужно открыть сессию, выполнить /mcp, найти сервер и нажать Authenticate. Измерено на Claude Code 2.1.241 2026-08-23.

Теперь у вашего агента есть полная студия с контекстом вашего рабочего пространства: профиль бренда, продукты, логотипы и изученная память, которые вы настроили в веб-приложении, применяются автоматически (get_brand показывает, что сохранено; опустите brand в plan_ad/plan_variations, чтобы использовать его). Рендеры списывают ваши кредиты Hermoso — те же цены, что и в студии.

1. MCP-сервер (stdio) — Claude Code / Cursor / Codex

hermoso mcp запускает stdio MCP-сервер, предоставляющий полный набор инструментов. Опубликованный пакет hermoso означает отсутствие клонирования — npx -y hermoso mcp загружает и запускает его. Войдите один раз через CLI, и никакой ключ не попадет в конфигурацию клиента, потому что hermoso mcp читает сохраненный bearer hermoso auth login:

npm install -g hermoso && hermoso auth login && claude mcp add hermoso -- npx -y hermoso mcp

Cursor / Codex — войдите так же, затем добавьте в mcp.json (Codex использует эквивалент TOML). Полностью опустите блок env, если вы вошли выше; он нужен для CI, где процесс не может прочитать ваш домашний каталог:

{ "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"],
  "env": { "HERMOSO_API_BASE": "https://app.hermoso.ai", "HERMOSO_TOKEN": "<your token>" } } } }

Затем попросите вашего агента: «Сгенерируй рекламное изображение с Hermoso».

Что покрывают 718 инструментов

Шпионаж за рекламой / исследование — find_competitors, competitor_teardown, pull_competitor_ads, research_ads; библиотеки рекламы Meta / Google / LinkedIn (search_meta_ads, search_google_ads, search_linkedin_ads); органические социальные сети (search_tiktok, search_instagram, search_youtube, search_reddit, search_threads); fetch_social_data, mine_angles, analyze_video, check_ad_policy, list_skills / get_skill.

Создание — draft_brand → plan_ad → render_ad (конвейер качества студии: композиционный текст, чистая речь, музыка, финальная карточка бренда) или generate_image / generate_video / generate_avatar (UGC-создатели + синхронизация губ). Сохраненный актерский состав рабочего пространства можно использовать повторно: list_creators возвращает каждого сохраненного создателя с URL его портрета, save_creator добавляет, delete_creator удаляет — повторно передайте портрет в generate_avatar / generate_video / recast_motion, и ТОТ ЖЕ человек появится в каждой рекламе, а не новое лицо при каждом рендере. Также make_template_ad (нативные HTML-форматы рекламы), make_explainer, product_sizzle, make_thumbnail, remix_static, recast_motion, reframe_video, upscale_video, dub_video, change_voice, finish_video, fix_beat, stitch_video, clip_video, post_edit, плюс plan_variations + score_ad для расширения и ранжирования. Длину задаете вы: передайте durationSeconds в plan_ad, и раскадровка будет создана под нее — длина, которая умещается в один клип модели рендера, рендерится как один непрерывный дубль, более длинная сшивается из актов (на модели с 15-секундными клипами 40с = 15+15+10), никогда не сжимается по времени. То, что умещается в один клип, — это собственный максимум модели, а не фиксированное число: большинство видеомоделей ограничивают клип 15 секундами, а модель с самым длинным клипом делает 30 секунд одним непрерывным дублем с нативным синхронизированным звуком. hermoso_capabilities — это живой список: длительности, разрешения и точная стоимость кредитов каждого уровня — и указание этой модели в model — как ее получить, поскольку неназванный рендер маршрутизируется более узким автопулом.

Сырая игровая площадка моделей — полный каталог (30+ моделей изображений / видео / голоса / текста, каждая с точной стоимостью в кредитах за рендер) без рекламной подачи: generate_image / generate_video с useBrand:false, generate_voice, generate_text.

Публикация в собственные каналы — десять из них: Facebook, Instagram и Threads (post_to_meta), TikTok (post_to_tiktok), YouTube (post_to_youtube + update_youtube_video, youtube_video_insights, чтение/ответ на комментарии), X (post_to_x, x_post_metrics, x_post_insights, x_mentions, list_x_dms, send_x_dm), профиль LinkedIn и корпоративные страницы (post_to_linkedin, post_to_linkedin_page), Pinterest (post_to_pinterest + доски), Bluesky (post_to_bluesky, delete_bluesky_post, bluesky_post_metrics, а также list_bluesky_convos / read_bluesky_dm / send_bluesky_dm) и Telegram (post_to_telegram, delete_telegram_message, list_telegram_chats). schedule_post / list_scheduled / cancel_scheduled дают вам единый контент-календарь ровно по этому набору. upload_file подтягивает любые внешние или локальные медиа, не только рендеры Hermoso. Публикация в X списывает кредиты за каждый вызов API (X взимает плату за запрос); пост со ссылкой стоит в 13 раз дороже поста без неё. Придержано и названо, а не скрыто: Google Business Profile реализован (post_to_google_business, отзывы, Q&A, инсайты) и не предлагается — Google выдаёт доступ к этому API по заявке на каждый проект, а у нашего 0 QPM, так что каждый вызов возвращал бы 403 каждому пользователю. Он присутствует в перечислении каналов schedule_post и отклоняется при постановке в очередь.

Общение с клиентами в WhatsApp — это переписка, а не одиннадцатый канал публикации: вы пишете человеку, и ничто здесь не публикуется в ленту. list_whatsapp_accounts находит бизнес-аккаунт и его номера, list_whatsapp_templates / create_whatsapp_template / delete_whatsapp_template управляют шаблонами, которые проверяет Meta, а send_whatsapp_message отправляет сообщение — с подтверждением, потому что оно доходит до реального телефона и Meta выставляет счёт бизнесу за диалог. Два ограничения, которые являются постоянными фактами об API Meta, а не чем-то временным: Hermoso не получает вебхуки WhatsApp, поэтому истории сообщений для чтения нет — это не поверхность входящих, и list_inbox её не покрывает — и вне 24-часового окна, которое открывается с первого сообщения клиента, WhatsApp принимает только ОДОБРЕННЫЙ шаблон и ничего больше.

Запуск рекламы — полные деревья кампаний, создаваемые в статусе «пауза» и считываемые до любого отчёта, с подтверждением каждого изменения бюджета, на одиннадцати платформах: Meta, Google Ads, LinkedIn Ads, Reddit Ads, Pinterest Ads, Microsoft Advertising, ChatGPT Ads (рекламный API OpenAI), X Ads, TikTok Ads, Snapchat Ads и Apple Ads (Apple Search Ads в App Store). Для каждой есть инструменты списка + отчёта + создания + бюджета/статуса (например, list_google_ads_campaigns, google_ads_report, create_google_ads_campaign, set_google_ads_budget, set_google_ads_status). Snapchat требует один дополнительный шаг, которого нет у остальных: объявление указывает на CREATIVE, и каждый креатив Snapchat обязан нести Public Profile id — создайте его с помощью upload_snapchat_ads_creative.

Наполнение торговых поверхностей — Google Merchant Center — это каталог, который рекламирует розничная кампания Performance Max или Shopping (create_google_ads_performance_max_campaign принимает merchantCenterId), и вы управляете им отсюда: аккаунты и их статус, источники данных, добавление / обновление / удаление товаров, запасы по регионам, квота, merchant_report для аналитики по товарам, уведомления и источники конверсий, а также цикл отклонений — list_merchant_issues показывает, что не так, а merchant_issue_help возвращает задокументированное исправление от Google. Для акций требуется собственная регистрация продавца в программе акций Google; без неё Google outright отказывает этому субапи. Microsoft Merchant Center покрыт по той же схеме (магазины, каталоги, товары, проблемы) для Bing Shopping.

Измерение результатов рекламы — Google Analytics 4 замыкает цикл. Каждый другой коннектор здесь сообщает, сколько реклама стоила; этот сообщает, что она сделала. analytics_report разбивает сеансы, пользователей, конверсии и выручку по каналу, источнику/каналу, кампании, посадочной странице, стране, устройству или дате, так что кампания, которую построил Hermoso, и выручка, которую она принесла, оказываются в одном диалоге. analytics_realtime показывает, кто сейчас на сайте. Начните с list_analytics_properties — инструменты принимают числовой идентификатор свойства, а не Measurement ID вида G-XXXXXXXXX из вашего трекинг-фрагмента, и именно этот инструмент сопоставляет одно с другим. Он не только читает, но и пишет: create_analytics_key_event помечает событие, которое GA4 уже собирает, как ключевое — именно это делает его импортируемым в Google Ads как конверсию — а create_analytics_custom_dimension регистрирует параметр события, чтобы отчёты могли разбиваться по нему, при этом list_analytics_definitions показывает, что свойство уже измеряет. Он входит с тем же аккаунтом Google, что и Google Ads, YouTube и Drive, но это отдельное подключение. Только GA4 — в API нет поверхности Universal Analytics. Пользовательское измерение можно архивировать, но нельзя удалить, и в свойстве хранится 50 измерений уровня события.

Файлы — Google Drive CRUD (save_to_drive, list_drive_files, update_drive_file, delete_drive_file, create_drive_folder), Google Sheets (create_sheet, append_to_sheet, read_sheet), Google Docs (create_doc, append_to_doc) и OneDrive (save_to_onedrive + полный CRUD).

Рабочее пространство и аккаунт — брендовые рабочие пространства (list_brands, create_brand, use_brand, update_brand, delete_brand — один аккаунт вмещает много брендов, так что агентство ведёт через него каждого клиента), память (remember, forget, list_memory), пользовательские навыки (save_skill, get_skill, list_skills, delete_skill — единая библиотека, поглотившая старые AI-Employee персоны), команда (list_team, invite_member, remove_member, set_role), настройки (get_settings, update_settings — включая язык, на котором пишется каждое объявление, сценарий и план), коннекторы (list_connectors, list_connector_accounts, set_connector_accounts, disconnect_connector) и биллинг (hermoso_credits, billing_status, buy_credits, upgrade_plan, set_auto_reload), а также list_jobs / get_job для асинхронных рендеров.

Аккаунты коннекторов выбираются, а не угадываются. Один человек часто администрирует несколько страниц Facebook, клиентов Google Ads или корпоративных страниц LinkedIn. Использовать можно только те аккаунты, которые отмечены для бренда — это enforced на стороне сервера, и пустой выбор ничего не расшаривает. Подключение нового аккаунта — единственный шаг, который не является headless (это экран согласия OAuth, так что пользователь делает это в приложении).

Задания на рендер ставятся в очередь на сервере и опрашиваются до завершения, возвращая готовый URL.

2. CLI — экономный по токенам путь для терминальных агентов

bin/hermoso.mjs предоставляет полный набор инструментов MCP как подкоманды, так что агент может выполнять их через shell вместо того, чтобы таскать за собой громоздкий манифест инструментов.

npm install -g hermoso                             # installs `hermoso`
hermoso capabilities                               # valid model ids + costs (run first)
hermoso create --brand "YourBrand" --product "your best-selling product" --format image
hermoso generate image --prompt "…" --ref ./product.png --wait
hermoso generate video --prompt "…" --duration 8 --wait
hermoso competitors yourbrand.com
hermoso research "Liquid Death’s longest-running ads"

Добавьте --json к любой команде для машинного вывода.

Эти сокращения — обычный путь, а не предел. Каждый инструмент MCP-сервера доступен и здесь, включая группы рекламных кампаний и аналитики, которые коннектор не включает в свой стандартный набор:

hermoso tools                          # every tool, grouped, name + one line
hermoso tools --group ads --search reddit   # narrow it
hermoso tools create_meta_campaign     # that tool's full argument schema
hermoso call create_meta_campaign --json '{"name":"…"}'   # run it
hermoso create_meta_campaign --name "…"                   # same thing, shorter

call проходит через тот же обработчик, ту же проверку аргументов и те же шлюзы подтверждения/расходов, что и MCP-сервер — нет второй реализации, которая могла бы разойтись. tools и tools <name> читают реестр, встроенный в пакет, поэтому им не нужны ни ключ, ни сеть, ни вход в систему.

3. Навыки Claude — слэш-команды, оборачивающие CLI

В skills/ лежат четыре устанавливаемых навыка: hermoso-generate, hermoso-ad-from-brand, hermoso-product-photoshoot, hermoso-research.

cp -r skills/* ~/.claude/skills/

Затем вызовите /hermoso-ad-from-brand an ad for yourbrand.com — our hero product.

Конфигурация

mcp/http.mjs — это хостируемый транспорт удалённого коннектора (вставьте URL в Claude.ai → Connectors). Он поставляется в этом репозитории для прозрачности и отказывается монтироваться без аутентифицированной личности — никаких анонимных трат, никогда.

Лицензия

MIT © Hermoso