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 → 运行免费 Telegram 工具 → 选择工具 → 运行工作流 → 下载结果制品。使用此方式需要登录 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
• 用户界面 — tgden.com · 文档 — tgden.com/en/api-docs

---

维护 Telegram 社群列表

Telegram 链接检查器和社群目录会检查超出 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 获取某个频道的所有已知信息。
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 — 即时自动补全

随着输入提供分组排序的建议。适用于搜索框和 Agent 工具调用。

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 约 200 次请求 / 10 秒，共享公平使用限制
MCP（/api/mcp）	每个 IP 每小时 240 次调用
身份验证	无 — 无需密钥、注册或邮箱
费用	免费

经过验证的搜索引擎和 AI 爬虫不受共享限制约束。

我们将这些视为一项约定：如有变更，我们会在此处和文档中公布。不会暗中限流。 需要有保障的吞吐量，或为实际项目批量导出数据？请提交 issue，或通过 @tgden_bot 联系我们。

---

关于数据

持续从 Telegram 的公开页面解析而来 — 比任何大模型训练集都新鲜， 这正是通过 MCP 开放数据的主要原因。

频道	1,298,868
群聊	282,719
机器人	157,909
已索引帖子	4,955,162
市场列表	34,862

统计截至 06.08.2026。MCP 服务会实时报告这些总数，因此 Agent 看到的是当前数据，而不是编写此文件时的数据。

仅包含公开数据：已经公开列出或链接的频道、群组和机器人。 不包含私人群组、已关闭社群的存档或个人数据。

---

使用场景

• Agent 工具调用 — 只需一行配置，即可让 Agent 探索真实的 Telegram 内容。
• 研究 — 绘制社群图谱、追踪细分领域、研究开放的 Telegram 关系网络。
• 发现机器人 — 按主题推荐频道和聊天。
• 市场情报 — 了解 Telegram 地区经济中正在出租、出售和提供的内容。

面向 AI 爬虫的机器可读网站摘要：https://tgden.com/llms.txt

许可证

MIT — 随意使用，不提供任何担保。数据是公开的 Telegram 元数据。

---

_{由 tgden.com 维护。与 Telegram FZ-LLC 无关联。 仅索引公开的 t.me 链接。}