soxoj/maigret🕵️♂️ Соберите досье на человека по имени пользователя с 6K веб-сайтов
# Maigret
<div align="center">
<div>
<a href="https://pypi.org/project/maigret/">
<img alt="PyPI version badge for Maigret" src="https://img.shields.io/pypi/v/maigret?style=flat-square" />
</a>
<a href="https://pepy.tech/project/maigret">
<img alt="Total downloads" src="https://static.pepy.tech/badge/maigret" />
<img alt="Downloads/month" src="https://static.pepy.tech/badge/maigret/month" />
</a>
</div>
<div>
<a href="https://github.com/soxoj/maigret">
<img alt="View count for Maigret project" src="https://komarev.com/ghpvc/?username=maigret&color=brightgreen&label=views&style=flat-square" />
</a>
<a href="https://github.com/soxoj/maigret">
<img alt="Minimum Python version required: 3.10+" src="https://img.shields.io/badge/Python-3.10+-brightgreen?style=flat-square" />
</a>
<a href="https://github.com/soxoj/maigret/blob/main/LICENSE">
<img alt="License badge for Maigret" src="https://img.shields.io/github/license/soxoj/maigret?style=flat-square" />
</a>
<a href="https://maigret.readthedocs.io/">
<img alt="Maigret documentation" src="https://img.shields.io/readthedocs/maigret?style=flat-square&label=docs" />
</a>
</div>
<br>
<div>
<img src="https://assets.kitploit.com/production/public/readmes/216/f4ea992b7e00fe5e906d35323dd806650b89309c635ef77372bc1f8e497950f7.png" height="300" alt="Maigret logo"/>
</div>
<br>
<div>
<a href="https://codewiki.google/github.com/soxoj/maigret">
<img alt="Ask Code Wiki about Maigret" src="https://img.shields.io/badge/Code_Wiki-ask_about_repo-yellow?logo=googlegemini" />
</a>
<a href="https://deepwiki.com/soxoj/maigret">
<img alt="Ask DeepWiki about Maigret" src="https://img.shields.io/badge/DeepWiki-ask_about_repo-yellow" />
</a>
</div>
<br>
<div>
<b>English</b> · <a href="https://github.com/soxoj/maigret/blob/main/README.zh-CN.md">简体中文</a> · <a href="https://github.com/soxoj/maigret/blob/main/README.fr.md">Français</a>
</div>
<br>
<div>
📖 <a href="https://maigret.readthedocs.io/"><b>Документация</b></a>
</div>
<br>
</div>
**Maigret** собирает досье на человека **только по имени пользователя**, проверяя наличие аккаунтов на огромном количестве сайтов и собирая всю доступную информацию с веб-страниц. API-ключи не требуются. **[AI-профилирование (демо)](#ai-analysis)**.
## Спонсоры
<p align="center">
<a href="https://noimosiny.com/?utm_campaign=maigret&utm_source=github">
<img width="600" alt="Noimosiny" src="https://github.com/user-attachments/assets/cef16613-4337-47a3-9105-2621197b17d1" />
</a>
</p>
<p>
<a href="https://noimosiny.com/?utm_campaign=maigret&utm_source=github"><b>Noimosiny</b></a> — это комплексная OSINT-платформа для профессиональных следователей и аналитиков. Обратный поиск по email, номеру телефона и имени пользователя с помощью более чем 250 модулей. Автоматизируйте сбор разведданных с помощью наших мощных инструментов.
</p>
<br>
<p align="center">
<a href="https://www.rapidproxy.io/?ref=soxoj">
<img src="https://assets.kitploit.com/production/public/readmes/216/d0d5d0f98e98ee2bae78bf2fc510e47089760ef9ce72121edc7ce6de19295d9f.jpg" width="500" alt="RapidProxy">
</a>
</p>
<p>
<a href="https://www.rapidproxy.io/?ref=soxoj"><b>RapidProxy</b></a> предоставляет высокопроизводительные резидентные прокси для парсинга Twitter, автоматизации Selenium и извлечения веб-данных. 90M+ IP • Умная ротация • Антиблокировка • Неистекающий трафик. <br>
<b>Специальное предложение</b>: Попробуйте бесплатно — тарифы от $0.65/ГБ. Используйте код <b>RAPID10</b> для скидки 10%.
</p>
<p align="center">
<a href="https://mangoproxy.com/?utm_source=soxoj&utm_medium=partner&utm_campaign=soxoj_github">
<img src="https://github.com/user-attachments/assets/146b6b95-06ae-4fda-bff2-d94946cf7c2e" width="300" alt="MangoProxy">
</a>
</p>
<p>
<a href="https://mangoproxy.com/?utm_source=soxoj&utm_medium=partner&utm_campaign=soxoj_github"><b>MangoProxy</b></a> — это сервис резидентных, ISP, мобильных и датацентровых прокси, разработанный для профессиональных задач, где важны стабильность, скорость и анонимность. <br>
<b>Промокод</b>: SOXOJ - скидка 8% на статические ISP-прокси
</p>
<p align="center">
<a href="https://www.thordata.com/?ls=dmt&lk=dmt">
<img src="https://github.com/user-attachments/assets/6d92bda0-c953-49b5-ab7e-73b0e67f17e2" width="350" alt="Thordata">
</a>
</p>
<p>
<a href="https://www.thordata.com/?ls=dmt&lk=dmt"><b>Thordata</b></a>
</a> предоставляет надёжные резидентные прокси для OSINT-исследований, поиска по имени пользователя и рабочих процессов сбора публичных данных.
Доступ к <b>100M+ реальных резидентных IP</b> в <b>195+ странах</b>, <b>неограниченные одновременные подключения</b> с аптаймом 99.99% и стабильными соединениями, ротационные и фиксированные сессии, а также высокий процент успеха.
<br>
<b>Специальное предложение:</b> Бесплатный 3-дневный триал + <b>скидка 10%</b> по коду <b>SOXOJ10</b>.
</p>
## Содержание
- [За одну минуту](#in-one-minute)
- [Основные возможности](#main-features)
- [Демо](#demo)
- [Установка](#installation)
- [Использование](#usage)
- [Участие в разработке](#contributing)
- [Коммерческое использование](#commercial-use)
- [О проекте](#about)
<a id="one-minute"></a>
## За одну минуту
Убедитесь, что у вас установлен Python 3.10 или выше.
```bash
pip install maigret
maigret YOUR_USERNAME
```
Не хотите устанавливать? Попробуйте [Telegram-бот сообщества](https://maigret.app/readme-en) или [Cloud Shell](#cloud-shells).
Хотите веб-интерфейс? См. [как его запустить](#web-interface).
См. также: [Быстрый старт](https://maigret.readthedocs.io/en/latest/quick-start.html).
## Основные возможности
- Поддерживает 5 900 сайтов ([см. полный список](https://github.com/soxoj/maigret/blob/main/sites.md)). По умолчанию проверяются 500 сайтов с наибольшим трафиком; передайте `-a`, чтобы просканировать всё, или `--tags`, чтобы сузить по категории/стране.
- Встраивается в Python-проекты — импортируйте `maigret` и запускайте поиск программно (см. [использование библиотеки](https://maigret.readthedocs.io/en/latest/library-usage.html)).
- [Извлекает](https://github.com/soxoj/socid_extractor) всю доступную информацию о владельце аккаунта со страниц профилей и API сайтов, включая ссылки на другие аккаунты.
- Выполняет рекурсивный поиск с использованием обнаруженных имён пользователей и других идентификаторов.
- Позволяет фильтровать по тегам (категории сайтов, страны).
- Обнаруживает и частично обходит блокировки, цензуру и CAPTCHA.
- Загружает [автообновляемую базу сайтов](https://maigret.readthedocs.io/en/latest/settings.html#database-auto-update) с GitHub при каждом запуске (раз в 24 часа) и переключается на встроенную базу при отсутствии соединения.
- Работает с сайтами Tor и I2P; умеет проверять домены.
- Поставляется с [веб-интерфейсом](#web-interface) для просмотра результатов в виде графа и скачивания отчётов во всех форматах с одной страницы.
- Опциональный [режим AI-анализа](#ai-analysis) (`--ai`), который превращает необработанные находки в краткое резюме расследования с помощью API, совместимого с OpenAI.
Полный список возможностей см. в [документации по функциям](https://maigret.readthedocs.io/en/latest/features.html).
### Используется в
Профессиональные инструменты OSINT и анализа социальных сетей, построенные на Maigret:
<a href="https://github.com/SocialLinks-IO/sociallinks-api"><img height="60" alt="Social Links API" src="https://assets.kitploit.com/production/public/readmes/216/e4e6afb8670aa5d3b703f1073907398ff6cc84031b15f4108bf1da37e01ab023.png"></a>
<a href="https://sociallinks.io/products/sl-crimewall"><img height="60" alt="Social Links Crimewall" src="https://assets.kitploit.com/production/public/readmes/216/fc0028a249da7498721b8783b585545203c93a3e51de565f4d27aa9a71882743.png"></a>
<a href="https://usersearch.ai/"><img height="60" alt="UserSearch" src="https://assets.kitploit.com/production/public/readmes/216/e0b60e01a3af3ac089eebc120d9627aeb0cbf3d9ee68c4f62e8d1e46fa5df5ad.png"></a>
## Демо
### Видео
<a href="https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ">
<img src="https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ.svg" alt="asciicast" width="600">
</a>
### Отчёты
[PDF-отчёт](https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.pdf), [HTML-отчёт](https://htmlpreview.github.io/?https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.html)
[Полный вывод в консоли](https://raw.githubusercontent.com/soxoj/maigret/main/static/recursive_search.md)
## Установка
Уже выполнили шаги из раздела [За одну минуту](#one-minute)? Всё готово. Ниже — альтернативные способы.
Не хотите ничего устанавливать? Используйте [Telegram-бот сообщества](https://maigret.app/readme-en).
### Windows
Скачайте `maigret_standalone.exe` со страницы [Releases](https://github.com/soxoj/maigret/releases). Запустить его можно двумя способами:
- **Двойным щелчком** — Maigret запросит имя пользователя, выполнит поиск по умолчанию и подождёт в конце, чтобы ссылки на отчёты оставались видимыми.
- **Из терминала** — откройте командную строку (нажмите `Win+R`, введите `cmd`, нажмите Enter) или PowerShell, чтобы передать дополнительные параметры:
```cmd
cd %USERPROFILE%\Downloads
maigret_standalone.exe USERNAME
maigret_standalone.exe USERNAME --html :: also save an HTML report
maigret_standalone.exe --help :: list all options
```
Видеоруководство: https://youtu.be/qIgwTZOmMmM.
<a id="cloud-shells"></a>
### Облачные оболочки
Запустите Maigret в браузере через облачные оболочки или Jupyter-ноутбуки:
<a href="https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/soxoj/maigret&tutorial=cloudshell-tutorial.md"><img src="https://assets.kitploit.com/production/public/readmes/216/7dc64fe3ed672759aab735389c56e594e597a6700b277aaa44a54b833448ea7a.png" alt="Open in Cloud Shell" height="50"></a>
<a href="https://repl.it/github/soxoj/maigret"><img src="https://replit.com/badge/github/soxoj/maigret" alt="Run on Replit" height="50"></a>
<a href="https://colab.research.google.com/gist/soxoj/879b51bc3b2f8b695abb054090645000/maigret-collab.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab" height="45"></a>
<a href="https://mybinder.org/v2/gist/soxoj/9d65c2f4d3bec5dd25949197ea73cf3a/HEAD"><img src="https://mybinder.org/badge_logo.svg" alt="Open In Binder" height="45"></a>
### Snap (Linux)
<a href="https://snapcraft.io/maigret"><img src="https://snapcraft.io/static/images/badges/en/snap-store-black.svg" alt="Get it from the Snap Store" height="50"></a>
```bash
sudo snap install maigret
# usage
maigret username
```
Доступно для amd64 и arm64, Python не требуется. Snap строго изолирован и может записывать только в ваш домашний каталог, поэтому запускайте его оттуда. Для USB-накопителей один раз подключите интерфейс командой `sudo snap connect maigret:removable-media`.
### Локальная установка (pip)
```bash
# install from pypi
pip3 install maigret
# usage
maigret username
```
### Из исходников
```bash
# or clone and install manually
git clone https://github.com/soxoj/maigret && cd maigret
# build and install
pip3 install .
# usage
maigret username
```
### Docker
Публикуются два варианта образа:
- `soxoj/maigret:latest` — режим CLI (по умолчанию)
- `soxoj/maigret:web` — автоматически запускает [веб-интерфейс](#web-interface)
```bash
# official image (CLI)
docker pull soxoj/maigret
# CLI usage
docker run -v /mydir:/app/reports soxoj/maigret:latest username --html
# Web UI (open http://localhost:5000)
docker run -p 5000:5000 soxoj/maigret:web
# Web UI on a custom port
docker run -e PORT=8080 -p 8080:8080 soxoj/maigret:web
# manual build
docker build -t maigret . # CLI image (default target)
docker build --target web -t maigret-web . # Web UI image
```
### Устранение неполадок
Ошибки сборки? См. [руководство по устранению неполадок](https://maigret.readthedocs.io/en/latest/installation.html#troubleshooting).
PDF-отчёты (`--pdf`) — это опциональное дополнение, устанавливается командой `pip install 'maigret[pdf]'`. Для них требуются системные графические библиотеки в Linux/macOS; см. [раздел о PDF-отчётах](https://maigret.readthedocs.io/en/latest/installation.html#optional-pdf-reports-maigret-pdf) для инструкций по установке для каждой ОС.
## Использование
### Примеры
```bash
# make HTML, PDF, and XMind reports
maigret user --html
maigret user --pdf
maigret user --xmind # legacy XML with a manifest for XMind 2022+ readers
# machine-readable exports
maigret user --json ndjson # newline-delimited JSON (also: --json simple)
maigret user --csv
maigret user --txt
maigret user --graph # interactive D3 graph (HTML)
maigret user --neo4j # Neo4j Cypher script (graph database)
# search on sites marked with tags photo & dating
maigret user --tags photo,dating
# search on sites marked with tag us
maigret user --tags us
# highlight sites whose page also mentions specific keywords
maigret user --keywords python rust
# keyword-matched sites are shown with "[++]" in bright green
# search for three usernames on all available sites
maigret user1 user2 user3 -a
# AI-assisted investigation summary (needs OPENAI_API_KEY)
maigret user --ai
```
`--neo4j` записывает скрипт `*_neo4j.cypher` с графом результатов; импортируйте его командой `cypher-shell -u neo4j -p <password> < report_user_neo4j.cypher` или вставьте в Neo4j Browser. Повторные импорты идемпотентны. См. [документацию по экспорту в Neo4j](https://maigret.readthedocs.io/en/latest/command-line-options.html#neo4j-export).
Запустите `maigret --help`, чтобы увидеть все параметры. Документация: [параметры CLI](https://maigret.readthedocs.io/en/latest/command-line-options.html), [больше примеров](https://maigret.readthedocs.io/en/latest/usage-examples.html). Сталкиваетесь с ошибками 403 или таймаутами? См. [TROUBLESHOOTING.md](https://github.com/soxoj/maigret/blob/main/TROUBLESHOOTING.md).
<a id="web-interface"></a>
### Веб-интерфейс
Maigret имеет встроенный веб-интерфейс с графом результатов и возможностью скачивания отчётов.
Не хотите запускать его самостоятельно? Разверните опубликованный Docker-образ `soxoj/maigret:web` как хостинговое приложение в один клик:
<a href="https://render.com/deploy?repo=https://github.com/soxoj/maigret&path=utils/render.yaml"><img src="https://render.com/images/deploy-to-render-button.svg" alt="Deploy to Render" height="40"></a>
Работает на бесплатном тарифе Render (отключается после 15 минут простоя, включается при следующем запросе). На экземпляре не настроен вход, поэтому им может воспользоваться любой, у кого есть URL.
<details>
<summary>Скриншоты веб-интерфейса</summary>
</details>
```console
maigret --web 5000
```
Откройте http://127.0.0.1:5000, введите имя пользователя и просмотрите результаты.
### Python-библиотека
**Maigret можно встроить в ваши собственные Python-проекты.** CLI — это тонкая обёртка вокруг асинхронной функции, которую можно вызывать напрямую: создавайте собственные пайплайны, передавайте результаты в свои инструменты или запускайте её в рамках более крупного OSINT-процесса.
См. полное [руководство по использованию библиотеки](https://maigret.readthedocs.io/en/latest/library-usage.html) с рабочим примером, асинхронными шаблонами и информацией о том, как фильтровать сайты по тегу.
### Полезные флаги CLI
- `--parse URL` — разобрать страницу профиля, извлечь идентификаторы/имена пользователей и использовать их для запуска рекурсивного поиска.
- `--permute` — сгенерировать вероятные варианты имени пользователя из двух или более входных данных (например, `john doe` → `johndoe`, `j.doe`, …) и искать по всем ним.
- `--self-check [--auto-disable]` — проверить пары `usernameClaimed` / `usernameUnclaimed` на живых сайтах для мейнтейнеров, проверяющих базу данных.
- `--ai` / `--ai-model` — запустить [AI-анализ](#ai-analysis) по результатам поиска и вывести краткое резюме расследования в терминал.
<a id="ai-analysis"></a>
### AI-анализ
[](https://asciinema.org/a/979404)
`--ai` собирает результаты поиска, формирует внутренний Markdown-отчёт и отправляет его на endpoint chat completion, совместимый с OpenAI, для получения краткого нейтрального резюме расследования (вероятное настоящее имя, местоположение, род занятий, интересы, языки, уверенность, дальнейшие зацепки). Прогресс по каждому сайту подавляется, а вывод модели транслируется в stdout.
```bash
export OPENAI_API_KEY=sk-...
maigret user --ai
# pick a different model
maigret user --ai --ai-model gpt-4o-mini
```
Ключ также можно задать как `openai_api_key` в `settings.json`. По умолчанию endpoint — `https://api.openai.com/v1`, но `openai_api_base_url` в `settings.json` может указывать на любой API, совместимый с OpenAI (Azure OpenAI, OpenRouter, локальный сервер, …). Полный список параметров см. в [документации по настройкам](https://maigret.readthedocs.io/en/latest/settings.html).
### Tor / I2P / прокси
Maigret может направлять проверки через прокси, Tor или I2P — полезно для сайтов `.onion` / `.i2p` и для обхода WAF, блокирующих IP датацентров.
```bash
# any HTTP/SOCKS proxy
maigret user --proxy socks5://127.0.0.1:1080
# Tor (default gateway socks5://127.0.0.1:9050)
maigret user --tor-proxy socks5://127.0.0.1:9050
# I2P (default gateway http://127.0.0.1:4444)
maigret user --i2p-proxy http://127.0.0.1:4444
```
Запустите ваш демон Tor / I2P перед выполнением команды — Maigret не управляет этими шлюзами.
### Обход Cloudflare
> **Экспериментально.** Веб-шлюз Cloudflare находится в активной разработке; схема конфигурации, поведение CLI и набор маршрутизируемых сайтов могут меняться без гарантий обратной совместимости.
Часть сайтов в базе данных требует настоящего браузера для решения JavaScript-задачи. Maigret может переложить эти проверки на локальный экземпляр [FlareSolverr](https://github.com/FlareSolverr/FlareSolverr):
```bash
docker run -d -p 8191:8191 --name flaresolverr ghcr.io/flaresolverr/flaresolverr:latest
maigret --cloudflare-bypass <username>
```
Обход включается опционально (`--cloudflare-bypass` или `cloudflare_bypass.enabled` в `settings.json`) и срабатывает только для сайтов, у которых поле `protection` совпадает. См. [документацию по функции](https://maigret.readthedocs.io/en/latest/features.html#cloudflare-bypass) для вариантов бэкенда и конфигурации.
## Участие в разработке
Добавляйте или исправляйте новые сайты точечно в `data.json` (без `json.load`/`json.dump`), затем запустите `./utils/update_site_data.py`, чтобы перегенерировать `sites.md` и метаданные базы данных, и откройте pull request. Подробнее см. [руководство CONTRIBUTING](https://github.com/soxoj/maigret/blob/main/CONTRIBUTING.md) и [документацию по разработке](https://maigret.readthedocs.io/en/latest/development.html). История релизов: [CHANGELOG.md](https://github.com/soxoj/maigret/blob/main/CHANGELOG.md).
## Коммерческое использование
Открытый Maigret распространяется под лицензией MIT и бесплатен для коммерческого использования без ограничений — но проверки сайтов со временем ломаются и требуют активной поддержки.
Для серьёзного коммерческого использования — с **ежедневно обновляемой базой сайтов** или **API проверки имён пользователей** — свяжитесь с нами: 📧 [[email protected]](mailto:[email protected])
- Приватная база сайтов — 5 000+ сайтов, обновляется ежедневно (отдельно от публичной открытой базы)
- API проверки имён пользователей — интегрируйте Maigret в ваш продукт
## О проекте
### Отказ от ответственности
**Только для образовательных и законных целей.** Вы несёте ответственность за соблюдение всех применимых законов (GDPR, CCPA и др.) в вашей юрисдикции. Авторы не несут ответственности за неправомерное использование.
### Обратная связь
[Открыть issue](https://github.com/soxoj/maigret/issues) · [GitHub Discussions](https://github.com/soxoj/maigret/discussions) · [Telegram](https://t.me/soxoj)
### Классификация SOWEL
Используемые техники OSINT:
- [SOTL-2.2. Search For Accounts On Other Platforms](https://sowel.soxoj.com/other-platform-accounts)
- [SOTL-6.1. Check Logins Reuse To Find Another Account](https://sowel.soxoj.com/logins-reuse)
- [SOTL-6.2. Check Nicknames Reuse To Find Another Account](https://sowel.soxoj.com/nicknames-reuse)
### Лицензия
MIT © [Maigret](https://github.com/soxoj/maigret)