JSHunter

À propos

JSHunter est un outil complet en ligne de commande pour l'analyse de sécurité JavaScript et la découverte d'endpoints. Conçu pour les professionnels de la sécurité, les testeurs d'intrusion et les développeurs, il offre des capacités d'analyse de niveau entreprise avec des algorithmes de détection à haute précision et des fonctionnalités de reporting professionnelles.

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

JSHunter en action — une capture réelle du terminal de la CLI (chaque secret affiché est une donnée de test fictive)

Table des matières

• À propos
• Fonctionnalités
• Installation
• Démarrage rapide
• Exemples d'utilisation
• Référence des commandes
• Utilisation avancée
• Contribution
• Licence
• Support

Fonctionnalités

Capacités principales

• Découverte complète d'endpoints : Extraction automatique des URLs, endpoints API et paramètres cachés à partir de fichiers JavaScript
• Analyse de sécurité avancée : Identification des clés API, jetons JWT, identifiants et vulnérabilités potentielles avec une haute précision
• Méthodes d'entrée flexibles : Prise en charge des URLs, listes de fichiers, fichiers locaux, flux stdin et découverte récursive
• Architecture haute performance : Traitement concurrent multi-thread avec limitation de débit intelligente
• Fonctionnalités furtives professionnelles : Prise en charge des proxys, en-têtes personnalisés, rotation des user-agents et détection de contournement

Moteur de détection intelligent

Précision de niveau entreprise avec des algorithmes d'analyse avancés

• Détection intelligente Base64 : Filtrage haute précision éliminant les faux positifs issus de contenus médiatiques et de données encodées
• Interface professionnelle : Terminologie, documentation et formats de rapport complets adaptés à l'entreprise
• Analyse contextuelle : Des algorithmes avancés distinguent les jetons de sécurité réels des données médiatiques encodées
• Analyse d'entropie : Des algorithmes mathématiques identifient avec précision les jetons de sécurité et identifiants authentiques

Suite HTTP et réseau professionnelle

Analyse JavaScript avancée

Suite d'analyse de sécurité

Portée et découverte

Suite professionnelle de reporting et d'export

Installation

Installation via Go (recommandée)```bash

Install JSHunter

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

Verify installation

jshunter --help

### Compilation à partir des sources```bash
git clone https://github.com/cc1a2b/jshunter.git
cd jshunter
go build -o jshunter ./cmd/jshunter

Configuration système requise

• Go 1.22.5+ (pour la compilation à partir des sources)
• Linux, macOS ou Windows (architecture 64 bits)
• Connectivité réseau pour l'analyse JavaScript à distance

Démarrage rapide

Analyse de base```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

### Analyse de sécurité complète```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

Exemples d'utilisation```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

---

## Référence des commandes

Obtenez l'aide complète à tout moment avec `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

Modèle de confiance

Chaque correspondance de classe secret est notée dans [0.0, 1.0]. Le score part d'un a priori propre à chaque règle et est ajusté par :

Le --min-confidence 0.50 par défaut filtre la longue traîne des correspondances basées uniquement sur les motifs. Utilisez --min-confidence 0.80 pour un tri haute précision, --no-fp-filter pour une sortie brute et non filtrée.

Validateurs de fournisseurs

Un validateur est un contrôle de cohérence propre à chaque règle qui s'exécute après la correspondance regex. C'est la défense la plus solide contre les faux positifs : une chaîne aléatoire qui correspond par hasard à la forme doit encore survivre à une somme de contrôle, à un décodage structurel ou à une preuve de longueur/jeu de caractères avant d'être signalée (et réussir ajoute +0.10).

Couverture des fournisseurs

Le registre organisé fournit plus de 85 détecteurs couvrant le cloud et les gestionnaires de secrets (AWS, Azure, GCP/PKCS#8, HashiCorp Vault, Terraform, Fly.io, Tailscale), le contrôle de version et CI/CD (GitHub, GitLab, Docker Hub, Atlassian, Sentry, CircleCI, Buildkite), les paiements (Stripe, Square, Braintree, Plaid), les fournisseurs IA/LLM (OpenAI, Anthropic, Groq, Perplexity, Replicate, OpenRouter, Fireworks, HuggingFace), la messagerie (Slack, Discord, Telegram, Twilio, Intercom, SendGrid, Mailgun), SaaS et bases de données (Notion, Airtable, Figma, Postman, Databricks, PlanetScale, Grafana, New Relic, Dropbox, RubyGems, Supabase), et le matériel PKI (clés privées RSA/EC/DSA/OpenSSH/PGP/PKCS#8, .ppk PuTTY, URI de connexion de bases de données). Exécutez jshunter --list-rules pour le tableau faisant autorité et jshunter --explain <rule_id> pour le motif, le validateur et les fixtures d'une règle donnée. Les formes « hash nu » sans préfixe ne sont fournies que lorsqu'un validateur structurel ou une porte de contexte obligatoire peut les maintenir sans faux positifs.

Utilisation avancée

Évaluation de sécurité professionnelle```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

### Intégration Entreprise & Automatisation```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

Contribution

Nous accueillons les contributions ! Voici comment vous pouvez aider :

• Signaler des bugs via GitHub Issues
• Suggérer des fonctionnalités ou des améliorations
• Améliorer la documentation
• Soumettre des pull requests avec des améliorations

Configuration de développement```bash

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

---

## Licence

JSHunter est publié sous la **licence MIT**. Voir [LICENSE](https://github.com/cc1a2b/jshunter/blob/master/LICENSE) pour plus de détails.```
Copyright (c) 2024-2026 Hussain Alsharman
Licensed under MIT License - free for commercial and personal use

Support

Si JSHunter vous aide dans vos recherches en sécurité ou votre travail professionnel :