tgAtlas

tgatlas-mcp

Servidor MCP para canais públicos do Telegram. Dá a um agente o perfil real de um canal — inscritos, descrição, data de criação, flags de verificação e golpe, frequência de postagens — e os canais que o próprio Telegram considera semelhantes a ele.

Sem número de telefone, sem arquivo de sessão, sem cliente MTProto para manter ativo. Uma chave de API e um runtime Node.

Instalação

npx tgatlas-mcp

Claude Desktop / Claude Code / qualquer cliente MCP:

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

Obtenha uma chave em rapidapi.com/starnikovoleg/api/telegram155. Há um plano gratuito e sem cartão de crédito.

Ferramentas

telegram_channel

O perfil de um canal: título, descrição, contagem exata de inscritos, data de criação, flags de verificação e golpe do próprio Telegram e cadência de postagens.

A cadência é a parte que a maioria dos diretórios omite, e geralmente é a resposta para a pergunta que está sendo feita. Um canal com 200.000 inscritos e nada publicado em catorze meses parece idêntico a um ativo em qualquer listagem que reporte apenas contagens 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

Os canais que o Telegram recomenda junto a um determinado canal — seu próprio julgamento temático em vez de uma correspondência por palavras-chave, então retorna canais que compartilham um público sem compartilhar vocabulário.

É assim que você encontra canais cujos nomes você ainda não conhece: comece de um que você conhece e expanda. Duas rodadas de expansão a partir de algumas dezenas de sementes alcançam vários milhares de canais.

Defina enrich: true para buscar contagens exatas de inscritos para cada resultado.

telegram_search_channels

A busca global do Telegram em canais e grupos públicos. Use-a para encontrar um ponto de partida; use telegram_similar_channels para expandi-lo.

Saída

Markdown por padrão — o que um modelo lê sem etapa de parsing. Passe format: "json" para a resposta bruta da API quando estiver canalizando para código.

Escopo

Apenas metadados de canais públicos. Conteúdo de mensagens, listas de membros e grupos privados estão fora do que isso lê e fora do que retornará.

Custo

As ferramentas chamam os endpoints REST diretamente em vez de fazer proxy de um endpoint MCP remoto. A RapidAPI cobra por requisição, então esse arranjo significa que initialize e tools/list são gratuitos: você paga por consultas, não por handshakes.

telegram_channel custa três chamadas com cadência ativada, duas com cadence: false. telegram_similar_channels custa duas, mais uma por resultado quando enrich: true (limitado a 12).

Ambiente

Variável	Padrão	Finalidade
TELEGRAM_API_KEY	—	Chave da RapidAPI. RAPIDAPI_KEY também funciona.
TELEGRAM_API_HOST	telegram155.p.rapidapi.com	Host upstream.
TELEGRAM_TIMEOUT_MS	30000	Timeout por requisição.

Relacionados

TgAtlas publica um corpus medido semanalmente construído na mesma API: diretórios de canais por tópico, o grafo de recomendações invertido em "quem recomenda este canal" e como esses números se movem semana a semana.

MIT.