
Osintgram — это OSINT-инструмент для Instagram. Он предоставляет интерактивную оболочку для анализа аккаунта любого пользователя Instagram по его никнейму.
# Osintgram 🔎📸
[](doc/CHANGELOG.md)
[](LICENSE)
[](https://www.python.org/)
[](.github/workflows/tests.yml)
[](#quick-start)
**Укажите на аккаунт Instagram и узнайте, кто за ним стоит.** Osintgram
собирает, сопоставляет и раскладывает всё, что выдаёт публичный профиль
— подписчиков, подписи к постам, хештеги, геолокации, привычки публикаций, публичные
контактные данные — в веб-интерфейсе, который вы запускаете на своей машине.
Спросите на обычном языке, и **локальная модель ИИ** определит, какие запросы
выполнить. Или не спрашивайте: выберите команды сами и обойдитесь без модели.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/d6eaa19d795a604cab713f300cd9b5db4dce554bc604e3436a88d3d63e6f132b/6e4b370c0dd97191375d1281f84ddf2bc1653a0379d942b46787fd1ebe124ba0-display-v1.webp" width="900" alt="Веб-интерфейс Osintgram: форма запроса с планом выполнения, показывающим лимиты и стоимость, письменный ответ и пронумерованные результаты с деталями профиля и хештегами">
</p>
---
## Почему вам может понравиться
**Он отвечает на вопросы, а не просто выполняет команды.** *«Сколько у них подписчиков и какие
хештеги они используют чаще всего?»* — запускает три запроса и возвращает письменный ответ —
и необработанные результаты под ним, чтобы вы могли проверить работу, а не доверять
тексту.
**Ничего не покидает вашу машину, кроме самих запросов.** ИИ работает
локально через [Ollama](https://ollama.com): никакого ключа OpenAI, никакой подписки, никакой
ваш запрос никому не отправляется. Интерфейс обслуживается с `127.0.0.1`.
**Он сообщает, сколько будет стоить поиск, до его запуска.** Данные Instagram
не бесплатны, и большинство инструментов позволяют узнать это дорогим способом. Этот оценивает
ваш выбор заранее, показывает оставшийся кредит, кэширует каждый запрос, чтобы
вы никогда не платили дважды за один и тот же поиск, и позволяет ограничить или остановить запуск —
на стороне сервера, а не только в браузере.
**Он показывает найденное как следует.** Миниатюры постов в фильтруемой сетке,
геолокации на карте, тепловая карта день недели × час, показывающая, когда кто-то публикует,
сравнение двух аккаунтов. Не стена JSON — хотя JSON в одном
клике на каждой карточке.
**Вы можете передать результат кому-то другому.** Одна кнопка превращает завершённый поиск
в автономный HTML-отчёт, который открывается в любом браузере, без сервера и без
Osintgram.
---
## Два способа управления
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/423f425ac28ff28e4a24bbfa2e327d0d6a7120758dcc141a88a05ee4dc244424/6c18229ce4134dc3117d01b134aab494b5c4e8f6e36d817b4cacd9abababebfc-display-v1.webp" width="860" alt="Базовый режим: 28 команд в двух столбцах, сгруппированных по цвету и сворачиваемых, с полем поиска и планом выполнения">
</p>
**Режим ИИ** — опишите, что вы хотите. Локальная модель выбирает команды, запускает
их и суммирует. Она может выбирать только из того же списка ниже; она не может
придумывать запросы или выдумывать данные.
**Базовый режим** — без модели, Ollama не нужна. Все 29 команд, по одной строке каждая,
сгруппированы и доступны для поиска. Отметьте нужное, задайте параметры, запустите их по
порядку.
Вы также можете оставить имя пользователя пустым в режиме ИИ и просто спросить о хештеге
или месте — такие поиски не принадлежат никакому аккаунту.
---
## Что можно узнать
| | |
|---|---|
| **Профиль** | Био и каждая ссылка в нём, количество подписчиков/подписок/публикаций, категория, публичный email, телефон и рабочий адрес вплоть до координат, привязанный Facebook id — плюс собственный раздел Instagram *About this account*: страна регистрации, дата создания, сколько раз менялось имя пользователя |
| **Сеть** | Подписчики и подписки, аккаунты, которые Instagram предлагает как связанные, кто отметил их, кого отметили они, кто комментирует больше всего — и **взаимные связи** между двумя аккаунтами |
| **Контент** | Хештеги, ранжированные по использованию, подписи, каждый комментарий, статистика лайков и комментариев, разбивка по фото/видео/каруселям с просмотрами и платными партнёрствами, **тепловая карта времени публикаций**, геотегированные локации **на карте**, alt-текст фотографий |
| **Контакты** | Публичные email и номера телефонов среди подписчиков или подписок цели |
| **Цель не нужна** | Публикации, опубликованные с **хештегом** (топ или недавние) или из **места**, и кто их опубликовал — плюс каждый **комментарий к конкретной публикации или reel**, по его URL, shortcode или id |
Stories, highlights и фотографии профиля возвращаются как прямые CDN-ссылки — и
любая карточка с медиа предлагает скачать оригиналы одним кликом в zip-архиве.
---
## Быстрый старт
```bash
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](https://hikerapi.com) напрямую — он проверяется перед тем, как
будет принят, и может быть сохранён для следующего раза. (Бесплатный
вход через [instagrapi](https://github.com/subzeroid/instagrapi) тоже работает, с использованием
вашего собственного аккаунта Instagram — о компромиссах см. в руководстве.)
Для режима ИИ установите [Ollama](https://ollama.com/download) и загрузите
модель, поддерживающую вызов инструментов:
```bash
ollama pull llama3.1:8b # ~4.7 GB, the default
```
Базовый режим работает без него.
Предпочитаете контейнеры?
```bash
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`](https://github.com/datalux/osintgram/blob/master/doc/web-ui.md)
Настройка обоих бэкендов, каждая команда с её параметрами и стоимостью, как
сократить расходы, экспорт и обмен результатами, все параметры конфигурации
и устранение неполадок.
---
## Перед использованием
**ТОЛЬКО В ОБРАЗОВАТЕЛЬНЫХ ЦЕЛЯХ.** Участники проекта не несут никакой
ответственности за использование этого инструмента.
- **Не используйте с ним свой собственный или основной аккаунт Instagram.**
- **Никогда не коммитьте `config/credentials.ini`** — там хранятся ключи API и
учётные данные Instagram. Файл добавлен в git-ignore; оставьте так. Если ключ
когда-либо был отправлен в репозиторий, смените его: удаление файла не убирает его из истории.
- Результаты содержат персональные данные других людей. Обращайтесь с ними в соответствии с
законодательством о защите данных (GDPR и аналогичными) и Условиями использования Instagram.
- Вы не можете просматривать приватные профили. Никто не может. Инструменты, утверждающие обратное, —
мошенничество.
---
## Разработка
```bash
pip install -r requirements-dev.txt
python -m pytest
```
Набор тестов полностью работает на синтетических фикстурах — без API-ключа, без квоты,
без сети. Он также проверяет, что документация не разошлась с
кодом.
Запросы на новые функции и pull-запросы приветствуются — откройте issue. Нашли
проблему безопасности? Пожалуйста, сообщите о ней приватно: см. [SECURITY.md](https://github.com/datalux/osintgram/blob/master/SECURITY.md).
---
## Благодарности
Osintgram написан **Giuseppe Criscione**
([Datalux](https://github.com/Datalux)). Версия 2.0 перестраивает его вокруг веб-
интерфейса и переиспользуемого сервисного слоя, а также добавляет режим ИИ, контроль затрат
и новые виды анализа — см. [changelog](https://github.com/datalux/osintgram/blob/master/doc/CHANGELOG.md).
Он во многом обязан всем, кто внёс вклад с момента первого релиза:
<a href="https://github.com/Datalux/Osintgram/graphs/contributors">
<img src="https://contributors-img.web.app/image?repo=Datalux/Osintgram" alt="Osintgram contributors">
</a>
Данные Instagram поступают из [HikerAPI](https://hikerapi.com) или
[instagrapi](https://github.com/subzeroid/instagrapi). Геокодирование —
[Nominatim](https://nominatim.org) / [OpenStreetMap](https://www.openstreetmap.org/copyright).
Карты — [Leaflet](https://leafletjs.com). Локальные модели — через
[Ollama](https://ollama.com).
Выпущено под лицензией [GPL-3.0](https://github.com/datalux/osintgram/blob/master/LICENSE).
Instagram является товарным знаком Meta Platforms, Inc. Этот проект не связан
с Meta, не одобрен и не утверждён ею.