BugTraceAI-CLI
Агентный сканер веб-приложений: терминал, шесть стадий от разведки до отчета, проверка находок в браузере, REST и MCP
- 183 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Стадия Exploit отправляет атакующие запросы к цели, а скан чужого приложения без разрешения владельца нарушает закон.
- Ключ провайдера моделей и учетные данные цели (токены, YAML входа с TOTP) попадают в сессию скана, а часть данных уходит внешнему провайдеру.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/BugTraceAI/BugTraceAI-Launcher/main/install.sh | bashУниверсальный Launcher: в нем выбирают только модуль CLI, вводят ключ провайдера и режим установки. Скрипт запускается из сети, его стоит просмотреть заранее.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Стадия Exploit отправляет атакующие запросы к цели, а скан чужого приложения без разрешения владельца нарушает закон.
- Ключ провайдера моделей и учетные данные цели (токены, YAML входа с TOTP) попадают в сессию скана, а часть данных уходит внешнему провайдеру.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
BugTraceAI-CLI — движок сканирования веб-приложений для авторизованных тестов на проникновение. Скан идет по шести стадиям: Recon, Discovery, Strategy, Exploit, Validate и Report. Языковая модель направляет расследование, а специалисты проверяют SQL-инъекции, XSS, SSRF, IDOR, LFI, RCE, шаблонные инъекции, XXE, JWT и редиректы. Находки подтверждаются инструментами и проверкой в браузере. Сканом управляют из терминального интерфейса: вкладки Pipeline, Findings, Agents, Timeline и Logs, настройка провайдера моделей на F7 и входа на цель на F8 (Bearer-токен или YAML для входа с TOTP). Для скриптов есть команды `./bugtraceai-cli scan <url>` и `serve`, а `./bugtraceai-cli mcp` отдает управление сканом MCP-клиентам. На выходе получаются `final_report.md`, `validated_findings.json`, `engagement_data.json` и `report.html`.
Для кого. Специалистам по безопасности и охотникам за уязвимостями, которые тестируют приложения с разрешения владельца и хотят автоматизировать разведку и проверку находок.
Подходит, если
- Согласованный пентест начинается с разведки: движок обходит сайт и находит точки входа.
- Участник багбаунти проверяет свою цель по классам уязвимостей: SQL-инъекции, XSS, SSRF, IDOR и JWT.
- Скан запускают из агента через MCP и просят вернуть только подтвержденные находки.
- Цель закрыта логином: задают Bearer-токен или YAML со входом и TOTP, и скан идет под тестовым пользователем.
- Результаты скана передают команде в виде `report.html` и JSON.
Не подходит, если
- Цель вам не принадлежит и письменного разрешения владельца нет: авторы допускают скан только авторизованных приложений.
- Стадия Exploit отправляет атакующие запросы, и для боевой системы без согласованного окна это опасно.
- Ключа провайдера моделей нет: без него реальный скан не запустится, работает только демонстрация.
- Ждете устоявшийся продукт: публичная версия остается бетой.
Пример запроса к агенту
Запусти `./bugtraceai-cli scan https://staging.example.com` для тестового стенда, на проверку которого есть разрешение, и дай подтвержденные находки с доказательствами.Ограничения
Публичная версия остается бетой. Для реального скана нужен ключ провайдера моделей (OpenRouter, Anthropic, Z.ai или Bedrock), поэтому часть данных цели уходит внешнему сервису. Требуется Python 3.10 или новее, а некоторые специализированные инструменты при локальном скане запускают Docker. Скан допустим только против приложений, на проверку которых у вас есть разрешение. Профиль `api` в Docker поднимает REST и MCP на портах, записанных в `.env`, а MCP по умолчанию работает по stdio.
Как отключить. Удалите каталог с клонированным репозиторием и регистрацию команды `btai`, если ставили ее глобально. Ключи провайдера лежат в локальном `.env`, их тоже стоит убрать и отозвать у провайдера.
Частые вопросы
Как установить BugTraceAI-CLI?
Проще всего через Launcher: `curl -fsSL https://raw.githubusercontent.com/BugTraceAI/BugTraceAI-Launcher/main/install.sh | bash`. Прямой вариант: клонировать репозиторий и выполнить `./scripts/install-runtime.sh --interface tui --runtime local --global yes`, после чего доступна команда `btai`.
Как открыть терминальный интерфейс?
Запустите `./bugtraceai-cli` или `btai`, настройте провайдера клавишей F7, укажите цель и нажмите Start. Без ключа провайдера можно посмотреть демонстрацию командой `./bugtraceai-cli tui --demo`.
Как подключить MCP?
Команда `./bugtraceai-cli mcp` запускает сервер по stdio. Для HTTP и SSE добавьте `--sse --host 127.0.0.1 --port 8001`: клиент подключается к `http://localhost:<MCP_PORT>/sse`.
Как передать скану вход на цель?
В интерфейсе откройте Auth на F8 и введите Bearer-токен или YAML в формате, совместимом с WEB, с необязательным TOTP. Для скриптов служит флаг `--auth-config auth-config.yaml` у команды `scan`.
Куда сохраняются отчеты?
В настроенный каталог отчетов ложатся `final_report.md`, `validated_findings.json`, `engagement_data.json` и `report.html`. Находки из интерфейса выгружает в JSON клавиша Ctrl+E или команда `/export`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСтатический сканер уязвимостей в коде ИИ-агентов и конфигурациях MCP с 66 правилами по OWASP Agentic Top 10
Набор для авторизованного багбаунти: 50 субагентов, 26 команд и 2 MCP-сервера площадок багбаунти для Claude Code, Codex и еще пяти агентов
Расширение Burp Suite с ИИ: разбирает запросы, подключает сканеры и открывает Burp по MCP для Claude Desktop, Claude Code, Codex и Gemini CLI
Сканер безопасности для агентов: проверяет код, MCP-серверы, промпты и пакеты, выдуманные моделью, и ставит оценку от A до F.
MCP-сервер собирает вашу историю HackerOne и 3600 раскрытых отчетов в базу, по которой агент планирует работу над программой
Tracekit проверяет вызовы инструментов ИИ-агента до выполнения и пишет подписанный журнал, правку которого видно при проверке
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| BugTraceAI-CLI (эта карточка) | нет | 183 | ||
| Strix | нет | 74 108 | набор скиллов, через который агент запускает пентест Strix и встраивает проверку в CI; BugTraceAI-CLI сам ведет скан по шести стадиям со своим терминальным интерфейсом | |
| Pentest Agent Suite | нет | ключ необязателен | 1 060 | набор субагентов и команд для багбаунти внутри Claude Code; BugTraceAI-CLI отдельный движок скана с REST и MCP |
Коротко о README
На странице проекта установка описана тремя путями (Launcher, прямой скрипт, подсказка для агента), показывает горячие клавиши терминального интерфейса и режимы API и MCP. Подробности по профилям и авторизации вынесены в `INSTALLATION.md`.