JSHunter

Acerca de

JSHunter es una herramienta integral de línea de comandos para el análisis de seguridad de JavaScript y el descubrimiento de endpoints. Diseñada para profesionales de seguridad, testers de penetración 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
• Contribuciones
• 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 Avanzado de Seguridad: 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 multiproceso con limitación de velocidad inteligente
• Funciones Profesionales de Sigilo: Soporte de proxy, cabeceras personalizadas, 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 Contextual: 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

Suite Profesional de HTTP y Redes

Análisis Avanzado de JavaScript

Suite de Análisis de Seguridad

Alcance y Descubrimiento

Suite Profesional de Informes y Exportación

Instalación

Instalación con Go (Recomendada)```bash

Install JSHunter

go install -v github.com/cc1a2b/jshunter/cmd/jshunter@latest

Verify installation

jshunter --help

### Compilar desde el código fuente```bash
git clone https://github.com/cc1a2b/jshunter.git
cd jshunter
go build -o jshunter ./cmd/jshunter

Requisitos del sistema

• Go 1.22.5+ (para compilar desde el código fuente)
• Linux, macOS o Windows (arquitectura de 64 bits)
• Conectividad de red para el análisis remoto de JavaScript

Inicio rápido

Análisis básico```bash

Analyze a single JavaScript file

jshunter -u "https://example.com/app.js"

Scan multiple URLs from file

jshunter -l urls.txt

Analyze local JavaScript file

jshunter -f app.js

### Análisis de Seguridad Completo```bash
# Find API keys, secrets, and credentials
jshunter -u "https://target.com/app.js" -s

# Full analysis with deobfuscation, GraphQL, and Firebase detection
jshunter -u "https://target.com/app.js" -d -s -g -F -x -L

# Professional security assessment with all tools
jshunter -u "https://target.com/app.js" -d -m -e -s -x -P -g -F -B -L

# Export comprehensive results for reporting
jshunter -l targets.txt -s -g -F -j -o security_findings.json

Ejemplos de Uso```bash

Analyze single URL

jshunter -u "https://example.com/app.js"

Analyze multiple URLs from file

jshunter -l urls.txt

Pipe URLs from stdin

cat urls.txt | grep ".js" | jshunter

Complete security analysis - find secrets, API keys, and credentials

jshunter -u "https://example.com/app.js" -s -x -F

Full analysis suite with deobfuscation and all security tools

jshunter -u "https://target.com/app.js" -d -m -e -s -x -P -g -F -B -L

Professional assessment with source map analysis

jshunter -u "https://target.com/bundle.js" -d -m -s -g -F

Export comprehensive results to structured formats

jshunter -l targets.txt -s -x -F -g -j -o security_findings.json

Stealth scanning with Burp Suite integration

jshunter -l targets.txt -p 127.0.0.1:8080 -s -g -F -n -o burp_findings.txt

Scanning through SOCKS5 proxy (Tor, SSH tunnel, etc.)

jshunter -l targets.txt -p socks5://127.0.0.1:9050 -s -x -F

Rate-limited professional scanning with authentication

jshunter -l urls.txt -R 2000 -H "Authorization: Bearer token" -s -x -F -g -q

Complete endpoint and parameter discovery

jshunter -l urls.txt -ep -P -PU -L -w 2

Advanced obfuscation analysis with context detection

jshunter -f obfuscated.js -d -z -e -s -v

---

## Referencia de Comandos

Obtén la ayuda completa en cualquier momento con `jshunter --help````
Usage:
  -u,  --url URL                Input a URL
  -l,  --list FILE.txt          Input a file with URLs (.txt)
  -f,  --file FILE.js           Path to JavaScript file
       --har FILE               Ingest a Chrome DevTools HAR archive

Basic Options:
  -t,  --threads INT            Number of concurrent threads (default: 5)
  -c,  --cookies <cookies>      Authentication cookies for protected resources
  -p,  --proxy host:port        HTTP/SOCKS5 proxy (e.g., 127.0.0.1:8080 for Burp Suite)
  -q,  --quiet                  Suppress ASCII art output
       --no-color               Disable ANSI color (auto-off when not a TTY)
  -o,  --output FILENAME        Output file path
  -r,  --regex <pattern>        RegEx for filtering results
       --update, --up           Update the tool to latest version
  -ep, --end-point              Extract endpoints from JavaScript files
  -k,  --skip-tls               Skip TLS certificate verification
  -fo, --found-only             Only show results when sensitive data is found

HTTP Configuration:
  -H,  --header "Key: Value"    Custom HTTP headers (repeatable, including Auth)
  -U,  --user-agent UA          Custom User-Agent string or file path
  -R,  --rate-limit MS          Request rate limiting delay (milliseconds)
  -T,  --timeout SEC            HTTP request timeout (seconds)
  -y,  --retry INT              Retry attempts for failed requests (default: 2)
       --per-host INT           Per-host outbound concurrency cap (default: 4)
       --max-bytes N            Cap response body read in bytes (default: 32MiB)
       --allow-internal         Permit localhost / RFC1918 / link-local targets
       --cache-dir DIR          Persist responses on disk; revalidate via ETag

JavaScript Analysis:
  -d,  --deobfuscate            Deobfuscate minified and obfuscated JavaScript
  -m,  --sourcemap              Fetch and parse source maps + sourcesContent[]
  -e,  --eval                   Analyze dynamic code execution (eval, Function)
  -z,  --obfs-detect            Detect code obfuscation patterns and techniques
       --inline-html            Scan inline <script> tags + SRI/CSP in HTML responses
       --csp-origins            Emit CSP-allowed origins as candidate endpoints

Security Analysis:
  -s,  --secrets                Detect API keys, tokens, and credentials
  -x,  --tokens                 Extract JWT and authentication tokens
  -P,  --params                 Discover hidden parameters and variables
  -PU, --param-urls             Advanced parameter extraction with URL context
  -i,  --internal               Filter for internal/private endpoints
  -g,  --graphql                Analyze GraphQL endpoints and queries
  -B,  --bypass                 Detect WAF bypass patterns and techniques
  -F,  --firebase               Analyze Firebase configurations and keys
  -L,  --links                  Extract and analyze all embedded links

Detection Tuning:
  -mc, --min-confidence FLOAT   Minimum confidence (0.0-1.0) for a finding (default: 0.50)
  -sc, --show-confidence        Print [conf=X.XX] alongside each finding
       --no-fp-filter           Disable the false-positive filter (debug)
       --ignore-file FILE       Permanent suppressions (.jshunterignore)
       --diff PREVIOUS.json     Report only NEW findings vs previous JSON envelope
       --rules-file FILE.json   Load an external JSON rule pack
       --only-rules id,glob     Run only matching rules (supports * glob)
       --disable-rule id,glob   Disable matching rules (supports * glob)

Verification:
       --verify                 Probe findings against provider read-only endpoints
       --verify-timeout SEC     Timeout per verification probe (default: 10)
       --verify-workers INT     Concurrent verifier worker pool (default: 8)

Scope & Discovery:
  -w,  --crawl DEPTH            Recursive JavaScript discovery depth (default: 1)
  -D,  --domain DOMAIN          Limit analysis to specific domain
  -E,  --ext                    Filter by JavaScript file extensions
       --robots                 Fetch /robots.txt for each input host and exit

Output Formats:
  -j,  --json                   Structured JSON output (schema_version 2)
       --ndjson                 Newline-delimited JSON (jq / SIEM streaming)
       --sarif                  SARIF 2.1.0 (GitHub code-scanning compatible)
  -C,  --csv                    CSV format for spreadsheet analysis
  -v,  --verbose                Detailed analysis and debug output
  -n,  --burp                   Burp Suite compatible export format
       --stats                  Per-stage counters on stderr at end of run

Registry:
       --list-rules             Print the rule registry as a table and exit
       --explain RULE_ID        Print full rule details and exit
       --self-test              Run rule registry against built-in TP/FP fixtures

  -h,  --help                   Display this help message

Modelo de confianza

Cada coincidencia de clase secreta se puntúa en [0.0, 1.0]. La puntuación parte de una prioridad por regla y se ajusta mediante:

El valor predeterminado --min-confidence 0.50 filtra la cola larga de coincidencias solo por patrón. Usa --min-confidence 0.80 para un triaje de alta precisión, --no-fp-filter para salida cruda y sin filtrar.

Validadores de proveedor

Un validador es una comprobación de consistencia por regla que se ejecuta después de que la expresión regular coincida. Es la defensa más sólida contra falsos positivos: una cadena aleatoria que casualmente se ajusta a la forma aún debe superar una suma de comprobación, una decodificación estructural o una prueba de longitud/conjunto de caracteres antes de ser reportada (y superarla añade +0.10).

Cobertura de proveedores

El registro curado incluye más de 85 detectores que abarcan gestores de nube y secretos (AWS, Azure, GCP/PKCS#8, HashiCorp Vault, Terraform, Fly.io, Tailscale), control de versiones y CI/CD (GitHub, GitLab, Docker Hub, Atlassian, Sentry, CircleCI, Buildkite), pagos (Stripe, Square, Braintree, Plaid), proveedores de IA/LLM (OpenAI, Anthropic, Groq, Perplexity, Replicate, OpenRouter, Fireworks, HuggingFace), mensajería (Slack, Discord, Telegram, Twilio, Intercom, SendGrid, Mailgun), SaaS y bases de datos (Notion, Airtable, Figma, Postman, Databricks, PlanetScale, Grafana, New Relic, Dropbox, RubyGems, Supabase) y material PKI (claves privadas RSA/EC/DSA/OpenSSH/PGP/PKCS#8, .ppk de PuTTY, URIs de conexión a bases de datos). Ejecuta jshunter --list-rules para la tabla autoritativa y jshunter --explain <rule_id> para el patrón, validador y fixtures de cualquier regla individual. Las formas de "hash simple" sin prefijo solo se incluyen cuando un validador estructural o una puerta de contexto obligatoria pueden mantenerlas libres de falsos positivos.

Uso Avanzado

Evaluación de Seguridad Profesional```bash

Complete security analysis with all tools

jshunter -l targets.txt -d -m -e -z -s -x -P -PU -g -F -B -L -j -v -o complete_assessment.json

Advanced deobfuscation and analysis pipeline

jshunter -l targets.txt -d -m -z -e -s -g -F --found-only -o deobfuscated_findings.json

Stealth reconnaissance with rate limiting and custom headers

jshunter -l targets.txt -R 2000 -U "Mozilla/5.0..." -H "X-Forwarded-For: 1.1.1.1" -s -x -F -q

Professional penetration testing through proxy

jshunter -l targets.txt -p 127.0.0.1:8080 -s -x -g -F -B -n -o burp_comprehensive.txt

Deep parameter and endpoint discovery

jshunter -l targets.txt -ep -P -PU -L -w 3 -i -j -o endpoint_discovery.json

### Integración Empresarial y Automatización```bash
# CI/CD Security Pipeline Integration
jshunter -f dist/bundle.js -d -s -x -F -j --found-only > security-scan.json

# Comprehensive automated security reporting
jshunter -l production-js.txt -d -s -x -P -g -F -B -C -o enterprise-security-report.csv

# Source map analysis for development security
jshunter -f app.js -m -s -x -F -v -o sourcemap-analysis.json

# Firebase and GraphQL focused assessment
jshunter -l targets.txt -g -F -L -j -o api_security_findings.json

Contribución

¡Agradecemos las contribuciones! Así es como puedes ayudar:

• Reportar errores a través de GitHub Issues
• Sugerir funciones o mejoras
• Mejorar la documentación
• Enviar pull requests con mejoras

Configuración de desarrollo```bash

git clone https://github.com/cc1a2b/jshunter.git cd jshunter go mod tidy go build -o jshunter ./cmd/jshunter

---

## Licencia

JSHunter se publica bajo la **Licencia MIT**. Consulta [LICENSE](https://github.com/cc1a2b/jshunter/blob/master/LICENSE) para más detalles.```
Copyright (c) 2024-2026 Hussain Alsharman
Licensed under MIT License - free for commercial and personal use

Soporte

Si JSHunter te ayuda con tu investigación de seguridad o trabajo profesional: