SOCMIntelligence

Herramienta web SOCMINT / OSINT multiplataforma.

---

Qué es

SOCMIntelligence recopila datos públicos de muchas plataformas, convierte cada resultado en gráficos, tablas de hallazgos y un grafo de relaciones, y fusiona todo en un único grafo de identidad multiplataforma. Como la misma cuenta recibe el mismo ID de nodo en todas partes, un correo electrónico, dominio o nombre de usuario que aparezca en dos escaneos distintos se vincula automáticamente, de modo que puedes ver quién es quién entre servicios.

Módulos

Grupo	Módulos
Redes sociales	X (Twitter) · Instagram · Bluesky · LinkedIn · YouTube · TikTok · Twitch · Kick · Snapchat · Reddit · Mastodon · Telegram · Discord · Steam
Desarrolladores	GitHub · GitLab · Stack Exchange · Hacker News
Identidad y archivos	Keybase · Gravatar · Wayback Machine
Búsqueda y mapa	Búsqueda por palabra clave (Bluesky · Reddit · Mastodon) · Mapa de hashtags

Cada módulo lee únicamente datos públicos (o una API oficial cuando se proporciona una clave). No se realiza scraping de credenciales/sesiones de cuentas privadas.

Características

• Grafo de relaciones — un grafo de fuerzas D3 que fusiona todos los escaneos exitosos. Coincidencias multiplataforma (correo electrónico, dominio o nombre de usuario compartidos), pivoting (haz doble clic en un nodo para escanearlo en el módulo correspondiente), búsqueda, filtros por tipo, exportación a PNG/JSON.
• Línea de tiempo — las publicaciones, comentarios, subidas y eventos de creación de cuenta de cada cuenta en un solo eje, además de un mapa de calor de solapamiento horario y una tabla de similitud horaria.
• Coincidencia de identidad — una puntuación de 0 a 100 de «¿es la misma persona?» por cada par de cuentas con sus motivos (vínculo verificado/criptográfico, correo electrónico compartido, similitud de nombre de usuario y nombre visible, dominio personal compartido, pHash del avatar, horas de actividad). Los pares con puntuación ≥ 40 se dibujan en el grafo.
• Comparación — pon 2 o más cuentas escaneadas del mismo módulo una al lado de otra (tabla de KPI + gráfico de barras, con el valor más alto resaltado).
• Marcas del analista — marca nodos del grafo como Verificado / Sospechoso / Descartado, añade notas, añade nodos y enlaces manuales. Todo se guarda en el caso.
• Gestión de casos — crea un caso, actívalo, y los escaneos, marcas y notas se guardan automáticamente. Importa/exporta un paquete .socmint.
• Seguimiento de cambios (Monitorización) — vuelve a escanear objetivos según una programación y registra qué cambió (campos, enlaces nuevos/eliminados).
• Integridad de la evidencia — los datos sin procesar de cada escaneo se someten a hash (SHA-256 sobre JSON canónico) en el momento de la recopilación; un botón de verificación demuestra si se alteraron.
• Exportaciones — informe HTML / PDF, Excel (.xlsx), GraphML (Gephi/yEd), GEXF (Gephi), CSV de Maltego, JSON.
• Interfaz en inglés — toda la interfaz, los informes, las hojas de cálculo y las etiquetas de los gráficos están en inglés.
• Página de ajustes — claves de API, proxy / Tor / rotación de listas de proxies y límites de velocidad, todo gestionado desde la interfaz en lugar de .env.

Instalación

pipx (recomendado en Linux)

pipx install socmintelligence
socmintelligence

o con pip dentro de un virtualenv:

pip install socmintelligence
socmintelligence

Luego abra http://localhost:8000. Opciones: socmintelligence --host 0.0.0.0 --port 8000 --data-dir ~/socmint-data --no-browser. Los datos (casos, configuraciones) se almacenan en ~/.local/share/socmintelligence a menos que se establezca --data-dir o SOCMINT_DATA_DIR.

Directamente desde GitHub: pipx install git+https://github.com/emrekybs/SOCMIntelligence

Inicio rápido (desde el código fuente)

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn server:app --host 0.0.0.0 --port 8000

Luego abre http://localhost:8000 — documentación de la API en http://localhost:8000/docs.

Las siguientes ejecuciones solo necesitan:

source .venv/bin/activate && uvicorn server:app --port 8000

Docker: docker compose up --build (servicio único).

Configuración

Toda la configuración reside en la página Settings (se guarda en data/settings.json; .env todavía se lee, pero Settings tiene prioridad):

• Claves de API — almacenadas en el servidor, nunca se devuelven al navegador (solo se muestra "set" + los últimos 4 caracteres).
  • YOUTUBE_API_KEY — obligatoria para el módulo de YouTube.
  • HIKERAPI_TOKEN — Instagram (HikerAPI). Sin ella, el módulo de Instagram muestra datos de ejemplo claramente etiquetados.
  • X_BEARER_TOKEN — API v2 de X (Twitter). Sin ella, el módulo de X muestra datos de ejemplo claramente etiquetados para que puedas previsualizar la salida antes de añadir un token.
  • STEAM_API_KEY, STACKEXCHANGE_KEY, GRAVATAR_API_KEY, GITLAB_TOKEN — opcionales, desbloquean datos adicionales.
• Proxy / Tor — desactivado, Tor, un proxy personalizado único, o una lista de proxies que rota en round-robin por escaneo (reparte los límites de tasa).
• Rate — número de escaneos en paralelo y retardo entre peticiones.

Notas

• X (Twitter): el plan gratuito de X es muy limitado — incluso con un token, el historial de publicaciones puede volver vacío en algunos planes; el módulo etiqueta ese caso.
• Telegram solo lee la vista previa pública de t.me/s/ (sin inicio de sesión).
• Gravatar recibe únicamente el hash MD5/SHA-256 de un correo electrónico, nunca el correo en sí.
• TikTok aplica límites de tasa/bloquea bots con frecuencia; el módulo reintenta y distingue un "no encontrado" real de un bloqueo temporal.
• Las distribuciones temporales están en UTC. El "crecimiento" de seguidores de TikTok es una estimación (marcada como tal), no un historial real.

Licencia

Apache License 2.0 — véase LICENSE.