IG-Detective 🕵️‍♂️📸

Создано @shredzwho | 💖 Спонсировать этот проект

IG-Detective — это высокопроизводительный инструмент OSINT (разведки по открытым источникам) на Python для Instagram. Он предоставляет премиальную интерактивную оболочку для глубокого анализа аккаунтов Instagram, извлечения истории местоположений, картографирования взаимодействий и создания автоматизированных отчётов.

[!WARNING] Отказ от ответственности: Этот инструмент предназначен только для образовательных и исследовательских целей. Используйте его ответственно и в соответствии с Условиями использования Instagram. Автор не несёт ответственности за любое неправомерное использование.

---

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

🛡️ Обход и скрытность (Продвинутые)

• Подмена отпечатка TLS: Использует безголовый браузер Playwright chromium с playwright-stealth для имитации реального окружения, полностью обходя ограничения Cloudflare и CDN.
• Глубокий резервный обход: Автоматически переключается на неаутентифицированную загрузку в безголовом браузере, если аутентифицированная сессия получила теневой бан (например, HTTP 401/429/400), пропуская куки и подделывая заголовки для имитации чистого соединения.
• Пуассоновский джиттер: Случайные задержки между запросами, имитирующие естественное поведение пользователя.

⚡ Производительность и оптимизация

• Настройка памяти безголового браузера: Урезанная конфигурация Playwright, которая явно отключает загрузку тяжёлых визуальных ресурсов (изображения, шрифты, стили) через перехват маршрутов для достижения сверхбыстрой скорости запросов.
• Асинхронный экспорт данных: Использует параллельную загрузку ThreadPool для команды архивирования data, значительно ускоряя репликацию полного медиа-профиля.

🔍 Базовая разведка

• Информация о пользователе: Полные детали профиля (ID, био, подписчики, статус бизнес-аккаунта).
• Подписчики/Подписки: Список и экспорт социальной сети цели.
• Анализ постов: Детальная разбивка недавнего контента, лайков и комментариев.

📍 Продвинутый OSINT

• Интерактивное геопространственное картографирование: Извлекает GPS-координаты из постов и генерирует interactive_map.html с читаемыми адресами и кликабельными метками с помощью Folium.
• Анализ социальной сети (sna): Картографирует взаимодействия для выявления «Ближнего круга» — топ-10 пользователей, наиболее тесно связанных с целью.
• Профилирование временной активности (temporal): Использует кластеризацию DBSCAN для определения «окна сна» цели и прогнозирования её основного часового пояса.
• Извлечение историй (stories): Получение активных URL историй.

🔬 Исследовательские криминалистические модули (Передовые)

• Восстановление аккаунта (recovery): Запуск процесса сброса пароля для раскрытия маскированных контактных подсказок для административной верификации email.
• Анализ совместных посещений (intersect): Выявление физических точек встречи путём перекрёстного анализа пересечений GPS/времени между двумя целями.
• Стилометрия (stylometry): Генерация цифровой «лингвистической подписи» для связывания нескольких аккаунтов на основе распределения биграмм и эмодзи.
• Аудит вовлечённости (audit): Статистическое обнаружение неаутентичной бот-активности через анализ вариаций временного джиттера.

📦 Управление расследованиями

• Экспорт одним кликом (data): Автоматическая загрузка списка подписчиков цели, списка подписок и медиа из ленты (с метаданными JSON), упакованных в один ZIP-архив.
• Автоматическая отчётность: Каждая команда автоматически сохраняет результаты в отчётах JSON и TXT в data/<target>/.
• Автономный пакетный режим: Последовательная обработка нескольких целей из текстового файла.
• Интеллектуальное кэширование: Молниеносные повторные запросы благодаря TTL-кэшированию.

---

🚀 Установка

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

   root@kitploit:~

   git clone https://github.com/shredzwho/IG-Detective.git
   cd IG-Detective
   

2. Настройте виртуальное окружение

   root@kitploit:~

   python3 -m venv venv
   source venv/bin/activate  # На Windows: venv\Scripts\activate
   

3. Установите зависимости

   root@kitploit:~

   pip install -r requirements.txt
   

🐳 Запуск с Docker (рекомендуется)

Вы можете запускать IG-Detective полностью внутри Docker, чтобы избежать проблем с зависимостями. Контейнер требует интерактивного TTY (-it) и монтирования тома для сохранения ваших криминалистических отчётов.

1. С использованием Docker Compose (проще всего)

   root@kitploit:~

   docker-compose run --rm detective
   

2. С использованием стандартного Docker

   root@kitploit:~

   docker build -t ig-detective .
   docker run -it -v $(pwd)/data:/app/data ig-detective
   

---

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

1. Запустите оболочку

   root@kitploit:~

   python3 main.py
   # или используйте предоставленный скрипт-обёртку:
   ./run.sh
   

2. Основные команды Внутри оболочки сначала нужно задать цель, прежде чем запускать модули анализа:

---

📑 Подробная документация

Для глубокого погружения в архитектуру системы, криминалистические методологии и логику обхода смотрите: 👉 DOCUMENTATION.md

---

📂 Структура проекта

• main.py: Главная точка входа для оболочки.
• run.sh: Скрипт-обёртка для запуска.
• src/api/: Сетевой уровень, содержащий стелс-клиент Playwright и менеджер аутентификации.
• src/core/: Базовый уровень с моделями данных и конфигурацией.
• src/modules/: Уровень бизнес-логики со сборщиками и инструментами глубокого анализа.
• src/cli/: Уровень представления с интерактивной подсказкой и форматтерами Rich.
• data/: Автоматические отчёты расследований (игнорируются git).

---

🤝 Вклад в проект

Не стесняйтесь форкать этот проект и отправлять pull request. Для крупных изменений сначала откройте issue, чтобы обсудить то, что вы хотите изменить.

📜 Лицензия

[MIT]