Telegram用户名查重工具: 一键检测频道/用户名是否可注册

导语：安全研究人员常用Telegram进行情报收集和品牌监控，但手动逐一检测用户名是否可用效率极低。DarkWebInformer近期开源了一款基于Telethon的Telegram用户名可用性检测工具，支持批量查询、监控模式和备用名推荐，大幅提升工作效率。

一、工具简介

Telegram Channel & Username Availability Checker 是一款命令行工具，通过Telethon库与Telegram API交互，检测指定用户名是否已被注册、是否可自由注册，或格式是否非法。

GitHub地址：https://github.com/DarkWebInformer/telegram-checker

二、核心功能

2.1 可用性状态检测

工具将检测结果分为四类：

• 🟢 AVAILABLE：该用户名当前未被注册，可自由注册
• 🔴 TAKEN：已被他人占用，并返回详细元数据（标题、成员数、描述等）
• ⚪ INVALID：不符合Telegram用户名格式规则
• 🟡 UNKNOWN：临时性错误（如网络波动、FloodWait限流）

2.2 批量处理能力

支持多种输入方式：

• 直接传入用户名参数：python telegram_checker.py name1 name2 name3
• 读取CSV/TXT文件：自动识别用户名列
• 管道输入：cat names.txt | python telegram_checker.py

2.3 监控模式

使用--watch参数可定期重新检测名单，仅报告状态变化，适用于抢注监控或品牌保护场景。

python telegram_channel_checker.py -i watchlist.txt --watch 60

2.4 备用名推荐

当目标用户名已被占用时，--suggest参数可自动生成并测试相似变体，帮助找到可注册的替代名称。

python telegram_channel_checker.py mybrand --suggest

2.5 丰富的元数据

对于已占用的频道/用户名，工具会返回：

• 频道标题、类型（channel/supergroup/gigagroup等）
• 成员数量、最后活跃时间
• 是否认证/诈骗/虚假/受限标记

三、安全设计

3.1 抗恶意数据

频道标题和描述由频道所有者控制，可能包含公式注入或终端逃逸字符。工具对CSV输出进行了转义处理，并在终端显示前剥离控制字符，防止安全风险。

3.2 凭证保护

工具要求用户从 https://my.telegram.org 获取自己的api_id和api_hash，通过环境变量或.env文件提供。项目内置.gitignore，防止敏感信息泄露。

注意：.session认证文件等同于登录凭证，务必妥善保管，切勿上传至公仓。

四、安装与使用

依赖环境

• Python 3.10+
• Telethon
• tqdm（可选，批量任务显示进度条）

pip install telethon
pip install tqdm

基础用法

# 单个检测
python telegram_channel_checker.py durov

# 批量文件检测
python telegram_channel_checker.py -i names.csv -o results.csv

# 仅显示可用用户名
python telegram_channel_checker.py -i names.csv --available-only

# 断点续传（大文件）
python telegram_channel_checker.py -i big_list.csv -o results.csv --resume

五、输出格式

工具支持多种输出格式：彩色终端卡片、CSV和JSON。CSV输出字段包括用户名、可用性状态、频道类型、成员数、认证标记、最后活跃时间等。

结果实时写入文件，Ctrl+C中断不会丢失已完成的结果，配合--resume参数可从断点继续。

六、使用场景

• 品牌保护：监控自身品牌名是否被抢注
• OSINT情报收集：批量收集Telegram社群信息
• 抢注监控：监控感兴趣的用户名释放情况
• 资产管理：企业检测冒充自身品牌的钓鱼频道

版权声明：本文由华盟网原创发布，保留所有权利。配图由华盟网授权使用。