murdok1982/telegram-osint-platform

# 🛡️ Telegram OSINT/CTI Platform ### Developed by **[MuRDoK-1982-](https://github.com/MuRDoK-1982-)**     A modular, auditable, and scalable ecosystem designed for early detection of high-impact risks in public Telegram groups. This platform combines advanced MTProto collection, multi-language rule engines, and AI-driven forensic analysis to provide actionable intelligence. ## 🚀 Core Features ### 📡 Hyper-Efficient Collection * **Telethon (MTProto)**: High-performance listener for real-time monitoring of public groups and channels. * **Privacy by Design**: Mandatory pseudonymization of all user handles using salted SHA-256 hashes. * **Selective Acquisition**: Automatic downloading of media only when high-risk scores are detected. ### 🧠 Advanced Logic Engine ### 🕵️ Multi-Agent AI Orchestration * **Agent A (Forensic Psychology)**: Detects radicalization patterns, coercion, and behavioral risk signals. * **Agent B (Threat Intel)**: Evaluates hybrid threats, coordinated campaigns, and infrastructure sabotage. * **Agent C (Strategy)**: Consolidates all findings into professional intelligence reports with TTP mapping. ### 📊 Professional Output * **Automated PDF Reports**: Detailed executive summaries, risk metrics, and agent assessments. * **Direct Alerts**: Secure SMTP delivery of high-risk intelligence cases. * **Sherlock Integration**: Integrated OSINT lookup for cross-platform username presence. ## 🏗️ Architecture graph TD TC[Telegram Collector] -->|POST /ingest| API[FastAPI Orchestrator] API -->|Async Task| CW[Celery Worker] CW -->|Rule Engine| RE[Detection Engine] RE -->|Score >= 12| AA[AI Analysis Agents] AA -->|A / B / C| RG[Report Generator] RG -->|PDF| EMAIL[SMTP Alert] API -->|Metadata| DB[(PostgreSQL)] API -->|Queue| RD[(Redis)] ## 🛠️ Quick Start ### 1. Requirements Ensure you have **Docker** and **Docker Compose** installed. ### 2. Configuration Create a `.env` file based on the provided `.env.example`: cp .env.example .env # Edit .env with your TG_API_ID, TG_API_HASH and OPENAI_API_KEY ### 3. Launch docker-compose up --build -d ## ⚖️ Ethical Use & Compliance ## 👨‍💻 Author **MuRDoK-1982-** *Senior OSINT/CTI Architect & Python Backend Engineer* *Disclaimer: This platform belongs to MuRDoK-1982-. Unauthorized distribution is strictly monitored.* ## 🎖️ CENTRO DE COMUNICACIONES Y REPORTES OFICIALES **NIVEL DE ACCESO:** AUTORIZADO | **DESTINATARIO:** COMANDANCIA DE DESARROLLO (gustavolobatoclara@gmail.com) A través del siguiente portal de comunicaciones, el personal autorizado puede emitir reportes de incidencias, fallas críticas en despliegue (compilación) o solicitudes de mejoras estratégicas. Seleccione la directiva correspondiente para visualizar los protocolos de envío:

🚨 REPORTAR QUEJA O INCIDENCIA DISCIPLINARIA / OPERATIVA

Para tramitar una queja sobre el funcionamiento, estructura o contenido del sistema, envíe un mensaje a gustavolobatoclara@gmail.com siguiendo este protocolo:

1. Asunto: [QUEJA] - Nombre del Sistema - Breve descripción.
2. Cuerpo del mensaje: Detallar claramente la incidencia, impacto operativo y, si es posible, la evidencia (capturas o logs).
3. Prioridad: Indicar si es de atención inmediata o diferida.

🛠️ REPORTE DE PROBLEMAS DE COMPILACIÓN O DESPLIEGUE

Si experimenta fallos durante la fase de compilación o instalación del sistema, reporte a gustavolobatoclara@gmail.com con la siguiente estructura técnica:

1. Asunto: [COMPILACIÓN] - Falla en entorno <Entorno/OS>.
2. Especificaciones: Sistema Operativo, versión de dependencias y herramientas de compilación utilizadas.
3. Traza de Error (Logs): Adjunte el log completo de errores proporcionado por la terminal (en formato texto o captura legible).
4. Pasos de Reproducción: Secuencia exacta de comandos ejecutados antes del fallo crítico.

💡 SUGERENCIAS O SOLICITUDES DE DESARROLLO

Para proponer nuevas capacidades tácticas, módulos de inteligencia o mejoras de arquitectura, envíe su solicitud a gustavolobatoclara@gmail.com:

1. Asunto: [PROPUESTA] - Mejora o Nuevo Módulo.
2. Objetivo Táctico: ¿Qué problema resuelve o qué ventaja proporciona esta nueva característica?
3. Viabilidad: (Opcional) Posible enfoque técnico o herramientas recomendadas para su implementación.