tgden — Telegram catalog & search

TGDen Telegram ツール — 無料のスクレイパー、検索、エクスポート

Telegram ツールをローカルで実行することも、公開 GitHub Actions ワークフローで実行することもできます。JSON と CSV にエクスポートできます。Apify アカウント、Telegram アカウント、ボットトークン、API キーは不要です。

Python ファイルをダウンロード · GitHub で実行 · 無料ツールガイド · По-русски · API と MCP

無料ツール

ツール	得られるもの	ソース
channel-posts	チャンネルの現在の公開ウェブプレビューで表示される投稿	Telegram の HTML を直接取得
groups	キーワードに一致する公開グループ	TGDen 公開カタログ
channels	キーワードに一致する公開チャンネル	TGDen 公開カタログ
bots	タスクまたはキーワードに一致するボット	TGDen 公開カタログ
lookup	公開ユーザー名のカタログ完全一致	TGDen 公開カタログ
classifieds	賃貸、販売、求人、サービスの掲載情報メタデータ	TGDen 公開マーケットプレイス
buyer-preview	分類済みの購入希望リクエストをマスキングした小規模サンプル	TGDen 公開プレビュー、最大 10 件
post-search	取得済みの公開チャンネル投稿から一致するスニペット	TGDen 公開投稿インデックス

git clone https://github.com/JustJuice55/tgden-api.git
cd tgden-api
python3 -m tgden_tools groups --query python --limit 10 --output output
python3 -m tgden_tools channel-posts --username telegram --limit 5 --output posts

Python 3.10 以降と標準ライブラリがあれば十分です。結果は出力ディレクトリの result.json、result.csv、metadata.json に書き込まれます。

GitHub のウェブサイトから実行するには、この公開リポジトリをフォーク → Actions を有効化 → Run a free Telegram tool を選択 → ツールを選択 → Run workflow → 結果のアーティファクトをダウンロードします。この方法では GitHub へのログインが必要ですが、ローカルコマンドには必要ありません。

これらは明確な制限のある無料の公開データツールです。カタログ検索はキーワードベースで、購入希望者検索はマスキングされたプレビューです。パートナー専用の全文セマンティック検索、プライベートチャットへのアクセス、チャンネル履歴の完全取得は、この無料バンドルの対象外です。制限と使用例をご覧ください。

公開カタログ API とホスト型 MCP

Telegram 上に存在するものの最新インデックス：チャンネル 120 万件以上、グループチャット 24 万 5 千件以上、ボット 16 万件以上、インデックス済み投稿 490 万件以上。 Telegram アカウント不要。API キー不要。インストール不要。CORS が有効なため、サーバーと同じようにブラウザーのタブからも実行できます。

• MCP エンドポイント — https://tgden.com/api/mcp
• REST API — https://tgden.com/api/catalog
• ユーザー向け UI — tgden.com · ドキュメント — tgden.com/en/api-docs

---

Telegram コミュニティリストを管理する

Telegram Link Checker & Community Directory は、HTTP 200 以外の公開プレビュー情報も確認し、定期的に更新される小規模なグループディレクトリを備えています。Python CLI または再利用可能な GitHub Action を使って、コミュニティ、ボット、一般的な連絡先、判定不能なプレビューを区別できます。Telegram アカウントや API キーは不要です。

なぜ別の Telegram MCP サーバーが必要なのか？

ほかの Telegram MCP サーバーはすべて、あなたの Telegram アカウントに接続します。API ハッシュ、電話番号、またはボットトークンを渡すと、あなたのダイアログを読み、あなたのメッセージを送信し、 あなたのグループを管理します。便利ですが、アクセス権のあるものしか見ることができません。

これはその逆です。公開カタログなので、ほかのサーバーには答えられない次の質問に答えます。

「X に関する Telegram のチャンネルやグループには何があり、参加する価値があるのはどれですか？」

	アカウントベースの Telegram MCP	tgden MCP
必要な認証情報	API ID／ハッシュ、電話番号、またはボットトークン	なし
インストール	ローカルプロセス（Python／Go／Node）	不要 — ホストされた HTTP URL
閲覧できるもの	すでに参加しているチャット	まだ参加していない 160 万以上の公開エンティティ
*「何があるか？」*に答える	いいえ	はい
アカウント上で操作できる	はい	いいえ — 設計上、読み取り専用

アカウントに一切触れないため、漏えいするものも、アカウントが停止される心配もありません。

---

クイックスタート

Claude Code

claude mcp add --transport http tgden https://tgden.com/api/mcp

公式 MCP Registry に io.github.JustJuice55/telegram-catalog として登録されており、レジストリを参照するクライアントでは telegram の下に表示されます。

Claude Desktop · Cursor · 任意の MCP クライアント — MCP 設定に追加します。

{
  "mcpServers": {
    "tgden": {
      "type": "http",
      "url": "https://tgden.com/api/mcp"
    }
  }
}

設定はこれだけです。ストリーミング可能な HTTP トランスポート、ステートレス、認証ハンドシェイク不要です。

手動で確認するには：

curl -s https://tgden.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq '.result.tools[].name'

ツール

ツール	何を調べられるか
search_telegram	チャンネル、グループチャット、ボットを全文検索します。登録者数／メンバー数、カテゴリ、信頼スコアも確認できます。
best_channels_by_category	*「暗号資産／AI／ニュース／ゲームなどのおすすめ Telegram チャンネル」*を登録者数順に表示します。
channel_stats	@username を指定して、1 つのチャンネルについて判明しているすべての情報を取得します。
search_posts	最近の投稿を全文検索します。チャンネルの自己紹介だけでなく、実際に発信された内容を確認できます。
market_listings	🇦🇪 🇹🇷 🇹🇭 🇻🇳 🇬🇪 🇺🇸 の地域別 Telegram グループから解析した、実際のクラシファイド広告（賃貸、売買、サービス、求人）を取得します。
market_stats	国別および種類別の掲載件数を表示します。

リソース

URI	内容
tgden://catalog/top-channels	登録者数上位 100 件のチャンネル。
tgden://catalog/categories	チャンネル数を含むカテゴリ分類全体。
tgden://market/listings-latest	最新のマーケットプレイス掲載情報 100 件。
tgden://market/stats	国別および種類別のマーケットプレイス掲載件数。

---

無料の REST API（こちらもキー不要）

Telegram には公式の公開検索機能がありません。トピックからチャンネル、活発なディスカッショングループ、またはボットを見つけるには、ユーザー名を推測するか、非公開のディレクトリを頼る必要があります。MCP を使わない場合でも、同じカタログを通常の HTTP で利用できます。

GET /api/catalog — 検索

パラメーター	型	デフォルト	備考
q	string	—	フリーテキスト検索（タイトル、ユーザー名、トピック）
limit	int	20	返す結果の最大数
type	string	all	channel · chat · bot（すべてを対象にする場合は省略）

curl "https://tgden.com/api/catalog?q=crypto&type=channel&limit=3"

{
  "items": [
    {
      "id": "6ec0407a-4f5e-4a86-9154-f42481bc9413",
      "telegram_id": 2075341442,
      "username": "hamster_kombat",
      "title": "Hamster Kombat Announcement",
      "is_private": false,
      "avatar_url": "https://cdn4.telesco.pe/file/…"
    }
  ]
}

ブラウザーから呼び出す

読み取り専用の両エンドポイントには Access-Control-Allow-Origin: * が設定されているため、プロキシは不要です。任意のページの開発者ツールのコンソール（または CodePen）に貼り付けるだけで、結果が返されます。

const r = await fetch("https://tgden.com/api/catalog?q=crypto&type=channel&limit=3");
console.table((await r.json()).items);

レート制限は共有され、公平利用を前提としています（IP あたり約 10 秒間に 200 リクエスト）。キーも登録も不要で、CORS プロキシも Access-Control-Allow-Credentials も不要です。あなたの情報が送信されることはありません。

GET /api/suggest — すばやいオートコンプリート

入力中に、グループ化・ランク付けされた候補を表示します。検索ボックスやエージェントのツール利用に適しています。

curl "https://tgden.com/api/suggest?q=btc"

{
  "groups": [
    {
      "key": "chats",
      "label": { "en": "live chats", "ru": "живые чаты" },
      "items": [
        { "label": "BTC Times Discussion", "sub": "221 members",
          "href": "/en/chat/thebtctimes", "kind": "chat", "username": "thebtctimes" }
      ]
    }
  ]
}

実行可能なサンプル：shell · Python · JavaScript。

---

制限 — 低い制限より非公開の制限のほうが問題なので、公表しています

対象	制限
REST（/api/catalog、/api/suggest）	IP あたり約 10 秒間に 200 リクエスト、共有のフェアユース制限
MCP（/api/mcp）	IP あたり 1 時間に 240 回
認証	なし — キー、登録、メールアドレスは不要
費用	無料

検証済みの検索エンジンおよび AI クローラーは、共有制限の対象外です。

これらの制限は契約として扱います。変更時は、ここおよびドキュメントでお知らせします。予告なしにスロットリングすることはありません。 実際の用途で、スループットの保証や一括エクスポートが必要ですか？ イシューを作成するか、@tgden_bot までご連絡ください。

---

データについて

Telegram の公開情報を継続的に解析しています — MCP 経由で公開している最大の理由のひとつは、どの LLM のトレーニングデータよりも新鮮なことです。

チャンネル	1,298,868
グループチャット	282,719
ボット	157,909
インデックス済み投稿	4,955,162
マーケットプレイスの掲載情報	34,862

2026 年 08 月 06 日時点の集計。MCP サーバーはこれらの合計をリアルタイムで報告するため、エージェントが参照する情報は最新であり、このファイルの作成時点の情報ではありません。

公開データのみを対象とします。すでに公開掲載またはリンクされているチャンネル、グループ、ボットです。非公開グループ、閉鎖されたコミュニティのアーカイブ、個人データは含みません。

---

活用例

• エージェントのツール利用 — 設定を 1 行追加するだけで、エージェントに Telegram の実際の検索機能を提供できます。
• リサーチ — コミュニティを把握し、ニッチな分野を追跡し、オープンな Telegram のつながりを調査できます。
• 検索ボット — トピックに応じてチャンネルやチャットをおすすめできます。
• 市場インテリジェンス — 地域ごとの Telegram 経済圏で何が貸し出され、販売され、提供されているかを把握できます。

AI クローラー向けの機械可読なサイト概要：https://tgden.com/llms.txt

ライセンス

MIT — ご自由にお使いください。無保証です。データは公開 Telegram メタデータです。

---

_{tgden.com が保守しています。Telegram FZ-LLC とは提携していません。 公開されている t.me リンクのみをインデックスします。}