telegram-ads

Плагин агента для ads.telegram.org: типизированные инструменты, вход через Playwright, watcher только для чтения.

Дайте агенту git-URL. Он установится сам. Вам не нужно размещать MCP-сервер.

MCP работает локально

Точка входа MCP — это дочерний процесс stdio, который запускает агент:

agent  --stdin/stdout JSON-RPC-->  python -m hermes_telegram_ads.mcp

Никакого публичного порта, никакого VPS-демона, никакого URL для поддержания жизни. Chromium работает на той же машине, что и агент. То же правило, что и в Playwright MCP.

Related MCP server: telegram-user-mcp

Установка

Hermes Agent

hermes plugins install https://github.com/sh0tn1k/telegram-ads.git --enable

Затем следуйте after-install.md (venv pip, playwright install chromium, TELEGRAM_ADS_PHONE, перезапуск шлюза, telegram_ads_login_from_env + Accept в Telegram).

Предоставьте watcher inject, чтобы watcher только для чтения мог разбудить чат:

plugins:
  entries:
    telegram-ads:
      allow_gateway_injection: true

Claude Code

/plugin marketplace add https://github.com/sh0tn1k/telegram-ads.git
/plugin install telegram-ads@telegram-ads

Установите TELEGRAM_ADS_PHONE в окружении. Первый изменяющий вызов использует собственный запрос разрешений Claude Code (карточки Hermes Once/Session/Always существуют только в Hermes).

Другие MCP-агенты (Cursor, …)

pip install -e '.[mcp]'
python -m playwright install chromium

Укажите агенту на этот checkout:

{
  "mcpServers": {
    "telegram-ads": {
      "command": "python",
      "args": ["-m", "hermes_telegram_ads.mcp"]
    }
  }
}

Первый вход (на каждом хосте)

1. TELEGRAM_ADS_PHONE в окружении хоста (никогда в git).

2. Вызовите telegram_ads_login_from_env.

3. Нажмите Accept в приложении Telegram.

4. Cookies остаются в постоянном профиле Chromium (TELEGRAM_ADS_HOME, или ~/.hermes/data/telegram_ads, если присутствует Hermes, иначе ~/.telegram-ads).

Безопасность

• Изменения требуют одобрения хоста (Hermes Once/Session/Always/Deny, или UI разрешений MCP-клиента). Не подтверждайте вводом «yes».

• Watcher только для чтения. Не запускайте второй Playwright на том же профиле Ads.

• Не запускайте второй поллер Telegram getUpdates. Этот плагин переиспользует бота хоста.

• Не привязывайте hermes serve / MCP HTTP к 0.0.0.0.

Не входит в этот плагин

Telegram-исследования (Telethon), идентичность GrokBot, портфель каналов, /sessions. Они остаются на хосте оператора.

Лицензия

MIT