Telegram IOC Resolver

一款生产就绪、具有高弹性的异步 Python 工具，基于 MTProto API (Telethon) 构建，旨在解析、分类并从海量的 Telegram IOCs (失陷标志) 列表中提取元数据。

## ⚡ 功能 - **异步引擎**：利用纯 `asyncio` 和 `Telethon` 快速且安全地解析海量的域名列表。 - **深度元数据提取**：解析实体类型（用户、Bot、频道、超级群组）、显示名称、Telegram ID、成员数量、简介/描述以及安全标记（已验证/诈骗/虚假/受限）。 - **防封禁架构**：智能处理 Telegram 的速率限制 (`FloodWait`)、无效用户名、已删除的账户、网络错误以及 session 状态持久化。 - **流式表格输出**：随着结果被成功解析，它们会被持续流式传输到一个整洁且格式化的 Markdown 表格中。 - **智能恢复**：内置的状态跟踪功能允许你暂停处理，并在之后从上次中断的确切位置恢复，而不会丢失数据。 ## ⚙️ 设置 ### 前置条件 - Python 3.12+ - Telegram API ID 和 Hash（可通过 [my.telegram.org](https://my.telegram.org) 获取） ### 安装 1. **克隆仓库**： git clone cd TG-Resolver 2. **安装依赖**： pip install -r requirements.txt 3. **配置环境**： cp .env.example .env 打开 `.env` 并填入你的 `API_ID` 和 `API_HASH`。 ## 🚀 用法 默认情况下，脚本会在根目录中查找名为 `Cleaned_IOC.txt` 的文件。 ### 基本运行 ``` python main.py ``` ### 自定义 IOC 文件 你可以使用 `--file` 或 `-f` 参数指定任何包含换行符分隔的 Telegram URL 的文本文件： ``` python main.py --file path/to/your/iocs.txt ``` ### 身份验证 在首次运行时，脚本会以交互方式提示你输入 Telegram 电话号码和 2FA 验证码。这会在本地生成一个持久的 `.session` 文件。 ### 交互式暂停 在脚本运行时，你可以安全地暂停它： 1. 输入 `p` 并按 **Enter**。 2. 输入 `yes` 进行确认。 3. 脚本将安全关闭并保存其确切状态。再次运行 `python main.py` 即可立即恢复！ *免责声明：请负责任地使用，并严格遵守 Telegram 的服务条款，以避免账户被封禁。*

标签：ESC4, OSINT, Python, Telegram, Telethon, 元数据提取, 威胁情报, 开发者工具, 异步编程, 无后门, 漏洞探测, 计算机取证, 进程保护, 逆向工具