OSINT Guard Bot
Telegram-бот для OSINT анализа доменов, телефонных номеров и BIN банковских карт с интеллектуальной системой оценки рисков.
OSINT Guard Bot - это автоматизированный инструмент для проверки безопасности и анализа рисков на основе открытых источников информации (OSINT). Бот выполняет комплексную проверку доменов, телефонных номеров и BIN кодов банковских карт, предоставляя детальную оценку рисков по шкале 0-10 с понятными объяснениями.
Ключевые особенности:
- Unified Risk Scoring - единая система оценки 0-10 для всех типов проверок
- Explainability - детальное объяснение каждого балла риска
- Визуальная индикация - цветовое обозначение уровня риска
- Retry механизм - автоматические повторные попытки при ошибках API
- Подробное логирование - полная история всех операций
Структура проекта
osint_guard_bot/ │ ├── main.py # Точка входа приложения ├── config.py # Конфигурация бота ├── requirements.txt # Зависимости Python │ ├── utils/ # Общие утилиты │ ├── risk_types.py # Типы для системы оценки рисков │ ├── risk_scoring.py # Логика подсчёта unified score │ ├── retry.py # Механизм повторных попыток │ ├── cache.py # TTL кеширование │ └── domain_normalizer.py # Нормализация доменов │ ├── domain_scanner/ # Модуль проверки доменов ├── url_scanner/ # Модуль проверки ссылок (v2.0) ├── email_scanner/ # Модуль проверки email (v2.0) ├── phone_scanner/ # Модуль проверки телефонов ├── ip_scanner/ # Модуль проверки IP (v2.0) ├── username_scanner/ # Модуль поиска никнеймов (v2.0) ├── bin_scanner/ # Модуль проверки BIN ├── wallet_scanner/ # Модуль проверки криптокошельков (v2.0) ├── leak_scanner/ # Модуль проверки утечек (v2.0) ├── exif_scanner/ # Модуль EXIF метаданных (v2.0) ├── qr_scanner/ # Модуль QR кодов (v2.0) │ ├── handlers/ # Обработчики команд Telegram ├── keyboards/ # Inline-клавиатуры ├── middlewares/ # Rate limiting, логирование ├── services/ # Сервисы внешних API └── tests/ # Тесты (330+)
Команды бота
/start, /menu, /help - главное меню с навигацией /scan <домен> - проверка домена (WHOIS/DNS/SSL) /url <ссылка> - проверка URL, разворот сокращенных ссылок /email - проверка email /phone <номер> - проверка телефона /ip <адрес> - проверка IP адреса /user <никнейм> - поиск никнейма по платформам /bin <6-8 цифр> - проверка BIN карты /wallet <адрес> - проверка криптокошелька /leak <email/телефон> - проверка в базах утечек
Фото: отправьте изображение для EXIF-анализа QR: отправьте фото с подписью /qr
Автоопределение: можно отправить данные без команды - бот определит тип автоматически.
Инструкция по запуску
Предварительные требования
- Python 3.11+
- Telegram Bot Token
Установка
cd osint_guard_bot pip install -r requirements.txt
Конфигурация
Создайте файл .env в корне проекта: BOT_TOKEN=your_telegram_bot_token_here VERIPHONE_API_KEY=your_veriphone_api_key_here (опционально)
Запуск
python main.py
INFO | Bot starting polling... - сигнализирует об успешном запуске.
Система оценки рисков
Шкала 0-10
- 0-3 Низкий риск - явных признаков угроз нет
- 4-6 Средний риск - обнаружены подозрительные признаки
- 7-10 Высокий риск - серьёзные признаки недобросовестности
Тестирование
pytest # все тесты pytest tests/ -v # подробный вывод pytest --cov=. # с покрытием
Update v2.0
Добавлено:
- URL Scanner - проверка ссылок, разворот сокращенных URL, детекция фишинга
- Email Scanner - валидность, disposable email, возраст домена, MX записи
- IP Scanner - геолокация, VPN/Proxy/Tor детекция, репутация в blacklists
- Username Scanner - поиск никнейма по 20+ платформам
- Crypto Wallet Scanner - Bitcoin, Ethereum, USDT, Solana, проверка в scam-базах
- Leak Scanner - проверка email/телефона в базах утечек данных
- EXIF Scanner - извлечение метаданных из фото (GPS, камера, дата)
- QR Scanner - декодирование QR кодов, проверка URL на фишинг, WiFi, крипто
- Auto-detect - автоматическое определение типа ввода (домен, email, IP, телефон, крипто)
- Inline-меню - навигация с кнопками, справка по каждой функции
- Rate limiting - защита от спама для всех команд и медиа
- 330+ тестов - полное покрытие всех модулей