AnuragRoy485/Telegram-OSINT-Toolkit

# Telegram OSINT 工具包    **高端、本地化、生产级别的 Telegram 情报收集工具**，专为 **OSINT**、网络安全研究、执法和军事情报应用而构建。 基于 **Telethon** 开发，支持 **proxy/Tor**、**批量监控**、高级关键词搜索、完整的聊天记录导出、成员枚举以及持久化的 SQLite 存储。 ## ✨ 功能特性 - 🔍 **高级关键词搜索**（支持在多个频道/群组中进行单个和批量搜索） - 📡 从频道列表（TXT/JSON）进行**批量监控** - 📤 **完整的聊天记录导出**（JSON / CSV），可选导出媒体与 EXIF 元数据 - 👥 **成员枚举**与详细的用户画像分析 - 🌐 支持 **Proxy / Tor**（SOCKS5、HTTP）以保障 OPSEC - 💾 **SQLite 数据库**用于长期的可搜索存档 - 📊 **美观的 Rich CLI**，带有进度条和表格显示 - ⚡ 具备速率限制感知能力，内置安全延迟 - 🔄 持久化 session（无需重复登录） ## 🚀 快速开始 ### 1. 克隆仓库 ``` git clone https://github.com/AnuragRoy485/Telegram-OSINT-Toolkit.git cd Telegram-OSINT-Toolkit ``` ### 2. 安装依赖 ``` pip install -r requirements.txt ``` ### 3. 配置 API 凭证 ``` cp config.example.env .env ``` 使用你的凭证编辑 `.env` 文件： ``` TG_API_ID=your_api_id TG_API_HASH=your_api_hash ``` **获取 API ID & Hash**：[https://my.telegram.org](https://my.telegram.org) → API development tools ## 📖 使用示例 ### 基础搜索 ``` python telegram_osint.py search @durov telegram --limit 50 ``` ### 批量搜索（推荐用于情报收集） ``` python telegram_osint.py bulk-search channels.txt "malware OR APT36 OR ransomware" --limit 100 --since 2026-01-01 --output intel_report.json ``` ### 导出聊天记录 ``` python telegram_osint.py export @channelname --limit 2000 --format json --media ``` ### 枚举群组成员 ``` python telegram_osint.py members @groupname --limit 500 ``` ### 用户资料查询 ``` python telegram_osint.py profile @username ``` ### 结合 Proxy / Tor 使用 ``` python telegram_osint.py bulk-search channels.txt "keyword" --proxy socks5://127.0.0.1:9050 ``` ## 📁 项目结构 ``` Telegram-OSINT-Toolkit/ ├── telegram_osint.py # Main Script ├── requirements.txt ├── config.example.env ├── .gitignore ├── README.md └── media_* / # Auto-created for downloaded media ``` ## ⚠️ 重要说明 - **仅限于在公开频道/群组**或您已获授权访问的群组中使用。 - 请遵守 Telegram 的**服务条款**和速率限制。 - 在执行敏感操作时，请务必使用专用账号 + proxy/Tor。 - 本工具仅供**防御、研究和执法**目的使用。 ## 🛠️ 使用的技术 - **Telethon** — Telegram MTProto Client - **Rich** — 精美的终端界面 - **SQLite** — 本地持久化存储 - Python 3.8+ ## 📜 许可证 本项目基于 **MIT License** 授权 — 详情请参阅 [LICENSE](LICENSE) 文件。 ## 👤 作者 **Anurag Roy** 网络安全研究员 GitHub: [@AnuragRoy485](https://github.com/AnuragRoy485) ⭐ 如果您觉得此工具有用，请给本仓库点个 **Star**！ 🍴 欢迎随时 **Fork** 并贡献改进。 如需功能请求、提交 Bug 报告或定制集成（Docker + Tor、自动化报告等），请提交 **Issue** 或 **Pull Request**。

标签：ESC4, OSINT, Python, Telegram, 命令控制, 安全研发, 实时处理, 数据泄露, 数据采集, 无后门, 网络情报, 逆向工具