Osintgram 🔎📸

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

Задайте вопрос на обычном языке — и локальная ИИ-модель сама решит, какие запросы выполнить. Или не задавайте: выбирайте команды сами и обойдитесь без модели.

---

Почему это может вам понравиться

Он отвечает на вопросы, а не просто выполняет команды. «Сколько у них подписчиков и какие хештеги они используют чаще всего?» — запускаются три запроса, и вы получаете письменный ответ, а под ним — необработанные результаты, чтобы можно было проверить работу, а не доверять тексту на слово.

Ничего не покидает вашу машину, кроме самих запросов. ИИ работает локально через Ollama: никакого ключа OpenAI, никакой подписки, никакой ваш запрос никому не отправляется. Интерфейс отдаётся с 127.0.0.1.

Он сообщает, сколько будет стоить поиск, ещё до его запуска. Данные Instagram не бесплатны, и большинство инструментов позволяют узнать это дорогим способом. Этот заранее оценивает стоимость выбранного набора, показывает остаток кредита, кэширует каждый запрос, чтобы вы никогда не платили дважды за один и тот же поиск, и позволяет ограничить или остановить запуск — на стороне сервера, а не только в браузере.

Он показывает найденное как следует. Миниатюры постов в фильтруемой сетке, геолокации на карте, тепловая карта «день недели × час» того, когда человек публикует посты, сравнение двух аккаунтов. Не стена JSON — хотя JSON доступен в один клик с каждой карточки.

Вы можете передать результат кому-то другому. Одна кнопка превращает завершённый поиск в автономный HTML-отчёт, который открывается в любом браузере — без сервера и без Osintgram.

---

Два способа управления

Режим ИИ — опишите, что вам нужно. Локальная модель выбирает команды, выполняет их и подводит итог. Она может выбирать только из того же списка ниже; она не может придумать запросы или выдумать данные.

Базовый режим — без модели, Ollama не нужна. Все 29 команд, по одной строке каждая, сгруппированы и доступны для поиска. Отметьте нужные, задайте параметры, запустите их по порядку.

Также можно оставить имя пользователя пустым в режиме ИИ и просто спросить о хештеге или месте — такие поиски не привязаны ни к какому аккаунту.

---

Что можно узнать

Профиль	Био и все ссылки в нём, количество подписчиков/подписок/постов, категория, публичный email, телефон и рабочий адрес вплоть до координат, привязанный id Facebook — плюс собственный раздел Instagram About this account: страна регистрации, дата создания, сколько раз менялось имя пользователя
Сеть	Подписчики и подписки, аккаунты, которые Instagram предлагает как связанные, кто отметил их, кого отметили они, кто комментирует больше всех — и взаимные связи между двумя аккаунтами
Контент	Хештеги, отсортированные по частоте использования, подписи к постам, все комментарии, статистика лайков и комментариев, разбивка по фото/видео/каруселям с просмотрами и платными партнёрствами, тепловая карта времени публикации, геолокации на карте, alt-текст фотографий
Контакты	Публичные email и номера телефонов среди подписчиков или подписок цели
Цель не нужна	Посты, опубликованные с хештегом (популярные или недавние) или из места, и кто их опубликовал — плюс все комментарии к конкретному посту или reel по его URL, shortcode или id

Stories, highlights и изображения профиля возвращаются в виде прямых ссылок на CDN — и любая карточка с медиа предлагает скачать оригиналы одним кликом в zip-архиве.

---

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

pip install -r requirements.txt
uvicorn src.web.app:app --host 127.0.0.1 --port 8000 --reload   # or: make run

Откройте http://127.0.0.1:8000.

Вам нужен бэкенд данных. Страница открывается на панели, где можно вставить ключ HikerAPI напрямую — он проверяется перед принятием и может быть сохранён для следующего раза. (Бесплатный вход через instagrapi тоже работает — с использованием вашего собственного аккаунта Instagram; о компромиссах читайте в руководстве.)

Для режима ИИ установите Ollama и загрузите модель, поддерживающую вызов инструментов:

ollama pull llama3.1:8b     # ~4.7 GB, the default

Базовый режим работает и без неё.

Предпочитаете контейнеры?

docker compose up --build      # or: make docker

Тот же адрес, то же поведение — публикуется только на 127.0.0.1. Ваш ключ, кэш и сохранённые поиски остаются на хосте в config/, cache/ и dossier/, никогда внутри образа. Режим ИИ обращается к Ollama, запущенной на вашем хосте.

$${\color{red}Warning:}$$ Это работает на 127.0.0.1 без аутентификации. Он создан для запуска на вашей собственной машине — не выставляйте его за пределы localhost, не поставив перед ним слой аутентификации.

📖 Прочитайте полное руководство → doc/web-ui.md

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

---

Перед использованием

ТОЛЬКО В ОБРАЗОВАТЕЛЬНЫХ ЦЕЛЯХ. Участники не несут никакой ответственности за использование этого инструмента.

• Не используйте с ним свой собственный или основной аккаунт Instagram.
• Никогда не коммитьте config/credentials.ini — там хранятся ключи API и учётные данные Instagram. Он игнорируется git; пусть так и остаётся. Если ключ когда-либо был отправлен в репозиторий, смените его: удаление файла не убирает его из истории.
• Результаты содержат персональные данные других людей. Обращайтесь с ними в соответствии с законодательством о защите данных (GDPR и аналогичными) и Условиями использования Instagram.
• Вы не можете видеть приватные профили. Ничто не может. Инструменты, утверждающие обратное, — мошенничество.

---

Разработка

pip install -r requirements-dev.txt
python -m pytest

Набор тестов работает полностью на синтетических фикстурах — без ключа API, без квоты, без сети. Он также проверяет, что документация не разошлась с кодом.

Запросы на новые функции и pull request'ы приветствуются — открывайте issue. Нашли проблему безопасности? Пожалуйста, сообщите о ней приватно: см. SECURITY.md.

---

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

Osintgram написан Giuseppe Criscione (Datalux). Версия 2.0 перестраивает его вокруг веб-интерфейса и переиспользуемого сервисного слоя, а также добавляет режим ИИ, контроль расходов и новые виды анализа — см. changelog.