OctoSuite

OctoSuite: marco avanzado de inteligencia OSINT para GitHub

OctoSuite es un framework de inteligencia de código abierto, escrito en Python, diseñado para investigar eficientemente usuarios, organizaciones y repositorios públicos en GitHub. Aprovecha la API pública de GitHub para automatizar consultas, generar resultados reproducibles y exportarlos en formato CSV, además de mantener un registro detallado de la actividad.

Con más de 20 funcionalidades, ofrece información como perfiles, eventos, seguidores, forks, contenidos de repos, issues, commits y más, todo presentado de forma legible y estructurada.

¿Para qué sirve?

• Investigación OSINT avanzada en GitHub.

• Automatización de auditorías y análisis por lotes.

• Exportación de datos en CSV.

• Registro y trazabilidad de toda la actividad de análisis.

Instalación

Desde PyPI

pip install octosuite

Desde el repositorio (Linux/macOS)

git clone https://github.com/bellingcat/octosuite.git cd octosuite python setup.py sdist bdist_wheel pip install dist/octosuite-<versión>.whl

GUI (Windows/macOS)

• Descargar .exe o .app desde la sección "Releases" del repositorio.

• Ejecutar desde terminal en macOS:

/path/to/Octosuite.app/Contents/MacOS/Octosuite

Al iniciar, se crean las carpetas .logs, output, y downloads.

Comando de ayuda

Modo interactivo

octosuite

Luego:

help help:user help:repo help:org help:search

Modo CLI

octosuite-cli --help

Ejemplos:

octosuite-cli --initialise user-profile --username <usuario> octosuite-cli --initialise commits-search --query ".ovz1" --colours --log-to-csv

Gestión de CSV y logs:

--initialise view-csv --initialise clear-logs --initialise search-users --query <consulta>

Cómo se usa

Modo interactivo

octosuite

1. Activar colores: y/n.

2. Usar comandos: help:user, user:profile, etc.

3. Guardar como CSV si se desea.

4. Comandos de gestión:

csv:read csv:delete csv:clear logs:view logs:read logs:clea

Modo CLI avanzado

octosuite-cli --initialise user-profile --username user123 --log-to-csv --colours

Búsqueda por commits:

octosuite-cli --initialise commits-search --query "bugfix" --log-to-csv

Automatización por lotes:

while read username; do octosuite --method user_profile --username "$username" --colours --log-to-csv done < usernames.txt

Hashtags de tendencia

#OSINT
#GitHubInvestigation
#Cybersecurity
#Infosec
#OpenSourceIntel
#ThreatIntel
#Bellingcat
#OctoSuite