SkillFoxx
Telegram

MCP-плагин для сценариев BotHelp

bothelp-mcp

MCP-сервер и плагин Claude Code для чтения и правки графа сценариев BotHelp и рассылок через приватный WebSocket конструктора flow2

  • 0 ★ репозитория
  • Последний коммит
  • MIT
Плагин

Широкий доступ

Почему такой уровень

  • Правит живой граф сценария бота: блоки, переходы, раскладку
  • Создает, повторяет и отменяет рассылки подписчикам
  • Использует перехваченную сессию оператора через приватный недокументированный протокол
Все причины и проверки
Российский стек

skiddgoddamn/bothelp-mcpАвтор:skiddgoddamn

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add plugins/bothelp-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Правит живой граф сценария бота: блоки, переходы, раскладку
  • Создает, повторяет и отменяет рассылки подписчикам
  • Использует перехваченную сессию оператора через приватный недокументированный протокол

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает 25 инструментов поверх двух возможностей BotHelp, недоступных публичному Open API: правку графа сценария (блоки, переходы, раскладка канваса) и управление рассылками (создание, повтор с новым текстом или кнопками, отмена, удаление, черновик или отправка сейчас). Публичный Open API BotHelp только читает и запускает сценарии, а редактировать граф умеет лишь веб-конструктор flow2 через приватный недокументированный WebSocket-RPC на библиотеке Primus, и этот сервер это тонкая обертка над теми же методами. Авторизация идет не токеном Open API, а сессией оператора: либо логином и паролем напрямую (пароль нигде не сохраняется, в конфиг попадает только полученный sessionId), либо готовым sessionId, перехваченным из DevTools. Escape-hatch call позволяет вызвать любой метод конструктора напрямую.

Для кого. Для тех, кто строит и правит сценарии ботов BotHelp и хочет делать это из Claude Code, а не только руками в веб-конструкторе.

Подходит, если

  • Нужно менять граф сценария (блоки, переходы, раскладку) программно
  • Нужно запланировать, повторить с правками или отменить рассылку
  • Открыт тестовый бот, на котором можно безопасно проверять правки перед продакшеном

Не подходит, если

  • Хочется работать по официальному стабильному API, а не приватному протоколу, который может измениться без предупреждения
  • Нужен только просмотр статистики через Open API, для этого есть отдельный скилл этого же автора
  • Не готовы обкатывать правки на тестовом боте перед применением к живому сценарию

Пример запроса к агенту

Повтори последнюю рассылку broadcastId 42 с новым текстом и замени utm в ссылках, сначала покажи dry-run

Ограничения

Протокол приватный, недокументированный и неофициальный: сам автор предупреждает, что он может измениться без предупреждения, и советует проверять правки на тестовом боте, потому что add_block, delete_block и save_layout меняют живой сценарий. README прямо называет проект неофициальным клиентом, не аффилированным с BotHelp, и советует использовать его в рамках условий сервиса. Для полностью официального подхода с API-токеном вместо перехваченной сессии автор указывает альтернативу retensy-mcp.

Как отключить. Выполни /plugin uninstall bothelp-mcp в Claude Code или удали сервер bothelp-mcp из конфигурации MCP-клиента.

Частые вопросы

Почему нельзя просто использовать официальный Open API?

Open API BotHelp только читает и запускает сценарии, редактировать граф и управлять рассылками умеет лишь приватный WebSocket-RPC веб-конструктора flow2, который и оборачивает этот сервер.

Пароль передается и хранится где-то?

Нет, при входе через login_password пароль используется один раз для получения sessionId и в конфиг не попадает, сохраняется только сама сессия.

Обсуждение

Вопросов и отзывов пока нет.

ВКонтакте — все инструменты
Российский стек

Скилл Claude Code для BotHelp Open API: карта ботов, drop-off по шагам, экспорт подписчиков и точечное управление через открытый API

СкиллРасширенный доступ
Российский стек

MCP-сервер и скилл для сборки и публикации воронок ботов Telegram, MAX и Instagram в сервисе zaytsv /bots из текстового описания сценария

ПлагинШирокий доступ1

Telegram API MCP

telegram-api-mcp

Российский стек

MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram

MCP-серверШирокий доступ34
Официальный

Официальный MCP-сервер и скилл Retensy для сборки и публикации воронок ботов Telegram, MAX и Instagram из текстового описания, с интеграциями amoCRM и Битрикс24

ПлагинШирокий доступ
Российский стек

MCP-сервер публикует один текст сразу в Telegram, ВКонтакте (группа и личная стена) и TenChat одним вызовом publish_all

MCP-серверШирокий доступ
Российский стек

MCP-сервер для чтения сообщений бота в мессенджере Max: чаты, участники, поиск по тексту и скачивание вложений

MCP-серверРасширенный доступ1

Коротко о README

README подробно объясняет, почему сервер использует WebSocket, а не Open API: публичный REST только читает и запускает, а править граф умеет лишь конструктор flow2 через приватный протокол Primus. Перечислены 25 инструментов по сценариям и рассылкам, два способа авторизации сессией вместо токена, установка плагином или обычным MCP через npx, escape-hatch call на любой метод и явное предупреждение о неофициальном статусе с советом тестировать на тестовом боте и ссылкой на официальную альтернативу retensy-mcp.

Бейдж для README

Сообщить о проблеме