BIRDY-EDWARDS 2.0

Infiltrate & Expose

Автоматизированный инструмент разведки по Facebook на базе ИИ для профилирования целей, анализа сетей и составления отчетов об угрозах. Работает полностью на устройстве через Ollama. SOCMINT-платформа на базе ИИ — 100% локально, без облачной зависимости. Для облегченной версии смотрите этот репозиторий нажмите здесь

Установка · Устранение неполадок · Отказ от ответственности · Вклад в проект

Документация

Полные руководства по использованию для обоих режимов расследования доступны на сайте проекта:

• Нажмите здесь

Как это работает

Что нового в v2.0

• 🗽 Гибкость — Теперь вы можете остановить расследование на любом этапе и сгенерировать PDF-отчет
• 🎬 Анализ Reels — ИИ извлекает сводку контекста, тему, именованные сущности и хэштеги из каждой подписи к видео
• 🔗 Матрица координации со-комментаторов — Тепловая карта того, кто комментирует вместе с кем. Нажмите на любую ячейку, чтобы увидеть общие посты
• 👤 Гибридное обнаружение лиц HOG + CNN — Автоматический выбор модели по размеру изображения с откатом CNN→HOG. Обнаружение лиц теперь также работает на скриншотах текстовых постов
• 📬 Уведомления в Telegram — PDF-отчет автоматически отправляется в ваш настроенный Telegram-чат по завершении
• 📄 Полный набор PDF — Добавлены разделы: анализ изображений, анализ Reels, галерея лиц, хронология постов, пары со-комментаторов. Бенгальский, хинди, арабский, урду отображаются корректно
• ⚙️ Очередь расследований — До 5 расследований в очереди, выполняемых автоматически последовательно
• 🔄 Страница прогресса в реальном времени — Живые счетчики статистики разблокируются по мере поступления данных в процессе конвейера
• 📅 Изменение даты и времени — Во время сбора данных возможно, что мы получаем только дату, а не точную временную метку, поэтому, как исследователь, вы теперь можете изменить её на точную временную метку.

Возможности

• 🔍 Сбор профиля — Автоматический сбор данных: посты, фото, Reels, информация «О себе», комментарии, ссылки и имена профилей комментаторов с 9-стратегическим извлечением дат
• 🗂️ Пакетное расследование — Отправьте до 10 смешанных URL-адресов постов и запустите полный ИИ-конвейер по всем ним
• 🧠 Анализ взаимодействий — ИИ-анализ тональности, позиции, эмоций и языка для каждого взаимодействия на 140+ языках, включая бенгальский, хинди, арабский, урду, куки
• 📊 Оценка субъектов — Взвешенный композитный балл с 5-уровневой классификацией. До 14 вторичных профилей собираются при среднем и глубоком сканировании
• 🌍 Определение страны — LLM определяет страну происхождения по сигналам профиля с бейджем процента уверенности и по запросу для каждого комментатора
• 🔬 Анализ изображений — Vision LLM для каждого фото: сцена, толпа, символы, оружие, OCR и оценка местоположения
• 🎬 Анализ Reels и текстовых постов — ИИ извлекает сущности, темы, типы повествования и индикаторы угроз из подписей и постов
• 👤 Анализ лиц — Гибридное обнаружение HOG + CNN, 128D кодирование, кластеризация личностей, D3-визуализация дерева лиц
• 🕸️ Сетевые графы — Интерактивный D3 force-граф, тепловая карта со-комментаторов с общими постами по клику, кластеры по фамилиям
• 📄 PDF-отчеты — Полный отчет разведки с анализом изображений, анализом Reels, галереей лиц, хронологией постов, анализом со-комментаторов и многоязычным рендерингом текста
• 📬 Доставка в Telegram — PDF-отчет автоматически отправляется в настроенный чат по завершении расследования
• 🤖 Локальный ИИ — На базе Ollama, gemma4:e2b / e4b / 12b и другие модели, работает на GPU или CPU
• 🐳 Готовность к Docker — Развертывание одной командой на Linux и Windows

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

BIRDY-EDWARDS разработан строго для авторизованной разведки, правоохранительных органов и академических исследовательских целей.

Объем доступа к данным:

• Этот инструмент работает исключительно с действительной сессией Facebook, аутентифицированной оператором
• Он получает доступ только к публично видимым данным профиля, постам, фото, Reels и комментариям
• Он не получает доступ к личным сообщениям, закрытым профилям, ограниченному контенту или любым данным, не видимым вошедшему в систему пользователю
• Он не использует ботов, фейковые аккаунты или автоматическое создание аккаунтов — оператор предоставляет собственную аутентифицированную сессию

Юридическая ответственность:

• Этот инструмент должен использоваться только на профилях и контенте, где у вас есть явное юридическое разрешение на сбор и анализ данных
• Использование без разрешения может нарушать Условия предоставления услуг Facebook, применимые законы о конфиденциальности (GDPR, IT Act, DPDP Act) и местные нормативные акты
• Разработчик не несет ответственности за неправомерное использование, несанкционированный сбор данных или любой вред, причиненный ненадлежащим использованием
• Все расследования являются исключительной ответственностью оператора

Используя BIRDY-EDWARDS, вы подтверждаете, что ваше использование является законным, авторизованным и соответствует всем применимым законам вашей юрисдикции.

Системные требования

Установка

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

Шаг 1 — Установите Docker

• Linux: https://docs.docker.com/engine/install/ubuntu/
• Windows: https://docs.docker.com/desktop/install/windows-install/

Шаг 2 — Установите Ollama

• Linux:

curl -fsSL https://ollama.com/install.sh | sh

• Windows: Скачайте установщик с https://ollama.com/download

Шаг 3 — Запустите Ollama, привязанный ко всем интерфейсам

• Linux:

OLLAMA_HOST=0.0.0.0:11434 ollama serve

Чтобы сделать это постоянным:

sudo systemctl edit ollama

Добавьте:

[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"

sudo systemctl daemon-reload && sudo systemctl restart ollama

• Windows: Ollama по умолчанию прослушивает все интерфейсы — дополнительная настройка не требуется. Если нет, то:

$env:OLLAMA_HOST="0.0.0.0"
ollama serve

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

Шаг 1 — Клонируйте репозиторий

git clone https://github.com/jeet-ganguly/birdy-edwards.git
cd birdy-edwards

Шаг 2 — Создайте необходимые файлы и каталоги

• Linux:

mkdir -p app/reports app/face_data app/post_screenshots app/status
touch app/fb_cookies.pkl app/socmint.db app/socmint_manual.db app/.ollama_model app/queue.db

• Windows (PowerShell):

New-Item -ItemType Directory app/reports, app/face_data, app/post_screenshots, app/status
New-Item -ItemType File app/fb_cookies.pkl, app/socmint.db, app/socmint_manual.db, app/.ollama_model

Шаг 3 — Соберите Docker-образ

⚠️ Первая сборка занимает 15–25 минут — dlib компилируется из исходного кода. Последующие сборки быстрые (слои кэшируются).

docker compose build

Шаг 4 — Запустите контейнер

docker compose up -d

docker compose logs -f

Шаг 5 — Откройте веб-интерфейс

http://localhost:5000

Шаг 6 — Импортируйте файлы cookie сессии

http://localhost:5000/tools/import-cookies

Загрузка модели ИИ

Загрузите модель на вашем хост-компьютере:

ollama pull gemma4:e2b

Или используйте панель AI Model в веб-интерфейсе — выберите модель и нажмите Apply & Pull.

Если вы используете виртуальную машину, выбирайте модель в соответствии с выделенной ОЗУ виртуальной машины.

Импорт файлов cookie сессии

BIRDY-EDWARDS требует действительную сессию Facebook. Используйте расширение браузера Cookie-Editor — работает на всех платформах, Selenium не требуется.

🔒 Операционная безопасность: Настоятельно рекомендуется использовать выделенный аккаунт-марионетку для расследований, а не ваш личный аккаунт Facebook. Это защищает вашу личность и предотвращает блокировку или ограничение вашего основного аккаунта.

1. Установите Cookie-Editor → Chrome · Firefox
2. Войдите в свой выделенный аккаунт для расследований на Facebook
3. Нажмите Cookie-Editor, находясь на facebook.com
4. Нажмите Export → Export as JSON
5. Перейдите на http://localhost:5000/tools/import-cookies и вставьте

Настройка уведомлений Telegram

Получайте свой PDF-отчет автоматически после каждого расследования.

1. Создайте Telegram-бота через @BotFather и скопируйте токен бота
2. Получите свой chat ID — отправьте сообщение вашему боту, затем посетите https://api.telegram.org/bot<TOKEN>/getUpdates
3. Перейдите на панель Telegram в веб-интерфейсе
4. Вставьте токен бота и chat ID и нажмите Save
5. Нажмите Test, чтобы проверить соединение

С этого момента каждое завершенное расследование автоматически отправляет уведомление с прикрепленным PDF-отчетом.

Как вы можете помочь

Если вы находите BIRDY-EDWARDS полезным или интересным, вот несколько способов поддержать проект:

• ⭐ Поставьте звезду репозиторию — это помогает другим обнаружить инструмент
• 🐛 Сообщайте об ошибках — откройте Issue, если что-то не работает
• 🔧 Вносите вклад — ознакомьтесь с разделом Contributing, чтобы начать
• 📢 Делитесь — публикуйте в сообществах OSINT, на форумах, в X или среди коллег, которым это может быть полезно
• 💬 Давайте обратную связь — предложения новых функций или улучшений всегда приветствуются

Каждый вклад, большой или малый, помогает создавать лучшие инструменты для сообщества OSINT и разведки угроз.

Устранение неполадок

Ollama недоступен из Docker

docker exec -it birdy-edwards curl http://host.docker.internal:11434/api/tags

Если не работает, перезапустите Ollama с OLLAMA_HOST=0.0.0.0:11434 ollama serve

Ошибка БД: no such table или другая ошибка, связанная с БД
Начните новое расследование — схема создается автоматически при первом использовании. Если вы остановили процесс во время анализа, удалите это расследование и начните новое.

Срок действия cookie истек
Перейдите на http://localhost:5000/tools/import-cookies и повторно импортируйте свежие cookie.

Порт 5000 уже используется
Измените в docker-compose.yml: "5001:5000", затем обращайтесь по адресу http://localhost:5001

Недостаточно памяти во время сборки
Увеличьте память Docker Desktop до 8 ГБ+ через Settings → Resources → Memory

Карта не загружается
Тайлы Leaflet + ArcGIS требуют доступа в интернет на хост-компьютере. Если работаете полностью в изолированной сети, контейнер карты будет отображаться пустым — все остальные функции работают нормально.

Telegram не отправляет
Убедитесь, что ваш бот запущен, отправив ему сообщение /start. Проверьте правильность chat ID с помощью URL getUpdates. Убедитесь, что порт 443 не заблокирован в вашей сети.

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

Вклад приветствуется. Пожалуйста, следуйте этим рекомендациям, чтобы поддерживать проект чистым и согласованным.

Сообщение об ошибках

• Откройте Issue с описанием ошибки, шагами для воспроизведения и вашим окружением (ОС, ОЗУ, версия Docker)
• Прикрепите соответствующие журналы из docker compose logs

Запросы функций

• Откройте Issue с четким описанием функции и ее варианта использования
• Обсудите перед открытием Pull Request для крупных изменений

Отправка Pull Request

• Сделайте форк репозитория
• Создайте ветку функции: git checkout -b feature/your-feature-name
• Зафиксируйте изменения: git commit -m "Add: short description"
• Отправьте в свою ветку: git push origin feature/your-feature-name
• Откройте Pull Request против main

Рекомендации по коду

• Следуйте существующему стилю кода — Python 3.12, соглашения Flask
• Тестируйте изменения локально через Docker перед отправкой
• Не коммитьте fb_cookies.pkl, базы данных или любые собранные данные
• Держите изменения скрейпера минимальными — DOM Facebook часто меняется

Что мы приветствуем

• Исправления ошибок и улучшения стабильности
• Поддержку новых моделей Ollama
• Улучшения интерфейса
• Улучшения документации
• Дополнительную языковую поддержку для OCR и анализа комментариев

Что мы не принимаем

• Функции, обходящие средства контроля безопасности платформы
• Изменения, вводящие облачные зависимости
• Код, который хранит или передает данные расследований во внешние системы

Благодарности

• Вдохновлено Sherlock
• Вдохновлено сообществом исследователей OSINT и разведки угроз
• SeleniumBase — Автоматизация Chrome без обнаружения
• Ollama — Локальный движок вывода LLM
• face_recognition — Библиотека обнаружения и кодирования лиц
• Leaflet — Интерактивная библиотека карт
• ArcGIS — Тайлы карт с корректными конституционными границами
• pyvis — Интерактивная визуализация сетевых графов
• reportlab — Генерация PDF
• pytesseract — Обертка OCR-движка
• D3.js — Визуализация данных и интерактивные графы