
jshunter — это инструмент командной строки, предназначенный для анализа JavaScript-файлов и извлечения конечных точек. Этот инструмент специализируется на выявлении конфиденциальных данных, таких как API-эндпоинты и потенциальные уязвимости безопасности, что делает его незаменимым ресурсом для охотников за багами и исследователей безопасности.
# JSHunter
<div align="center">
[](LICENSE)
[](https://golang.org)
[](https://github.com/cc1a2b/jshunter/releases)
[](https://github.com/cc1a2b/jshunter/stargazers)
[](https://github.com/cc1a2b/jshunter/releases)
**Профессиональный инструмент анализа безопасности JavaScript**
*Полное обнаружение конечных точек, выявление конфиденциальных данных и расширенный анализ кода для специалистов по безопасности*
</div>
## О инструменте
**JSHunter** — это комплексный инструмент командной строки для анализа безопасности JavaScript и обнаружения конечных точек. Созданный для специалистов по безопасности, пентестеров и разработчиков, он предоставляет возможности анализа корпоративного уровня с высокоточными алгоритмами обнаружения и профессиональными функциями отчётности.
https://github.com/user-attachments/assets/5a5f60fa-f8dc-4aac-bd06-2e93779f9af4
*JSHunter в действии — реальная запись работы CLI в терминале (все показанные секреты являются фиктивными тестовыми данными)*
---
## Содержание
- [О инструменте](#about)
- [Возможности](#features)
- [Установка](#installation)
- [Быстрый старт](#quick-start)
- [Примеры использования](#usage-examples)
- [Справочник команд](#command-reference)
- [Расширенное использование](#advanced-usage)
- [Участие в разработке](#contributing)
- [Лицензия](#license)
- [Поддержка](#support)
---
## Возможности
### Основные возможности
- **Комплексное обнаружение конечных точек**: автоматически извлекает URL-адреса, конечные точки API и скрытые параметры из файлов JavaScript
- **Расширенный анализ безопасности**: выявляет ключи API, JWT-токены, учётные данные и потенциальные уязвимости с высокой точностью
- **Гибкие методы ввода**: поддерживает URL-адреса, списки файлов, локальные файлы, конвейерный ввод stdin и рекурсивное обнаружение
- **Высокопроизводительная архитектура**: многопоточная параллельная обработка с интеллектуальным ограничением скорости
- **Профессиональные функции скрытности**: поддержка прокси, пользовательские заголовки, ротация user-agent и обнаружение обхода
### Интеллектуальный движок обнаружения
> **Точность корпоративного уровня с расширенными алгоритмами анализа**
- **Умное обнаружение Base64**: высокоточная фильтрация исключает ложные срабатывания на медиаконтент и закодированные данные
- **Профессиональный интерфейс**: терминология корпоративного уровня, документация и комплексные форматы отчётности
- **Контекстно-зависимый анализ**: расширенные алгоритмы отличают реальные токены безопасности от закодированных медиаданных
- **Энтропийный анализ**: математические алгоритмы с высокой точностью выявляют подлинные токены безопасности и учётные данные
### Движок структурного обнаружения
JSHunter разбирает сканируемый JavaScript, а не просто сопоставляет его с шаблонами. Однопроходный сканер ECMAScript классифицирует каждый байт ответа как строковый литерал, шаблонный литерал, комментарий, литерал регулярного выражения или код, и правила обнаружения применяются с учётом этой классификации.
Это важно, потому что регулярное выражение не имеет представления о том, чему оно соответствует. Одни и те же сорок символов base64 означают «учётные данные» внутри строкового литерала, «хэш чанка» внутри минифицированного идентификатора и вообще ничего, когда они разрываются на стыке двух соседних токенов. Знание того, что именно это, заменяет кучу эвристик близости структурным ответом:
- **Ограничение по регионам**: совпадение внутри литерала регулярного выражения — это шаблон, а не значение. Совпадение, пересекающее границу токена, не является единым литералом. Совпадение в коде — это фрагмент идентификатора. Все три случая отбрасываются сразу.
- **Контекст привязки**: вместо сканирования фиксированного окна символов в поисках слова `key`, движок восстанавливает идентификатор или ключ свойства, к которому значение фактически привязано — `const stripeSecret = "..."` читается совсем иначе, чем `{contentHash: "..."}`, и правило, основанное только на форме, теперь требует этой привязки.
- **Наборы родственных ключей**: элементы конфигурации Firebase web config, конфигурации поиска Algolia, конфигурации аналитики Segment и браузерного клиента Supabase распознаются по форме объекта, в котором они находятся.
- **Форма значения**: дайджесты, UUID, прозаический текст, пути, заполнители и base64, декодирующийся в PNG, шрифт, документ JSON или английское предложение, — каждый идентифицируется по своей сути.
- **Классификация раскрытия**: значения, которые издатель публикует намеренно — публикуемые ключи Stripe, публичные токены Mapbox, анонимные JWT Supabase, считываемые из их собственного утверждения `role`, SID Twilio — классифицируются, а не сообщаются как утечки. `--include-public` всё равно сообщает о них.
- **Удивление относительно файла**: модель переходов символов, построенная по сканируемому файлу, оценивает, насколько кандидат не похож на остальную часть этого файла.
Каждое отклонение обусловлено тем, что тело уверенно является JavaScript или JSON. На чём-либо другом — файле `.env`, прозе, чистом HTML — движок предоставляет доказательства, но никогда не подавляет, поэтому неверно классифицированный ввод никогда не сможет скрыть секрет. `--no-structural` полностью отключает этот слой и восстанавливает поведение v0.7.
Находки несут обоснование в виде объекта `evidence` в `--json`, `--ndjson` и в наборе свойств 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` сообщает, что отбросил каждый этап, поэтому конвейер остаётся проверяемым.
### Граф чанков и обнаружение маршрутов
Современное приложение поставляет один входной бандл и несколько сотен лениво
загружаемых чанков, URL которых собираются во время выполнения из манифеста,
встраиваемого бандлером. Ничто не ссылается на них, поэтому краулер их никогда
не видит. `-G` восстанавливает этот манифест и выводит полный список ресурсов
и таблицу клиентских маршрутов:```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
```
Поддерживаемые среды выполнения: webpack 4 и 5 (`__webpack_require__.u`, `miniCssF`,
`jsonpScriptSrc`), манифесты сборки Next.js, Vite и Rollup (`__vite__mapDeps`,
`__vitePreload`), обычный динамический `import()` и таблицы маршрутов из React Router,
Vue Router и Angular. Вывод разделён табуляцией и дедуплицирован, поэтому его можно
напрямую передать обратно в качестве входного списка для последующего сканирования:```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
```
### Профессиональный набор для работы с HTTP и сетями
<details>
<summary><strong>Сетевая конфигурация корпоративного уровня</strong></summary>
**Аутентификация и заголовки:**
- **Пользовательские заголовки** (`-H`): Повторяемые заголовки аутентификации и пользовательские заголовки запросов
- **Управление cookie** (`-c`): Сессионные cookie для доступа к защищённым ресурсам
- **Управление User-Agent** (`-U`): Пользовательские строки UA или ротация на основе файла для скрытности
**Производительность и надёжность:**
- **Ограничение скорости** (`-R`): Настраиваемые задержки между запросами (в миллисекундах) для избежания обнаружения
- **Умные таймауты** (`-T`): Пользовательские настройки таймаутов для различных сетевых условий
- **Интеллектуальные повторы** (`-y`): Автоматический механизм повторных попыток с экспоненциальной задержкой для неудачных запросов
**Профессиональная интеграция:**
- **Поддержка прокси** (`-p`): Полная интеграция с Burp Suite и пользовательскими прокси (HTTP/HTTPS/SOCKS5)
- **Гибкость TLS** (`-k`): Опциональный обход проверки сертификатов для тестовых сред
- **Управление потоками** (`-t`): Настраиваемая обработка параллельных запросов для оптимальной производительности
> **Возможности для специалистов по безопасности**: Разработано для тестирования на проникновение и оценки безопасности
> **Пример**: `jshunter -l targets.txt -p 127.0.0.1:8080 -H "Authorization: Bearer token" -R 1000`
</details>
### Расширенный анализ JavaScript
<details>
<summary><strong>Полный набор для анализа кода и деобфускации</strong></summary>
**Основные инструменты анализа:**
- **Движок деобфускации** (`-d`): Распаковывает минифицированный и обфусцированный JavaScript для глубокого анализа
- **Парсер source map** (`-m`): Извлекает и анализирует исходный код из source map
- **Обнаружение обфускации** (`-z`): Выявляет и классифицирует методы и шаблоны обфускации
**Динамический анализ:**
- **Анализ eval** (`-e`): Анализирует динамическое выполнение кода (`eval()`, `Function()`, генерацию во время выполнения)
**Анализ кода:**
- **Распознавание шаблонов**: Выявляет распространённые JavaScript-фреймворки и библиотеки
- **Анализ структуры кода**: Строит карту архитектуры приложения и потоков данных
- **Контекстно-зависимое обнаружение**: Учитывает контекст кода для снижения ложных срабатываний
> **Профессиональное использование**: Комбинируйте инструменты анализа с обнаружением уязвимостей для максимального покрытия
> **Пример**: `jshunter -u target.js -d -m -e -s -g` (полная деобфускация + анализ безопасности)
</details>
### Набор для анализа безопасности
<details>
<summary><strong>Полный инструментарий для оценки безопасности</strong></summary>
**Основное обнаружение угроз безопасности:**
- **Обнаружение секретов** (`-s`): API-ключи, токены доступа, пароли и жёстко закодированные учётные данные
- **Анализ JWT-токенов** (`-x`): Извлечение, проверка и анализ полезной нагрузки токенов аутентификации
- **Безопасность Firebase** (`-F`): Анализ конфигурации, API-ключей и обнаружение URL баз данных
**Расширенный анализ:**
- **Обнаружение параметров** (`-P`): Скрытые параметры форм, переменные и ключи конфигурации
- **Извлечение URL-параметров** (`-PU`): Расширенный анализ параметров с полным контекстом URL
- **Анализ GraphQL** (`-g`): Обнаружение схемы, извлечение запросов и поиск эндпоинтов
- **Обнаружение обхода WAF** (`-B`): Шаблоны обхода защиты и методы уклонения
**Область и контекст:**
- **Фильтрация внутренних эндпоинтов** (`-i`): Идентификация и классификация приватных/внутренних ресурсов
- **Анализ ссылок** (`-L`): Комплексное извлечение URL и построение карты связей
> **Профессиональный совет**: Комбинируйте флаги для комплексного анализа (например, `jshunter -u target.js -s -x -F -g`)
</details>
### Область и обнаружение
<details>
<summary><strong>Интеллектуальный обход и таргетинг</strong></summary>
- **Рекурсивное обнаружение**: Многоуровневый обход JavaScript-файлов
- **Ограничение по домену**: Фокусировка анализа на определённых доменах
- **Фильтрация по расширению**: Таргетинг на определённые типы JavaScript-файлов
</details>
### Профессиональная отчётность и экспорт
<details>
<summary><strong>Вывод и интеграция корпоративного уровня</strong></summary>
**Основные форматы вывода:**
- **Вывод в консоль**: Цветной вывод в терминал с профессиональным форматированием и чёткой категоризацией
- **Экспорт в файл** (`-o`): Сохранение комплексных результатов в указанные файлы
- **Экспорт в JSON** (`-j`): Структурированный формат данных для автоматизации и программной обработки
- **Экспорт в CSV** (`-C`): Формат, совместимый с электронными таблицами, для управленческой отчётности и анализа
**Профессиональная интеграция:**
- **Экспорт для Burp Suite** (`-n`): Прямая интеграция с Burp Suite Professional для немедленного тестирования
- **Фильтрация по регулярным выражениям** (`-r`): Пользовательское сопоставление шаблонов для целевой фильтрации результатов
- **Подробный анализ** (`-v`): Детализированный вывод анализа с отладочной информацией и контекстом
**Управление результатами:**
- **Режим очистки** (`--found-only`): Скрытие пустых результатов для сфокусированной отчётности по безопасности
- **Тихий режим** (`-q`): Подавление баннера для автоматизированных скриптов и интеграции с CI/CD
> **Рабочий процесс отчётности**: Используйте JSON для автоматизации, CSV для управленческих отчётов, экспорт для Burp для немедленного тестирования
> **Пример**: `jshunter -l targets.txt -s -j -o security-findings.json` (структурированный отчёт по безопасности)
</details>
---
## Установка
### Установка через Go (рекомендуется)```bash
# Install JSHunter
go install -v github.com/cc1a2b/jshunter/cmd/jshunter@latest
# Verify installation
jshunter --help
```
### Сборка из исходного кода```bash
git clone https://github.com/cc1a2b/jshunter.git
cd jshunter
go build -o jshunter ./cmd/jshunter
```
### Системные требования
- **Go 1.22.5+** (для сборки из исходного кода)
- **Linux, macOS или Windows** (64-битная архитектура)
- **Сетевое подключение** для удалённого анализа JavaScript
---
## Быстрый старт
### Базовый анализ```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
```
### Полный анализ безопасности```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
```
---
## Примеры использования```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
```
---
## Справочник команд
Полную справку можно получить в любое время с помощью `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)
Structural Engine:
--no-structural Disable byte-level classification (regex-only, v0.7 behaviour)
--include-public Report values published by design and non-granting identifiers
--min-severity LEVEL Report floor: info|low|medium|high|critical
-G, --chunk-graph Enumerate lazily loaded chunks and client routes
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
```
### Модель достоверности
Каждое совпадение класса секретов оценивается в диапазоне `[0.0, 1.0]`. Оценка начинается с априорного значения для каждого правила и корректируется с учётом:
| Сигнал | Эффект |
|------------------------------------------------|------------------------------|
| Путь источника похож на вендорский/чанковый бандл | −0.15 |
| Окружающий контекст содержит формулировки-заглушки | −0.30 |
| Провайдер-специфичный валидатор пройден | +0.10 |
| Присутствует обязательное контекстное ключевое слово (общее правило) | +0.05 |
| Энтропия Шеннона ≥ 4.5 | +0.05 |
| Разнообразие классов символов ≥ 3 | +0.05 |
| Совпадение в денилисте вендорского шума | отбрасывается до оценки |
| Длина / энтропия ниже порога правила | отбрасывается до оценки |
| Строка является маркером `//# sourceMappingURL=` | отбрасывается до оценки |
Значение по умолчанию `--min-confidence 0.50` отсекает длинный хвост совпадений только по шаблону. Используйте `--min-confidence 0.80` для высокоточного триажа, `--no-fp-filter` для необработанного, нефильтрованного вывода.
### Валидаторы провайдеров
Валидатор — это проверка согласованности для каждого правила, которая запускается *после* совпадения с регулярным выражением.
Это самая сильная защита от ложных срабатываний: случайная строка, которая
совпала по форме, всё равно должна пройти контрольную сумму, структурное декодирование или
доказательство длины/набора символов, прежде чем она будет зарегистрирована (а прохождение даёт `+0.10`).
| Провайдер | Валидатор |
|----------|--------------------------------------------------------------------------|
| AWS | Семейство префиксов (`AKIA/ASIA/A3T…`) + 16-символьное тело base32 |
| Stripe | Семейство ключей (`sk/rk/pk_live/test_`) и base62-тело вебхука `whsec_` |
| GitHub | Контрольная сумма CRC32 base62, проверенная против случайного тела |
| OpenAI | Префикс семейства + окно длины (`sk-/sk-proj-/sk-svcacct-`) |
```
---
[Read more](https://github.com/cc1a2b/jshunter)