tgatlas

tgatlas-mcp

公開 Telegram チャンネル向けの MCP サーバーです。チャンネルの実際のプロフィール（登録者数、説明、作成日、認証済みかどうかや詐欺のフラグ、投稿頻度）と、Telegram 自身が類似していると判断したチャンネルをエージェントに提供します。

電話番号もセッションファイルも、起動したままにしておく MTProto クライアントも必要ありません。必要なのは API キーと Node ランタイムだけです。

インストール

npx tgatlas-mcp

Claude Desktop／Claude Code／その他の MCP クライアント：

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

rapidapi.com/starnikovoleg/api/telegram155 でキーを取得してください。無料プランがあり、カードは不要です。

ツール

telegram_channel

チャンネルのプロフィール（タイトル、説明、正確な登録者数、作成日、Telegram 独自の認証済み・詐欺のフラグ、投稿頻度）を取得します。

多くのディレクトリにはない投稿頻度が、たいてい知りたいことへの答えになります。登録者数が20万人でも、14か月間投稿がないチャンネルは、フォロワー数だけを表示する一覧では、現在も活動中のチャンネルと見分けがつきません。

@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

Telegram が指定したチャンネルと並べておすすめするチャンネルを取得します。キーワードの一致ではなく、Telegram 独自のトピック判断に基づくため、語彙は共通していなくても、同じオーディエンスを持つチャンネルが返されます。

まだ名前を知らないチャンネルを見つける方法です。知っているチャンネルから始め、外へたどっていきます。数十件のシードから2段階展開すると、数千件のチャンネルに到達できます。

enrich: true に設定すると、各結果の正確な登録者数を取得します。

telegram_search_channels

公開チャンネルとグループを対象とした、Telegram のグローバル検索です。出発点を見つけるにはこれを使い、範囲を広げるには telegram_similar_channels を使ってください。

出力

デフォルトでは Markdown です。モデルが解析処理なしで読み取れます。コードにパイプ入力する場合は、format: "json" を指定すると API の生レスポンスを取得できます。

対象範囲

公開チャンネルのメタデータのみです。メッセージの内容、メンバーリスト、非公開グループは読み取り対象外であり、返されることもありません。

コスト

ツールはリモート MCP エンドポイントをプロキシせず、REST エンドポイントを直接呼び出します。RapidAPI はリクエストごとに課金するため、この構成では initialize と tools/list は無料です。課金されるのはルックアップに対してであり、ハンドシェイクではありません。

telegram_channel は投稿頻度を有効にすると3回、cadence: false の場合は2回呼び出します。telegram_similar_channels は2回呼び出し、さらに enrich: true の場合は結果ごとに1回呼び出します（最大12件）。

環境変数

変数	デフォルト	用途
TELEGRAM_API_KEY	—	RapidAPI キーです。RAPIDAPI_KEY も使用できます。
TELEGRAM_API_HOST	telegram155.p.rapidapi.com	アップストリームのホストです。
TELEGRAM_TIMEOUT_MS	30000	リクエストごとのタイムアウトです。

関連情報

TgAtlas では、同じ API を基に毎週計測したコーパスを公開しています。トピック別のチャンネルディレクトリ、おすすめグラフを逆引きした「このチャンネルをおすすめしているのは誰か」、およびその数値の週ごとの推移を提供しています。

MIT。