🕷️ TGSpyder

TGSpyder 是一款由 Darksight Analytics 开发的开源 Telegram 开源情报命令行工具。

功能特性

• 从公开和私密群组中爬取成员列表并导出为 CSV
• 从公开和私密群组中爬取聊天消息并导出为 CSV
• 从聊天历史中提取 t.me 邀请链接（支持公开和私密群组）
• 通过用户名或（有限的）数字 ID 查询 Telegram 用户
• 识别贴纸包创建者 ID（通过贴纸集 ID 推断）
  致谢：https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
• 代理支持：
  • 保存代理（--set-proxy）
  • 移除代理（--remove-proxy）
  • 单次代理覆盖（--proxy）

要求

• Python 3.10+

安装

git clone https://github.com/Darksight-Analytics/tgspyder.git  
cd tgspyder  
pip install -r requirements.txt  
pip install -e .  

🕷️ 简介

Telegram 开源情报 CLI 工具
专为调查人员、分析师、记者和研究人员打造。

TGSpyder 是一款命令行开源情报工具，用于结构化收集和分析 Telegram 数据。
它能够从公开和私密的 Telegram 群组和频道中爬取成员、消息、邀请链接、用户和元数据——并将所有内容导出为对调查人员友好的 CSV 文件。

功能特性

• 📋 爬取成员列表（在 Telegram 允许的情况下）
• 💬 爬取聊天消息
• 🔗 提取并去重 Telegram 邀请链接
• 🧍 通过 ID 或用户名查询用户
• 🎭 识别贴纸包创建者
• 🌐 SOCKS 代理支持（Tor / VPN）
• 📁 为开源情报工作流生成干净的 CSV 输出
• 📦 输出结构

所有收集的数据存储在一个运行时文件夹中：

TGSpyder Output/  
├── members/  
│   └── members_<目标>_<时间戳>.csv  
├── chats/  
│   └── messages_<目标>_<时间戳>.csv  
└── crawled_links/  
    └── crawled_links_<目标>_<时间戳>.csv  

🚀 快速开始

1️⃣ 克隆仓库

git clone https://github.com/Darksight-Analytics/tgspyder.git  
cd tgspyder  

2️⃣ 创建并激活虚拟环境

python3 -m venv venv  
source venv/bin/activate  

3️⃣ 安装依赖

pip install -r requirements.txt  

4️⃣ 将 TGSpyder 安装为 CLI 工具

pip install -e .  

验证安装：

tgspyder --help  

🔑 Telegram API 凭据

• 前往 https://my.telegram.org 并用你的 Telegram 账号登录。
• 导航至 API development tools 生成 API ID 和 API Hash，这是 TGSpyder 与 Telegram 进行身份验证所必需的。

🧭 基本用法

爬取成员和聊天记录

tgspyder https://t.me/examplegroup --members --chats  

仅提取邀请链接

tgspyder https://t.me/examplegroup --crawl-invites  

用户查询

tgspyder --user 123456789  
tgspyder --user @username  

贴纸包创建者查询

tgspyder --sticker-pack https://t.me/addstickers/packname  

🌐 代理支持

TGSpyder 支持 SOCKS 代理（对 Tor / VPN 友好）。

单次使用代理

tgspyder --proxy socks5://127.0.0.1:9050 <目标> --chats  

保存代理供后续使用

tgspyder --set-proxy socks5://127.0.0.1:9050  

移除已保存的代理

tgspyder --remove-proxy  

🔐 身份验证与配置

首次运行时，TGSpyder 会提示输入：

• Telegram API ID
• Telegram API Hash
• 用户账号或机器人令牌

凭据本地存储在：
~/.tgspyder.conf

会话文件会自动复用。

⚠️ 限制

• 某些群组不公开成员列表
• 私密群组需要有效的邀请链接
• 贴纸创建者归属不总是可保证
• 受限于 Telegram API 限制

🧪 伦理使用与开源情报免责声明

TGSpyder 旨在用于：

• 开源情报调查
• 学术研究
• 新闻工作
• 威胁与网络分析

用户需自行确保遵守：

• 当地法律
• 平台服务条款
• 伦理研究标准

📄 许可证

MIT 许可证
详见 LICENSE 文件。

🚀 演示

👤 作者

• Valdemar Balle
• Darksight Analytics 创始人

⚖️ 免责声明

TGSpyder 仅供开源情报、研究、调查和教育目的使用。

用户需自行确保其对该工具的使用符合：

• 适用法律法规
• 平台服务条款
• 伦理研究与调查标准

作者和贡献者不对该工具的滥用或使用产生的任何后果承担责任。