tgAtlas

Canales públicos de Telegram a través de HTTP: perfiles, publicaciones, comentarios, recomendaciones.

Documentación

tgatlas-mcp

Servidor MCP para canales públicos de Telegram. Le da a un agente el perfil real de un canal —suscriptores, descripción, fecha de creación, indicadores de verificación y estafa, frecuencia de publicación— y los canales que el propio Telegram considera similares.

Sin número de teléfono, sin archivo de sesión, sin cliente MTProto que mantener activo. Una clave de API y un runtime de Node.

Instalación

npx tgatlas-mcp

Claude Desktop / Claude Code / cualquier cliente MCP:

{
  "mcpServers": {
    "tgatlas": {
      "command": "npx",
      "args": ["-y", "tgatlas-mcp"],
      "env": { "TELEGRAM_API_KEY": "your-rapidapi-key" }
    }
  }
}

Obtén una clave en rapidapi.com/starnikovoleg/api/telegram155. Hay un plan gratuito y no requiere tarjeta.

Herramientas

telegram_channel

El perfil de un canal: título, descripción, número exacto de suscriptores, fecha de creación, indicadores de verificación y estafa de Telegram, y cadencia de publicación.

La cadencia es la parte que la mayoría de los directorios omiten, y suele ser la respuesta a la pregunta que se está haciendo. Un canal con 200,000 suscriptores y sin publicaciones en catorce meses se ve idéntico a uno activo en cualquier listado que solo reporta conteos de seguidores.

@durov — Du rov's Channel
Subscribers   1,400,000
Created       2017-02-15
Last post     2026-08-29
Posting rate  0.4 posts/day over the last 30

telegram_similar_channels

Los canales que Telegram recomienda junto a uno dado —su propio juicio temático en lugar de una coincidencia de palabras clave—, por lo que devuelve canales que comparten audiencia sin compartir vocabulario.

Así es como encuentras canales cuyos nombres aún no conoces: empieza por uno que sí conozcas y expande hacia afuera. Dos rondas de expansión desde unas pocas docenas de semillas alcanzan varios miles de canales.

Establece enrich: true para obtener conteos exactos de suscriptores de cada resultado.

telegram_search_channels

La búsqueda global de Telegram sobre canales y grupos públicos. Úsala para encontrar un punto de partida; usa telegram_similar_channels para expandirlo.

Salida

Markdown por defecto —lo que un modelo lee sin necesidad de un paso de análisis. Pasa format: "json" para la respuesta cruda de la API cuando estés conectando con código.

Alcance

Solo metadatos de canales públicos. Contenidos de mensajes, listas de miembros y grupos privados están fuera de lo que esto lee y fuera de lo que devolverá.

Costo

Las herramientas llaman a los endpoints REST directamente en lugar de hacer proxy a un endpoint MCP remoto. RapidAPI factura por solicitud, por lo que este arreglo significa que initialize y tools/list son gratuitos: pagas por búsquedas, no por conexiones.

telegram_channel cuesta tres llamadas con cadencia activada, dos con cadence: false. telegram_similar_channels cuesta dos, más una por resultado cuando enrich: true (máximo 12).

Entorno

VariablePredeterminadoPropósito
TELEGRAM_API_KEYClave de RapidAPI. RAPIDAPI_KEY también funciona.
TELEGRAM_API_HOSTtelegram155.p.rapidapi.comHost upstream.
TELEGRAM_TIMEOUT_MS30000Tiempo de espera por solicitud.

Relacionado

TgAtlas publica un corpus medido semanalmente construido sobre la misma API: directorios de canales por tema, el grafo de recomendaciones invertido en "quién recomienda este canal", y cómo se mueven esos números semana a semana.

MIT.