JSHunter

Acerca de

JSHunter es una herramienta de línea de comandos integral para el análisis de seguridad de JavaScript y el descubrimiento de endpoints. Diseñada para profesionales de seguridad, pentesters y desarrolladores, ofrece capacidades de análisis de nivel empresarial con algoritmos de detección de alta precisión y funciones de generación de informes profesionales.

https://github.com/user-attachments/assets/5a5f60fa-f8dc-4aac-bd06-2e93779f9af4

JSHunter en acción — una captura real de terminal de la CLI (cada secreto mostrado son datos de prueba falsos)

---

Tabla de contenidos

• Acerca de
• Características
• Instalación
• Inicio rápido
• Ejemplos de uso
• Referencia de comandos
• Uso avanzado
• Contribuir
• Licencia
• Soporte

---

Características

Capacidades principales

• Descubrimiento integral de endpoints: extrae automáticamente URLs, endpoints de API y parámetros ocultos de archivos JavaScript
• Análisis de seguridad avanzado: identifica claves de API, tokens JWT, credenciales y posibles vulnerabilidades con alta precisión
• Métodos de entrada flexibles: admite URLs, listas de archivos, archivos locales, entrada por stdin y descubrimiento recursivo
• Arquitectura de alto rendimiento: procesamiento concurrente multihilo con limitación de velocidad inteligente
• Funciones profesionales de sigilo: soporte de proxy, encabezados personalizados, rotación de user-agent y detección de bypass

Motor de detección inteligente

Precisión de nivel empresarial con algoritmos de análisis avanzados

• Detección inteligente de Base64: el filtrado de alta precisión elimina falsos positivos de contenido multimedia y datos codificados
• Interfaz profesional: terminología de nivel empresarial, documentación y formatos de informes completos
• Análisis consciente del contexto: algoritmos avanzados distinguen tokens de seguridad reales de datos multimedia codificados
• Análisis de entropía: algoritmos matemáticos identifican tokens de seguridad y credenciales genuinos con precisión

Motor de detección estructural

JSHunter analiza el JavaScript que escanea en lugar de solo aplicar coincidencia de patrones. Un escáner ECMAScript de una sola pasada clasifica cada byte de la respuesta como literal de cadena, literal de plantilla, comentario, literal de expresión regular o código, y las reglas de detección se evalúan contra esa clasificación.

Esto importa porque una regex no tiene idea de qué coincidió. Los mismos cuarenta caracteres base64 significan "credencial" dentro de un literal de cadena, "hash de chunk" dentro de un identificador minificado, y nada en absoluto cuando se extienden sobre la unión entre dos tokens adyacentes. Saber cuál es cuál reemplaza un montón de heurísticas de proximidad con una respuesta estructural:

• Region gating: una coincidencia dentro de un literal de regex es un patrón, no un valor. Una coincidencia que cruza un límite de token no es un único literal. Una coincidencia en código es un fragmento de identificador. Las tres se rechazan de plano.
• Binding context: en lugar de escanear una ventana fija de caracteres buscando la palabra key, el motor recupera el identificador o la clave de propiedad a la que el valor está realmente vinculado — const stripeSecret = "..." se lee muy distinto de {contentHash: "..."}, y una regla basada solo en la forma ahora requiere ese vínculo.
• Sibling key-sets: los miembros de una configuración web de Firebase, una configuración de búsqueda de Algolia, una configuración de analítica de Segment y un cliente de navegador de Supabase se reconocen por la forma del objeto en el que se encuentran.
• Value shape: digests, UUIDs, prosa, rutas, marcadores de posición y base64 que decodifica a un PNG, una fuente, un documento JSON o una frase en inglés se identifican cada uno por lo que son.
• Exposure classification: los valores que el emisor publica a propósito — claves publicables de Stripe, tokens públicos de Mapbox, JWT anon de Supabase leídos desde su propia declaración role, SIDs de Twilio — se clasifican en lugar de reportarse como filtraciones. --include-public los reporta de todos modos.
• File-relative surprisal: un modelo de transición de caracteres construido a partir del archivo que se está escaneando puntúa cuán distinto del resto de ese archivo se lee un candidato.

Cada rechazo está condicionado a que el cuerpo sea confiablemente JavaScript o JSON. En cualquier otra cosa — un archivo .env, prosa, HTML sin procesar — el motor aporta evidencia pero nunca suprime, por lo que una entrada mal clasificada nunca puede ocultar un secreto. --no-structural desactiva toda la capa y restaura el comportamiento de v0.7.

Los hallazgos llevan el razonamiento como un objeto evidence en --json, --ndjson y la bolsa de propiedades SARIF:```json "exposure": "secret", "evidence": { "region": "string-literal", "role": "assignment", "bound_to": "awsAccessKeyId", "shape": "opaque-token", "charset": "alphanumeric", "signals": [ {"name": "in-literal", "delta": 0.04, "detail": "value is a complete string-literal"}, {"name": "credential-binding", "delta": 0.12, "detail": "bound to 'awsAccessKeyId'"} ] }

`--stats` informa qué descartó cada etapa, por lo que el pipeline permanece auditable.

### Grafo de Chunks y Descubrimiento de Rutas

Una aplicación moderna entrega un bundle de entrada y varios cientos de chunks cargados de forma diferida cuyas URLs se ensamblan en tiempo de ejecución a partir de un manifiesto que el bundler incorpora. Nada enlaza hacia ellos, por lo que un crawler nunca los ve. `-G` recupera ese manifiesto e imprime la lista completa de assets y la tabla de rutas del cliente:```console
$ jshunter -u https://target.example/_next/static/chunks/main-a1b2c3.js -G
[CHUNKS] https://target.example/...: next runtime, 214 chunks, 37 routes
[CHUNK]  https://target.example/...  https://target.example/_next/static/chunks/settings.11aa22bb33cc.js
[ROUTE]  https://target.example/...  /admin/users/:id

Runtimes compatibles: webpack 4 y 5 (__webpack_require__.u, miniCssF, jsonpScriptSrc), manifiestos de compilación de Next.js, Vite y Rollup (__vite__mapDeps, __vitePreload), import() dinámico simple, y tablas de rutas de React Router, Vue Router y Angular. La salida está separada por tabulaciones y deduplicada, por lo que se canaliza directamente de vuelta como la lista de entrada de un escaneo posterior:```bash jshunter -u https://target.example/main.js -G -q | awk -F'\t' '/^[CHUNK]/{print $3}' > chunks.txt jshunter -l chunks.txt -s -j > findings.json

### Suite Profesional de HTTP y Redes
<details>
<summary><strong>Configuración de Red de Nivel Empresarial</strong></summary>