Инструментарий для сбора информации и разведки на основе Python

О проекте

Argus — это универсальный инструментарий на основе Python, предназначенный для оптимизации процесса сбора информации и разведки. Он объединяет чистый, интуитивно понятный интерфейс и широкий набор надёжных модулей, позволяя аналитикам эффективно оценивать сети, веб-приложения и среды безопасности с последовательностью и точностью.

⚠️ ВНИМАНИЕ: ПРАВОВАЯ ОГОВОРКА

Этот инструмент предназначен только для образовательного и этичного использования. Автор не несёт ответственности за любое незаконное использование или злоупотребление этим инструментом. Пользователи несут полную ответственность за свои действия и должны убедиться, что у них есть явное разрешение на сканирование целевых систем.

👀 Скриншоты

Посмотрите Argus в действии: Посмотрите Argus в действии:

⚙️ Установка

Быстрый старт

Вариант 1: Без установки (запуск напрямую)

git clone https://github.com/jasonxtn/argus.git
cd argus
pip install -r requirements.txt
python -m argus

Вариант 2: Использование pip

pip install argus-recon
argus

Вариант 3: Полная установка

git clone https://github.com/jasonxtn/argus.git
cd argus
chmod +x install.sh && ./install.sh
python -m argus

Вариант 4: Docker

git clone https://github.com/jasonxtn/argus.git
cd argus
docker build -t argus-recon:latest .
docker run -it --rm -v $(pwd)/results:/app/results argus-recon:latest

📖 Использование

Начало работы

1. Запустите Argus:

   root@kitploit:~

   argus
   
   # if running from folder: python -m argus
   

2. Просмотрите доступные модули:

   root@kitploit:~

   argus> modules
   

3. Выберите модуль:

   root@kitploit:~

   argus> use 1
   

4. Установите цель и параметры:

   root@kitploit:~

   argus> set target example.com
   argus> set threads 10
   

5. Запустите модуль:

   root@kitploit:~

   argus> run
   

Шпаргалка по командам

📋 Все модули (всего 135)

🛠️ Конфигурация

Настройка API-ключей

Расширьте функциональность, настроив API-ключи в config/settings.py или в виде переменных окружения:

export VIRUSTOTAL_API_KEY="your_key_here"
export SHODAN_API_KEY="your_key_here"
export CENSYS_API_ID="your_id_here"
export CENSYS_API_SECRET="your_secret_here"
export GOOGLE_API_KEY="your_key_here"
export HIBP_API_KEY="your_key_here"

Проверка статуса API:

argus> show api_status

Параметры конфигурации

Отредактируйте config/settings.py для настройки:

• Тайм-аутов запросов по умолчанию и логики повторных попыток
• Ограничений потоков и параметров параллелизма
• Настроек экспорта (вывод в TXT/CSV)
• Уровней и назначения логирования
• Строк User-Agent и заголовков

🔄 История изменений

Версия 2.0 (текущая)

Крупный рефакторинг: полный редизайн CLI и расширение модулей

• Новый интерактивный CLI — полноценный интерфейс командной строки с более чем 25 командами
• 135 модулей — расширено с 50 модулей
• Улучшенный интерфейс — профессиональное форматирование и отслеживание прогресса
• Многопоточность — улучшенная производительность за счёт параллельного выполнения
• Интеграции с API — поддержка Shodan, VirusTotal, Censys, SSL Labs
• Возможности экспорта — форматы вывода TXT, CSV, JSON
• Система конфигурации — профили, настройки и управление API-ключами
• Обнаружение модулей — поиск, просмотр и избранные модули
• Пакетные операции — одновременный запуск нескольких модулей

Версия 1.x (устаревшая)

Оригинальный простой интерфейс на основе чисел

• Простая система ввода чисел (1-50)
• Базовые 50 модулей разведки
• Только текстовый вывод в консоль
• Фиксированные настройки конфигурации

Примечание: Версия 2.0 вносит критические изменения. Пользователям необходимо освоить новые команды CLI вместо прежней системы на основе чисел.

⭐️ Поддержите проект

Если этот инструмент был вам полезен, пожалуйста, поставьте нам звезду на GitHub! Ваша поддержка много значит для нас и помогает другим узнать о проекте.

Проблемы и отчёты об ошибках

• Проверьте существующие проблемы перед созданием отчёта
• Предоставьте подробные шаги воспроизведения
• Приложите информацию о системе и журналы ошибок