Hermoso это маркетинговый MCP-сервер: 922+ инструмента через одну точку доступа с OAuth, которые позволяют агенту исследовать рекламу, уже идущую на рынке, создавать готовые изображения и видео, публиковать их и строить платные кампании за ними. Claude Code получает всё это через одно подключение. Эта страница описывает один срез: что Claude Code реально может делать в Telegram и что Telegram ему не позволит.
Подключите Hermoso к Claude Code
- Одна команда, и ключ не нужен.
Уже внутри сессии? Введитеclaude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/plugin marketplace add hermoso-ai/hermoso, затем/plugin install hermoso@hermoso. Устанавливаются пять навыков Hermoso (research, ad-from-brand, generate, product-photoshoot и marketing), которые запускают командуhermosoчерезnpx, поэтому список инструментов не загружается в ваши сессии, и ничего не тратит контекст, пока не запущено. - Войдите один раз.
Открывается вход в браузере через loopback, как уnpx -y hermoso auth logingh, и сохраняется учётные данные, доступные только владельцу, в~/.hermoso/config.json. Claude Code выполняет это за вас при первом обращении к Hermoso. Нет браузера на этой машине, например в CI, на удалённом сервере или в контейнере? Создайте ключ в MCP & CLI → Terminal & API keys и выполнитеnpx -y hermoso auth login --token hmk_…. Ключ даёт реальное право тратить деньги, поэтому относитесь к нему как к паролю. - Необязательно: MCP-сервер тоже. Если вы хотите, чтобы инструменты Hermoso были и в собственном списке инструментов Claude Code, выполните
claude mcp add hermoso -- npx -y hermoso mcpпосле входа. Он читает то же сохранённое учётные данные, поэтому ключ не попадает в.claude.json. Навыкам без него доступны все инструменты. - Попросите Claude Code о чём-нибудь. «Найди самые долго работающие объявления трёх главных конкурентов и переделай лучший хук в видео 9:16» или «опубликуй этот рендер в канале». Агент выбирает инструменты; расходы подтверждаете вы.
Плагин и необязательный MCP-сервер работают с теми же инструментами и тем же аккаунтом. Разница в контексте: список инструментов загружается в каждую сессию ещё до того, как вы что-то напечатаете, а навыки ничего не стоят, пока не запущена команда.
Затем подключите сам Telegram один раз: Настройки → Коннекторы в Hermoso, вставив токен бота из @BotFather, и добавьте этого бота в канал администратором. Экрана согласия нет: токен и есть учётные данные, а бот тот, кто публикует.
Инструменты Telegram, которые получает Claude Code
post_to_telegram: отправляет сообщение от имени вашего бота в чат, который вы назовёте: текст до 4 096 символов, одно фото, одно видео или альбом из 2 до 10 элементов с фото и видео вперемешку.schedule_post: ставит пост в очередь с егоchatIdв тот же календарь, что и остальные каналы.list_telegram_chats: чаты, которые писали боту за последние 24 часа. Помогает найти id, но это не список всех чатов, где состоит бот.edit_telegram_message / pin_telegram_message: исправляет текст или подпись сообщения без потери просмотров, закрепляет или открепляет призыв к действию.create_telegram_invite_link: именованная ссылка-приглашение для каждой кампании с необязательным сроком действия, лимитом участников или подтверждением вступления, чтобы видеть, кто пришёл откуда.telegram_account: число подписчиков или участников чата, название, описание и ссылка-приглашение.list_telegram_dms: сообщения, которые люди отправили боту за последние 24 часа, от новых к старым, чтобы ответить черезpost_to_telegram.delete_telegram_message: удаляет сообщение, отправленное ботом, в пределах 48-часового окна Telegram, после шага подтверждения.
Telegram подключается токеном бота, а не экраном входа. Создайте бота через @BotFather в Telegram, вставьте токен в Настройки → Коннекторы, затем добавьте бота в свой канал администратором с правом «Post Messages» или в группу участником, который может писать. Hermoso публикует от имени этого бота, никогда от вашего. Два ограничения принадлежат Telegram и стоит учитывать при планировании: у бота нет просмотров по отдельным постам и нет истории постов, поэтому числа подписчиков и именованные ссылки-приглашения это все доступные цифры; сообщения, отправленные боту, хранятся 24 часа, потом исчезают. Публикация не стоит кредитов.
Лимиты Telegram, которые стоит знать до автоматизации
| Текст | Сообщение в Telegram может содержать 4 096 символов, но только 1 024, если прикреплено фото или видео, потому что текст становится подписью. Проверка выполняется при создании или постановке в очередь, поэтому слишком длинный пост отклоняется, пока вы ещё рядом, а не обрезается тихо по пути. |
|---|---|
| Видимость | Отправлено или не отправлено, без формы черновика, непубличной или приватной. Кто видит, решает чат: «опубликуйте в приватную группу или канал, и увидят только её участники». silent доставляет сообщение без звукового уведомления и ничего не меняет в том, кто может его видеть. |
| Карусель | От 2 до 10 элементов как альбом, и фото с видео можно смешивать. Оба предела собственные пределы Telegram из sendMediaGroup Bot API («должен включать 2 до 10 элементов»), и смешивание тоже оттуда. Альбом показывает одну подпись, на первом элементе. Hermoso загружает файлы, а не передаёт ссылки, поэтому лимиты Telegram поднимаются до 10 МБ на фото и 50 МБ на видео. |
| Какой аккаунт | chatId, обязателен в каждом посте: @username публичного канала или числовой id (у супергруппы или канала он начинается с -100). У Bot API нет метода, который перечисляет чаты, где состоит бот, поэтому Hermoso их не знает и никогда не угадывает. |
Попробуйте в Claude Code
Просите обычным языком. Это простые фразы, а не DSL:
«Отправьте четыре изображения из ./out/launch одним альбомом в Telegram, в чат -1001234567890, с подписью из ./copy/tg.txt, и запишите id сообщения.»
Это проходит по цепочке render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Claude Code спрашивает перед запуском инструмента, а расшифровка всё время видна в терминале, так что шаг публикации можно прочитать до того, как нажмёте y.
Claude Code в Telegram: то, что кусается
Действуют два лимита текста, и когда прикреплено медиа, срабатывает более строгий: 4,096 символов для текстового сообщения и 1,024 для подписи, а альбом показывает одну подпись, у первого элемента. Hermoso загружает файлы, а не передаёт Telegram ссылку, и это поднимает ограничения до 10MB на фото и 50MB на видео. Сохраняйте id сообщения. Без него не работают ни редактирование, ни удаление, а Telegram не даёт боту способа найти его позже.
У плагина нет манифеста инструментов, что важнее всего в длинном автономном запуске: агент вызывает команду hermoso на каждом шаге, а --json у любой команды даёт машинный вывод для проверки.
Исследуйте Telegram перед публикацией
В Hermoso нет рекламной библиотеки Telegram и поиска по каналам, поэтому исследование конкурентов в Telegram не заявляется. Изучайте креатив там, где он публичен (рекламные библиотеки Meta, Google и LinkedIn, а также органические TikTok, Instagram, YouTube, Reddit и Threads), и публикуйте готовое объявление здесь.
Платная часть
В Hermoso нет рекламы в Telegram, и мы этого не подразумеваем. Telegram здесь канал, которым вы владеете и управляете через своего бота: публикация, закрепление, редактирование, подсчёт подписчиков и отслеживание приглашений. Платные инструменты покрывают Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads и AppLovin Ads.
Что Claude Code не может сделать сам
Агент с бюджетом полезен только тогда, когда радиус поражения ограничен, поэтому ограждение стоит в сервере, а не в промпте. Каждая рекламная кампания, группа объявлений, группа и объявление создаются на паузе, а переключения статуса, которые запускают реальные деньги, не выполняются без явного флага подтверждения. Каждый рендер сначала оценивается (hermoso_capabilities публикует точную стоимость каждой модели в кредитах до того, как что-либо тратится). Кредиты резервируются до первого вызова провайдера и списываются по точной стоимости после, поэтому сбойный запуск возвращает кредиты, а не оставляет вас с платой за ничего. Удаления тоже требуют подтверждения, а каждое дерево кампании перечитывается из рекламной платформы, прежде чем ваш агент расскажет, что он построил.
Один шаг намеренно остаётся за вами: создание бота через @BotFather и добавление его в ваш канал. Всё после этого это вызовы инструментов.
Остальная матрица
Из Claude Code публикуйте в: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Или см. всё, куда Claude Code может публиковать.
Публикация в Telegram из: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Маркетинг в Claude Code
Часто задаваемые вопросы
Может ли Claude Code публиковать в Telegram?
Да, с плагином Hermoso для Claude Code. Одна команда: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, или внутри сессии /plugin marketplace add hermoso-ai/hermoso, затем /plugin install hermoso@hermoso. Устанавливаются пять навыков Hermoso, которые управляют CLI hermoso, поэтому список инструментов не загружается в сессии. Войдите один раз командой npx -y hermoso auth login: она открывает браузер и сохраняет учётные данные сама, так что ключ создавать и вставлять не нужно. Затем у Claude Code есть более 922 инструментов, включая публикацию в Telegram, а также инструменты, которые исследуют объявления, уже идущие на вашем рынке, и рендерят сам креатив.
Как подключить Telegram к Claude Code?
Два шага, каждый по одному разу. Одна команда: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, или внутри сессии /plugin marketplace add hermoso-ai/hermoso, затем /plugin install hermoso@hermoso. Устанавливаются пять навыков Hermoso, которые управляют командой hermoso CLI, поэтому список инструментов не загружается в ваши сессии. Войдите один раз командой npx -y hermoso auth login: откроется браузер, и учётные данные сохранятся сами, так что ключ создавать и вставлять не нужно. Затем создайте бота через @BotFather в Telegram, вставьте его токен в Настройки → Коннекторы в Hermoso и добавьте бота в канал администратором с правом «Публикация сообщений». После этого Claude Code публикует в Telegram как обычный вызов инструмента, каждый раз указывая чат.
Нужен ли Claude Code мой пароль от Telegram?
Нет. Telegram подключается через бота, которого вы создаёте в @BotFather, и Hermoso хранит только токен этого бота, поэтому Claude Code публикует от имени бота, а не от вашего личного аккаунта Telegram. Токен можно отозвать в @BotFather в любой момент, и он никогда не передаётся модели.
Может ли Claude Code запланировать пост в Telegram на потом?
Да. schedule_post ставит его в один календарь, общий со всеми остальными каналами, с подписью под каждый канал, если текст должен отличаться; list_scheduled и cancel_scheduled читают его и отзывают. Telegram один из одиннадцати каналов, которые ставятся в очередь.
Может ли Claude Code опубликовать карусель в Telegram?
Да, как альбом из 2 до 10 элементов с фото и видео вперемешку: это правило sendMediaGroup в Telegram. Альбом несёт одну подпись, на первом элементе. Claude Code вызывает тот же инструмент публикации в любом случае, а канал, который не может нести карусель, отклоняется с настоящей причиной.
Сколько стоит публикация в Telegram из Claude Code?
Публикация в Telegram не стоит кредитов: Telegram не берёт плату за вызов. Кредиты тратятся на генерацию креатива. Тарифы: $29, $69 и $149 в месяц за 1 200, 3 000 и 7 000 кредитов, и каждая функция доступна на любом тарифе, включая Бесплатный. Исключение: корпоративный SSO.
Начните бесплатно: 30 кредитов при регистрации и ещё 250+ можно заработать. Все функции доступны на каждом плане.
Начать бесплатно → Посмотреть цены