IG-Detective 🕵️‍♂️📸

Creado por @shredzwho | 💖 Patrocina este proyecto

IG-Detective es una herramienta OSINT (Inteligencia de Fuentes Abiertas) de alto rendimiento para Instagram, basada en Python. Ofrece un shell interactivo premium para realizar análisis profundos en cuentas de Instagram, extraer historial de ubicaciones, mapear interacciones y generar informes de investigación automatizados.

[!WARNING] Aviso legal: Esta herramienta es solo para fines educativos y de investigación. Úsela de manera responsable y de acuerdo con los Términos de Servicio de Instagram. El autor no se hace responsable por cualquier uso indebido.

---

⚡ Características

🛡️ Evasión y Sigilo (Avanzado)

• Suplantación de huella TLS: Utiliza un navegador chromium sin interfaz gráfica con playwright-stealth para imitar un entorno real, evitando por completo la limitación de tasa de Cloudflare y CDN.
• Fallback de evasión profunda: Si una sesión autenticada es bloqueada (por ejemplo, códigos HTTP 401/429/400), automáticamente recurre a una obtención sin autenticación mediante un navegador headless, omitiendo cookies y falsificando cabeceras para emular una conexión limpia.
• Jitter de Poisson: Retrasos aleatorios similares a los humanos entre solicitudes para imitar el comportamiento natural del usuario.

⚡ Rendimiento y Optimización

• Ajuste de memoria headless: Configuración del navegador Playwright reducida que descarga explícitamente activos visuales pesados (imágenes, fuentes, hojas de estilo) mediante interceptación de rutas para lograr velocidades de consulta ultrarrápidas.
• Exportación asíncrona de datos: Utiliza la descarga paralela con ThreadPool para el comando de archivo data, acelerando drásticamente la replicación completa de medios del perfil.

🔍 Reconocimiento Principal

• Información del Usuario: Detalles completos del perfil (ID, Biografía, Seguidores, Estado de negocio).
• Seguidores/Siguiendo: Listar y exportar la red social del objetivo.
• Análisis de Publicaciones: Desglose detallado del contenido reciente, me gusta y comentarios.

📍 OSINT Avanzado

• Mapeo Geoespacial Interactivo: Extrae coordenadas GPS de las publicaciones y genera un mapa interactive_map.html con Folium que incluye direcciones legibles y marcadores con clic.
• Análisis de Red Social (sna): Mapea interacciones para identificar el "Círculo Íntimo"—los 10 usuarios más conectados con el objetivo.
• Perfil de Actividad Temporal (temporal): Utiliza agrupamiento DBSCAN para identificar el "hueco de sueño" del objetivo y predecir su Zona Horaria principal.
• Extracción de Historias (stories): Obtiene URLs de historias activas.

🔬 Módulos Forenses de Investigación de Vanguardia (Bleeding-Edge)

• Enumeración de Recuperación de Cuenta (recovery): Activa el flujo de restablecimiento de contraseña para revelar sugerencias de contacto enmascaradas para la verificación administrativa del correo electrónico.
• Análisis de Co-Visitación (intersect): Identifica puntos de encuentro físico cruzando intersecciones GPS/Tiempo entre dos objetivos.
• Estilometría (stylometry): Genera una "Firma Lingüística" digital para vincular múltiples cuentas basándose en la distribución de bigramas y emojis.
• Auditoría de Engagement (audit): Detección estadística de actividad de bots no auténtica mediante la varianza del jitter temporal.

📦 Gestión de Investigaciones

• Exportación con un Solo Clic (data): Descarga automáticamente la lista de seguidores, seguidos y medios de la línea de tiempo del objetivo (con metadatos JSON), empaquetado en un único archivo ZIP.
• Informes Automatizados: Cada comando guarda automáticamente los resultados en informes JSON y TXT en data/<target>/.
• Modo por Lotes Autónomo: Procesa múltiples objetivos secuencialmente desde un archivo de texto.
• Caché Inteligente: Consultas repetidas ultrarrápidas mediante caché basada en TTL.

---

🚀 Instalación

1. Clonar el repositorio

   root@kitploit:~

   git clone https://github.com/shredzwho/IG-Detective.git
   cd IG-Detective
   

2. Configurar el Entorno Virtual

   root@kitploit:~

   python3 -m venv venv
   source venv/bin/activate  # En Windows: venv\Scripts\activate
   

3. Instalar Dependencias

   root@kitploit:~

   pip install -r requirements.txt
   

🐳 Ejecutar con Docker (Recomendado)

Puede ejecutar IG-Detective completamente dentro de Docker para evitar problemas de dependencias. El contenedor requiere una TTY interactiva (-it) y un montaje de volumen para guardar sus informes forenses.

1. Usando Docker Compose (Más Fácil)

   root@kitploit:~

   docker-compose run --rm detective
   

2. Usando Docker estándar

   root@kitploit:~

   docker build -t ig-detective .
   docker run -it -v $(pwd)/data:/app/data ig-detective
   

---

🛠 Uso

1. Iniciar el Shell

   root@kitploit:~

   python3 main.py
   # o usando el script provisto:
   ./run.sh
   

2. Comandos Principales Una vez dentro del shell, primero debe establecer un objetivo antes de ejecutar los módulos de análisis:

---

📑 Documentación Detallada

Para una inmersión profunda en la arquitectura del sistema, metodologías forenses y lógica de evasión, consulte: 👉 DOCUMENTATION.md

---

📂 Estructura del Proyecto

• main.py: Punto de entrada principal del shell.
• run.sh: Script de lanzamiento.
• src/api/: Capa de red que contiene el cliente sigiloso Playwright y el gestor de autenticación.
• src/core/: Capa base con modelos de datos y configuración.
• src/modules/: Capa de lógica de negocio con scrapers y herramientas de análisis profundo.
• src/cli/: Capa de presentación con el prompt interactivo y formateadores Rich.
• data/: Informes de investigación automatizados (ignorados por git).

---

🤝 Contribuciones

Siéntase libre de bifurcar este proyecto y enviar pull requests. Para cambios importantes, abra primero un issue para discutir lo que le gustaría cambiar.

📜 Licencia

[MIT]