telegram-ads

Plugin de agente para ads.telegram.org: herramientas tipadas, inicio de sesión con Playwright, watcher de solo lectura.

Dale a tu agente la URL de Git. Se instala solo. No alojas un servidor MCP.

MCP es local

El punto de entrada MCP es un proceso hijo stdio que el agente inicia:

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

Sin puerto público, sin demonio VPS, sin URL que mantener viva. Chromium se ejecuta en la misma máquina que el agente. Misma regla que Playwright MCP.

Related MCP server: telegram-user-mcp

Instalación

Agente Hermes

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

Después sigue after-install.md (venv pip, playwright install chromium, TELEGRAM_ADS_PHONE, reinicio de gateway, telegram_ads_login_from_env + Aceptar en Telegram).

Concede la inyección del watcher para que el watcher de solo lectura pueda despertar un chat:

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

Configura TELEGRAM_ADS_PHONE en el entorno. La primera llamada de mutación usa el propio prompt de permisos de Claude Code (las tarjetas Once/Session/Always de Hermes solo existen en Hermes).

Otros agentes MCP (Cursor, …)

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

Apunta al agente a este checkout:

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

Primer inicio de sesión (en cualquier host)

1. TELEGRAM_ADS_PHONE en el entorno del host (nunca en git).

2. Llama a telegram_ads_login_from_env.

3. Toca Aceptar en la aplicación de Telegram.

4. Las cookies permanecen en el perfil persistente de Chromium (TELEGRAM_ADS_HOME, o ~/.hermes/data/telegram_ads si Hermes está presente, si no ~/.telegram-ads).

Seguridad

• Las mutaciones requieren aprobación del host (Hermes Once/Session/Always/Deny, o la UI de permisos del cliente MCP). No confirmes escribiendo "sí".

• El watcher es de solo lectura. No inicies un segundo Playwright en el mismo perfil de Ads.

• No inicies un segundo poller de getUpdates de Telegram. Este plugin reutiliza el bot del host.

• No vincules hermes serve / MCP HTTP en 0.0.0.0.

Lo que no está en este plugin

Investigación de Telegram (Telethon), identidad de GrokBot, cartera de canales, /sessions. Esos permanecen en el host del operador.

Licencia

MIT