N4rr34n6/TgUserDetails
GitHub: N4rr34n6/TgUserDetails
基于 Telethon 的 Telegram OSINT 信息收集脚本,支持通过多种方式检索用户、频道和群组的详细资料并下载头像。
Stars: 81 | Forks: 26
# README.md - Telegram 用户信息检索工具
这个 Python 脚本旨在通过用户名、ID、电话号码或其发送的消息 URL 来检索有关 Telegram 用户、公开频道或群组的信息。它利用 Telethon 库与 Telegram API 进行交互。本 README 文件概述了该脚本的使用方法及其功能。
## 目录
1. [环境要求](#requirements)
2. [使用方法](#usage)
3. [功能特性](#functionality)
4. [脚本说明](#script-description)
5. [许可证](#license)
## 环境要求
在使用此脚本之前,请确保已安装以下依赖项:
- Python 3.x
- Telethon 库
- 其他库:argparse, colorama
你可以使用 pip 安装所需的包:
```
pip install telethon argparse colorama
```
你还需要从 [Telegram 官方网站](https://my.telegram.org/auth) 获取你的 Telegram API 凭证(api_id 和 api_hash)。请将脚本中的占位符替换为你的凭证。
## 使用方法
从命令行运行脚本,提供以下选项之一:
- `-u` 或 `--username`:通过用户名检索信息。
- `-i` 或 `--id`:通过用户或频道 ID 检索信息。
- `-p` 或 `--phone`:通过电话号码检索信息。
- `-l` 或 `--url`:通过在公开频道或群组中发送的消息 URL 检索信息。
使用示例:
```
python3 script.py -u mytelegramuser
python3 script.py -i 123456789
python3 script.py -p +1234567890
python3 script.py -l https://t.me/mychannel/1234
```
如果需要,请按照提示进行身份验证和输入。
## 功能特性
此脚本可以检索有关 Telegram 用户、频道或群组的以下信息:
- 用户信息:
- 用户 ID
- 名字
- 姓氏(如果有)
- 用户名(如果有)
- 最后在线状态(在线、离线、最近、上周、上个月)
- 个人简介(关于)
- 个人资料图片下载(JPG 格式)
- 频道信息:
- 频道 ID
- 标题
- 用户名(如果有)
- 描述
- 创建日期
- 个人资料图片下载(JPG 格式)
- 群组信息:
- 群组 ID
- 标题
- 管理员数量
- 创建日期
- 个人资料图片下载(JPG 格式)
- 电话号码信息(临时联系人):
- 用户 ID
- 名字
- 姓氏(如果有)
- 用户名(如果有)
- 最后在线状态(在线、离线、最近、上周、上个月)
- 个人简介(关于)
- 个人资料图片下载(JPG 格式)
- 检索信息后恢复联系人
- 消息 URL 信息:
- 从公开频道或群组中的消息 URL 检索信息
## 脚本说明
- 该脚本使用 Telethon 库与 Telegram API 进行交互。
- 它提供了一个命令行界面 (CLI) 供用户输入其选项。
- 用户可以通过用户名、ID、电话号码或 URL 指定目标用户、频道或群组。
- 用户身份验证在脚本内部进行处理。
- 该脚本会下载个人资料图片并将其保存为 JPG 文件。
- 检索到的信息以易读的格式显示。
## 许可证
此脚本基于 GNU Affero General Public License v3.0 提供。你可以在 [LICENSE](LICENSE) 文件中找到完整的许可证文本。
你可以随意根据需要使用和修改此脚本。如果你有任何问题或遇到任何故障,请不要犹豫,随时提问或报告。祝你愉快地使用 Telegram 用户信息检索工具!
标签:BeEF, ESC4, OSINT, Python, Telegram, Telegram API, Telethon, URL抓取, 个人隐私安全, 公开情报收集, 头像下载, 实时处理, 数据抓取, 无后门, 爬虫, 用户画像, 用户追踪, 社交媒体监控, 社工库, 社工辅助, 网络安全, 网络欺诈调查, 隐私保护, 黑产工具