UnauthScout

UnauthScout es una herramienta CLI para reconocimiento OSINT no autenticado en plataformas públicas de desarrollo como GitHub y GitLab.

Estandariza la recopilación de datos de usuario disponibles públicamente mediante una interfaz consistente y contratos de salida JSON normalizados.

Planteamiento del problema

Las plataformas públicas de desarrollo exponen valiosos datos de reconocimiento sin requerir autenticación. Sin embargo, estos datos suelen ser inconsistentes entre proveedores y difíciles de consumir programáticamente.

UnauthScout aborda este problema mediante:

• Consulta de APIs públicas sin autenticación
• Normalización de respuestas mediante esquemas explícitos
• Provisión de una CLI sencilla y apta para scripts

Características

• Reconocimiento de usuarios no autenticado en GitHub
• Reconocimiento de usuarios no autenticado en GitLab
• Salida JSON normalizada definida por esquemas explícitos
• Modo de salida raw para depuración y descubrimiento de campos
• Arquitectura modular basada en proveedores

Objetivos no contemplados

• Autenticación o acceso basado en tokens
• Evasión de límites de tasa (rate limit)
• Recopilación de datos privados o restringidos
• Correlación o enriquecimiento automático entre plataformas

Requisitos

• Bash (compatible con POSIX)
• curl
• jq

Instalación

git clone https://github.com/rmottanet/unauthscout.git
cd unauthscout
chmod +x bin/unauthscout

Uso

Uso básico

unauthscout <username>

Salida raw (respuesta de API sin procesar)

unauthscout <username> --raw

Por defecto, UnauthScout genera JSON normalizado que se ajusta al esquema correspondiente en schemas/.

Contratos de salida

Las salidas normalizadas se definen mediante JSON Schema:

• schemas/github_user.json
• schemas/gitlab_user.json

Estos esquemas son la fuente de verdad para toda la salida procesada y garantizan estructuras de datos estables y predecibles.

Estructura del proyecto

bin/        # CLI entry point and orchestration
lib/        # Provider integrations and parsing logic
schemas/    # Normalized data contracts (JSON Schema)
docs/       # Documentation as code
tests/      # Automated tests (optional)

Principios de diseño

• No autenticado por defecto
• Contratos de datos explícitos frente a suposiciones implícitas
• Separación clara entre orquestación y obtención de datos
• Superficie mínima, extensible por diseño