iKy

Описание

iKy — это OSINT-инструмент, который собирает информацию по адресу электронной почты или другим селекторам и отображает результаты в визуальном интерфейсе.

(ожидает обновления: отражает предыдущий интерфейс)
Видеодемонстрация

Установка

Предварительные требования

Docker
Docker Compose (входит в состав Docker Desktop)
(Опционально) just — запускатель задач

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

git clone https://gitlab.com/kennbroorg/iKy.git
cd iKy
just build
just up

Откройте браузер по адресу http://localhost:4300

Чтобы остановить все сервисы:

just down

just up запускает backend, iky-frontend и redis. Другие сервисы по умолчанию не запускаются.

Без Docker (нативно)

Если вы не можете запустить Docker, iKy может работать нативно: Caddy обслуживает предварительно собранный фронтенд, а Redis + Celery + Uvicorn запускаются как локальные процессы. Требуется redis-server, Python 3.12, curl и tar на хосте (Caddy загружается автоматически).

just setup          # создать виртуальное окружение
just up-native      # установить зависимости, загрузить Caddy + фронтенд, запустить всё

Откройте браузер по адресу http://localhost:4300. Остановите с помощью Ctrl-C или just down-native.

Фронтенд загружается из последнего релиза GitHub — сборка Node не требуется. В нативном режиме tor не запускается; он нужен только для модуля darkweb.

Архитектура

Сервис	Стек	Порт
backend	FastAPI 0.115 + Celery 5.6	5000
iky-frontend	Angular 21 + nginx	4300
redis	Redis 7	56379 (хост)
tor	SOCKS5-прокси (модуль darkweb)	внутренний

Модули

iKy управляет 26 модулями через backend/module_registry.py:

Категория	Модули
Социальные сети	twitter, linkedin, instagram, tiktok, mastodon, twitch, reddit
Личность / имя пользователя	github, gitlab, keybase, sherlock, socialscan, holehe, usersearch, skype
Знакомства / платежи	tinder, venmo
Музыка	spotify
Репутация / брокеры данных	peopledatalabs, emailrep, fullcontact
Утечки / взломы	leaks, leaklookup, darkweb, hudsonrock
Поиск	search

API-ключи

После загрузки приложения в браузере введите свои API-ключи на панели настроек. Ниже приведена полная таблица полей из backend/factories/apikeys_default.json:

Модуль	Статус	Поле в apikey	Как получить
LinkedIn	🆗 🍪	`linkedin_cookies` (или устаревшие `linkedin_li_at` / `linkedin_JSESSIONID`)	`just cookies-grab linkedin linkedin.com` или `just cookies-import linkedin <файл>`
Twitter	🆗 🍪	`twitter_cookies`	`just cookies-grab twitter x.com`
TikTok	🆗 🍪	`tiktok_cookies`	`just cookies-grab tiktok tiktok.com`
PeopleDataLabs	🆗	`peopledatalabs_key`	🆓 Бесплатный API — вики
Emailrep	🆗	`emailrep_key`	🆓 Бесплатный API — вики
Leaklookup	🆗	`leaklookup_key`	🆓 Бесплатный API — вики
Spotify	🆗	`spotify_client_id` / `spotify_client_secret`	🆓 Бесплатный API — вики
Twitch	🆗	`twitch_client_id` / `twitch_client_secret`	🆓 Бесплатный API — вики
CSE (Google)	🆗	`cse_api_key` / `cse_cx`	🆓 Бесплатный API — вики
Brave	🆗	`brave_key`	🆓 Бесплатный API
Instagram	⚠️	`instagram_user` / `instagram_pass`	На пересмотре
Fullcontact	🛑	`fullcontact_api`	Прекращено
HaveIBeenPwned	🛑	`haveibeenpwned_key`	Прекращено

API, помеченные 🍪, используют куки сессии браузера; остальные — токены сервисов.

Куки сессии

Некоторые модули (LinkedIn, Twitter, TikTok) требуют куки сессии из вашего браузера. Куки сохраняются в backend/cookies/ (монтируются в контейнер как /app/cookies) и сохраняются между перезапусками. Есть два способа их загрузить, оба через just.

Куки — это личные токены сессии: не делитесь ими и не добавляйте их в репозиторий (backend/cookies/ игнорируется git'ом).

Вариант A: Импорт экспортированных из браузера

Экспортируйте куки сайта с помощью расширения, например Cookie-Editor, в JSON-файл и импортируйте его:

just cookies-import linkedin ~/Downloads/linkedin_cookies.json

Вариант B: Автоматическое извлечение из браузера

Извлекает куки напрямую из вашего локального браузера. Перед запуском закройте браузер (открытый браузер блокирует свою базу куки):

# Попробовать все установленные браузеры (firefox, chrome, brave, edge)
just cookies-grab linkedin linkedin.com

# Или указать конкретный
just cookies-grab linkedin linkedin.com brave

Команда сообщает, браузер за браузером, что удалось прочитать, а что нет, и записывает файл только если найдены необходимые модулю куки. Например, для LinkedIn требуются li_at и JSESSIONID.

iKy

Популярное

iKy