TGuardian es una herramienta de ciberpatrullaje y cibervigilancia que monitorea grupos/canales de Telegram mediante bots y resalta puntos de interés para equipos de CTI y fuerzas de seguridad.
Permite detectar y seguir conversaciones relacionadas con:
- 🕵️♂️ Ciberdelitos (estafas, phishing, fraude digital)
- 💊 Venta de drogas y armas
- 💾 Bases de datos filtradas y credenciales expuestas
- 💣 Terrorismo, radicalización y amenazas
- 🏴☠️ Leaks corporativos y gubernamentales
💾 Persistencia de datos: toda la información recolectada (mensajes, metadatos, alertas y conteos) se almacena localmente en una base SQLite llamada
tg_guard.sqlite, que se crea automáticamente en el directorio donde se ejecuta la herramienta.
- 🎯 Monitoreo en tiempo real de cualquier grupo/canal donde esté agregado tu bot
- 🧩 Filtros dinámicos por palabras clave (coma-separadas) para búsquedas de interés
- 🚨 Alertas configurables con contador de coincidencias y fecha de creación
- 🗂️ Vista de mensajes con: fecha/hora (UTC), chat, usuario, ID de usuario, ID de mensaje y texto
- 📤 Exportación a CSV (vista actual) para reporting e investigación
- 🖥️ GUI moderna (Tk/ttk), sin necesidad de usar CLI
Se recomienda Python 3.9+ en Linux o Windows.
pip install python-telegram-bot==20.7- 🪟 Windows: Tkinter viene incluido con la instalación oficial de Python.
- 🐧 Linux: instalá Tkinter desde tu gestor de paquetes si no está presente:
sudo apt update
sudo apt install python3-tkgit clone https://github.com/UnHackerEnCapital/TGuardian.git
cd TGuardian
pip install -r requirements.txtEn Telegram:
- Enviá
/newboty seguí las instrucciones (nombre y username del bot). - Guardá el token que te entrega (ej:
123456789:AA...Z) — lo vas a usar en TGuardian.
En @BotFather:
- Enviá
/setprivacy - Elegí tu bot
- Seleccioná Disable
❗ Esto permite que el bot lea todos los mensajes del grupo (requisito para monitorear).
- Invitá el bot al/los grupo(s) que querés monitorear.
- Asegurate de que tenga permiso de leer mensajes.
- Si el grupo es privado, agregalo explícitamente (no alcanza con conocer el ID).
python3 TGuardian.pyEn la pantalla de inicio:
- Pegá el token del bot y presioná Iniciar.
- Se abrirá el dashboard principal.
- Configurá filtros y/o alertas, y comenzá a monitorear.
La base tg_guard.sqlite se creará automáticamente en el directorio actual.
- Barra superior: filtros rápidos, limpiar filtro, exportar CSV y estado del bot.
- Panel izquierdo: alertas activas (término, fecha de creación, coincidencias).
- Panel derecho: mensajes (fecha UTC, chat, usuario, ID usuario, ID mensaje, texto).
- Ingresá términos coma-separados (ej: dump, cocaine, ak47, sql).
- Presioná Aplicar filtro para ver solo coincidencias.
- Limpiar filtro → volver a ver todo.
- Exportar CSV (vista actual) → descarga resultados visibles (filtrados o completos).
Columnas: Fecha (UTC), Chat, Usuario, ID Usuario, Msg ID, Texto.
- Nueva alerta: escribí término(s) coma-separados → Agregar.
- Eliminar: seleccioná y presioná Eliminar.
- Tabla de alertas: muestra término, fecha de creación y coincidencias.
- Click en alerta: cambia vista y filtra mensajes desde su creación.
🧠 Cada vez que un mensaje cumple un término de alerta, se incrementa su contador.
- SQLite local: datos guardados en
tg_guard.sqlite. - Tablas principales:
messages: chat, usuario, fecha UTC, ID usuario, ID mensaje, texto.alerts: término, fecha creación, contador.
- Exportar CSV: exporta la vista actual (filtrada o completa).
Esto facilita la cadena de custodia y el análisis forense, incluso sin conexión.
- ❌ No aparecen mensajes → verificar
/setprivacy = Disabley que el bot esté en el grupo. - 🐧 Linux → instalar
python3-tk. - 🔑 Permisos → confirmar que el bot pueda leer el historial.
El monitoreo debe realizarse solo en entornos autorizados. Respetá las leyes locales y los términos de uso de la plataforma.
Proyecto distribuido con fines educativos e investigativos.
El autor no asume responsabilidad por usos indebidos.
Un Hacker En Capital
Esta herramienta se proporciona exclusivamente con fines educativos y de investigación para el análisis de amenazas en entornos de ciberinteligencia. El uso en grupos sin autorización puede ser ilegal. El autor no se responsabiliza por usos indebidos.