🕵️‍♂️ WhoCord v1.1

Превратите любое имя пользователя, email, домен, номер телефона, изображение, URL или произвольную строку в полный профиль личности.

WhoCord — это модульная платформа для OSINT-расследований, которая запускает десятки инструментов с открытым исходным кодом, строит граф знаний, обнаруживает корреляции и создаёт HTML-отчёт в тёмной теме с улучшениями на основе ИИ — всё это транслируется в реальном времени в современный React-дашборд.

⚡ Возможности

• 8 модулей расследования – Имя пользователя / Вручную, Discord, Email, Домен, Телефон, Изображение, URL, Проверка данных (автоопределение).
• Разрешение Discord-ссылок – извлекает и разрешает отслеживающие ссылки Instagram, TikTok, Facebook и Twitter, опубликованные целевым пользователем.
• Полный конвейер идентификации – имена, email, местоположения, данные об утечках, история GitHub, метаданные аватаров и информация об аккаунтах Google (GHunt).
• Email-разведка – Holehe (регистрации на сайтах), h8mail, HIBP, EmailRep, GHunt, поиск по email в Blackbird, MOSINT (флаги социальных аккаунтов).
• Исследование доменов – WHOIS, DNS-записи, SSL-сертификаты, IP-геолокация, перебор поддоменов, theHarvester.
• Исследование телефонов – проверка номера, определение оператора, PhoneInfoga OSINT.
• Анализ изображений – EXIF-метаданные, перцептивный хэш, обратный поиск изображений, извлечение текста OCR.
• Анализ URL – HTTP-метаданные, трассировка редиректов, метаданные страницы, теги Open Graph, проверка Safe Browsing, снимок Wayback.
• Проверка данных – вставьте что угодно (email, домен, телефон, URL, имя пользователя) — WhoCord автоматически определит тип.
• Граф знаний и корреляции – 5 детекторов (повторное использование аватара, кластер «email-платформа», варианты имени пользователя, связь «имя-email», согласованность местоположения).
• Отчёты, создаваемые ИИ – LLaMA 3.3 (через Groq) создаёт структурированное повествование и сводку личности.
• HTML-отчёт в тёмной теме – сворачиваемые карточки платформ, отображение аватаров, теги утечек, сводные под-отчёты, технические данные.
• Живая SSE-трансляция – наблюдайте за расследованиями в реальном времени со списком этапов, карточками находок и журналом консоли.
• Система сводных отчётов (Pivot) – рекурсивное исследование обнаруженных email/имён пользователей с модальным окном подтверждения.
• Безопасное хранение токенов – API-ключи хранятся в системной связке ключей ОС, никогда в открытом виде.
• Веб-дашборд – запускайте расследования из браузера, включайте/отключайте инструменты, управляйте токенами, просматривайте историю.

🚀 Быстрый старт (рекомендуется)

1. Скачайте портативный zip со страницы релизов (Linux 64-бит, ~500 МБ).
2. Распакуйте архив в любое место:
   root@kitploit:~

   unzip WhoCord.zip -d WhoCord
   

3. Запустите веб-дашборд:
   root@kitploit:~

   cd WhoCord
   ./run.sh
   

   (браузер откроется автоматически)

Никакой Python, pip или установки инструментов не требуется – всё уже включено.

📦 Установка (из исходников – для разработчиков)

1. Клонируйте репозиторий

git clone https://github.com/Siv-nick/WhoCord.git
cd WhoCord

2. Создайте виртуальное окружение Python

python3 -m venv venv
source venv/bin/activate   # Linux / macOS

3. Установите WhoCord и его Python-зависимости

pip install -e .

4. Установите внешние инструменты командной строки (большинство через pip)

Все необходимые инструменты можно установить одной командой pip install:

# Username search tools
pip install sherlock-project maigret naminter linkook

# Email intelligence tools
pip install holehe h8mail theHarvester

# GitHub & Google tools
pip install gitfive ghunt

# Phone & image analysis
pip install phoneinfoga pillow imagehash pytesseract

# Domain investigation
pip install dnspython

5. Установите Blackbird (поиск email и имён пользователей на 600+ сайтах)

git clone https://github.com/p1ngul1n0/blackbird
cd blackbird
pip install -r requirements.txt
cd ..

Необходимый файл данных (wmn-data.json) автоматически загружается при первом использовании. Если это не удалось, скачайте его вручную с WhatsMyName и поместите в blackbird/data/.

6. Установите системный WHOIS (требуется для исследования доменов)

sudo apt install whois          # Debian/Ubuntu
# brew install whois            # macOS

7. (Необязательно) Авторизуйте GHunt для разведки аккаунтов Google

ghunt login

Следуйте инструкциям для авторизации с вашим аккаунтом Google.

8. Соберите фронтенд (требуется для установки из исходников)

Веб-дашборд требует скомпилированный React-фронтенд. Убедитесь, что у вас установлены Node.js 18+ и npm, затем выполните:

cd frontend
npm install
npm run build
cd ..

Это создаст папку frontend/dist/, которую Flask автоматически обслуживает.

9. Запустите веб-дашборд

python web_app.py

Затем откройте http://127.0.0.1:5000.
Или используйте запуск в один клик: ./run.sh.

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

Веб-дашборд (основной интерфейс)

Дашборд предлагает восемь модулей расследования:

Страница живого расследования показывает:

• Список этапов со статусом в реальном времени
• Карточки находок (email, имена, утечки, корреляции)
• Журналы консоли (необработанный вывод инструментов)
• Модальное окно подтверждения сводного отчёта (если включено)

Страница истории – список всех прошлых расследований со ссылками на отчёты и JSON-разведданные.

Страница конфигурации – управление API-токенами, включение/отключение инструментов, настройка параметров сводных отчётов, обновление инструментов.

Интерактивное меню (устаревший CLI)

discord-osint

Затем используйте нумерованное меню для включения инструментов, установки токенов и запуска расследований.

Режим командной строки (ограничен ручным/Discord)

discord-osint --mode manual --target someusername --output html --debug

📁 Выходные файлы

Все результаты сохраняются в investigation_cache/:

Разделы HTML-отчёта

• Идентичность (хэндл Discord, ключи к имени, местоположение, язык, оценки уверенности)
• Сводка личности (ИИ)
• Социальные профили (сворачиваемые карточки платформ с аватарами, биографиями, дополнительными полями)
• Email-разведка (теги утечек, флаги MOSINT)
• Анализ разведданных (статистика графа, повествование, корреляции)
• Сводные под-расследования
• Технические данные (WHOIS, DNS, SSL, IP-геолокация, поддомены, theHarvester, телефон, анализ URL, GHunt)

🛠️ Инструменты и технологии

WhoCord интегрирует следующие OSINT-проекты с открытым исходным кодом:

🔄 Обновления

Смотрите CHANGELOG.md для истории версий.

🔒 Безопасность и конфиденциальность

• Токены никогда не хранятся в открытом виде – они хранятся в системной связке ключей ОС.
• config.json содержит только нечувствительные переключатели.
• Все данные расследований остаются на вашей машине в папке investigation_cache/.

⚠️ Отказ от ответственности

WhoCord предназначен только для образовательных целей и авторизованного тестирования безопасности.
Не используйте его для слежки, домогательств или нарушения чьей-либо конфиденциальности.
Автор не несёт ответственности за неправомерное использование.

📄 Лицензия

Лицензия MIT