🕷️ TGSpyder

TGSpyder es una herramienta CLI de OSINT para Telegram de código abierto creada por Darksight Analytics.

Características

• Extrae la lista de miembros de grupos públicos y privados a CSV
• Extrae los mensajes de chat de grupos públicos y privados a CSV
• Extrae enlaces de invitación t.me del historial de chat (grupos públicos y privados)
• Busca un usuario de Telegram por nombre de usuario o ID numérico (limitado)
• Identifica el ID del creador de un paquete de stickers (inferido mediante el ID del conjunto de stickers) Créditos a: https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
• Soporte de proxy:
  • Guardar proxy (--set-proxy)
  • Eliminar proxy (--remove-proxy)
  • Sobrescritura de proxy puntual (--proxy)

Requisitos

• Python 3.10+

Instalación

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

🕷️ Introducción

Herramienta CLI de OSINT para Telegram Diseñada para investigadores, analistas, periodistas y académicos.

TGSpyder es una herramienta CLI de OSINT para la recopilación y el análisis estructurado de datos de Telegram. Permite extraer miembros, mensajes, enlaces de invitación, usuarios y metadatos de grupos y canales de Telegram públicos y privados, exportando todo a archivos CSV aptos para flujos de trabajo de investigación.

Características

• 📋 Extraer listas de miembros (donde Telegram lo permita)
• 💬 Rastrear mensajes de chat
• 🔗 Extraer y deduplicar enlaces de invitación de Telegram
• 🧍 Buscar usuarios por ID o nombre de usuario
• 🎭 Identificar creadores de paquetes de stickers
• 🌐 Soporte de proxy SOCKS (Tor / VPN)
• 📁 Salida CSV limpia para flujos de trabajo de OSINT
• 📦 Estructura de salida

Todos los datos recopilados se almacenan en una única carpeta de ejecución:

TGSpyder Output/
├── members/
│   └── members_<target>_<timestamp>.csv
├── chats/
│   └── messages_<target>_<timestamp>.csv
└── crawled_links/
    └── crawled_links_<target>_<timestamp>.csv

🚀 Inicio rápido

1️⃣ Clonar el repositorio

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

2️⃣ Crear y activar un entorno virtual

python3 -m venv venv
source venv/bin/activate

3️⃣ Instalar las dependencias

pip install -r requirements.txt

4️⃣ Instalar TGSpyder como CLI

pip install -e .

Verificar la instalación:

tgspyder --help

🔑 Credenciales de la API de Telegram

• Ve a https://my.telegram.org e inicia sesión con tu cuenta de Telegram.
• Navega a API development tools para generar tu API ID y API Hash, que son necesarios para autenticar TGSpyder con Telegram.

🧭 Uso básico

Extraer miembros y chats

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

Extraer solo enlaces de invitación

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

Búsqueda de usuario

tgspyder --user 123456789
tgspyder --user @username

Búsqueda del creador de un paquete de stickers

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

🌐 Soporte de proxy

TGSpyder es compatible con proxies SOCKS (compatible con Tor / VPN).

Proxy puntual

tgspyder --proxy socks5://127.0.0.1:9050 <target> --chats

Guardar proxy para futuras ejecuciones

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

Eliminar el proxy guardado

tgspyder --remove-proxy

🔐 Autenticación y configuración

En la primera ejecución, TGSpyder solicitará:

• Telegram API ID
• Telegram API Hash
• Cuenta de usuario o token de bot

Las credenciales se almacenan localmente en: ~/.tgspyder.conf

Los archivos de sesión se reutilizan automáticamente.

⚠️ Limitaciones

• Algunos grupos no exponen listas de miembros
• Los grupos privados requieren enlaces de invitación válidos
• La atribución del creador de stickers no siempre está garantizada
• Sujeto a los límites de la API de Telegram

🧪 Uso ético y aviso de OSINT

TGSpyder está pensado para:

• Investigaciones de OSINT
• Investigación académica
• Periodismo
• Análisis de amenazas y de redes

Los usuarios son responsables de cumplir con:

• Las leyes locales
• Los términos de servicio de la plataforma
• Los estándares éticos de investigación

📄 Licencia

Licencia MIT Consulta LICENSE para más detalles.

🚀 Demo

👤 Autor

• Valdemar Balle
• Fundador de Darksight Analytics

⚖️ Aviso legal

TGSpyder se proporciona únicamente con fines de inteligencia de código abierto (OSINT), investigación, periodismo de investigación y educación.

Los usuarios son los únicos responsables de garantizar que su uso de esta herramienta cumpla con:

• Las leyes y regulaciones aplicables
• Los términos de servicio de la plataforma
• Los estándares éticos de investigación e investigación periodística

El autor y los colaboradores no asumen ninguna responsabilidad por el uso indebido de esta herramienta ni por las consecuencias derivadas de su uso.