Tgsearch Telethon 是一款基于 Python Telethon 框架开发的 Telegram 公开群组与频道搜索工具，专为在虚拟私有服务器（VPS）上运行而设计。该工具利用已授权的 Telethon 会话文件（session），实现对 Telegram 平台内公开内容的关键词检索功能。用户只需提供搜索关键词和结果数量限制，即可快速获取匹配的公开频道或群组信息。所有搜索结果以结构化的 JSON 格式返回，便于后续集成到自动化流程、数据分析系统或其他第三方应用中。由于依赖 Telegram 官方搜索引擎，因此仅能发现那些在 Telegram 内部搜索中可见的公开资源，无法访问需要邀请链接的私人聊天群组。
核心功能特点
- 支持通过关键词搜索 Telegram 公开频道和群组
- 使用已授权的 Telethon 会话进行身份验证，无需重复登录
- 可自定义返回结果数量，最多支持 50 条记录
- 输出为标准化 JSON 格式，易于程序解析与处理
- 部署于 VPS 环境，适合批量化、自动化调用
适用场景
Tgsearch Telethon 特别适用于需要大规模采集 Telegram 公开社区信息的场景。例如，市场研究人员可以通过该工具快速定位与特定主题（如加密货币、健康资讯或 AI 技术）相关的热门频道，用于舆情分析或趋势监测。内容聚合平台也可借助此工具自动发现并收录高质量的 Telegram 信息流，提升自身数据库的覆盖广度。此外，开发者若正在构建 Telegram 机器人或数据监控服务，可将 Tgsearch 作为前置模块，实现动态抓取目标社群列表。尽管无法触及私密群组，但对于公开可索引的资源，其响应速度和稳定性表现优异，是轻量级爬虫方案的优选之一。