Maigret

Maigret собирает досье на человека только по имени пользователя, проверяя наличие аккаунтов на огромном количестве сайтов и собирая всю доступную информацию со веб-страниц. API-ключи не требуются. AI-профилирование (демо).

Спонсоры

711Proxy предоставляет надёжные резидентные прокси для веб-скрапинга, поиска имён пользователей и сбора публичных данных. Более 100 миллионов резидентных IP-адресов в 200+ странах • Высокие показатели успеха • Быстрые и надёжные соединения.
Специальное предложение: Доступна бесплатная пробная версия! Ротирующие резидентные прокси от $0.55/ГБ. Безлимитные резидентные прокси от $15/час без ограничений на количество одновременных соединений.

9Proxy предоставляет резидентные прокси от $0.018/IP или $0.68/ГБ. Более 20 миллионов IP-адресов в 90+ странах. Сессии с привязкой к IP или с ротацией, управление через десктопное или мобильное приложение.

Содержание

• За минуту
• Основные возможности
• Демо
• Установка
• Использование
• Вклад в проект
• Коммерческое использование
• О проекте

За минуту

Убедитесь, что у вас установлена Python 3.10 или выше.

pip install maigret
maigret YOUR_USERNAME

Нет возможности установить? Попробуйте community Telegram бота или облачную оболочку.

Хотите веб-интерфейс? См. как его запустить.

См. также: Быстрый старт.

Основные возможности

• Поддерживает 3000+ сайтов (см. полный список). Запуск по умолчанию проверяет 500 самых топовых сайтов по трафику; передайте -a для сканирования всего, или --tags для фильтрации по категориям/странам.
• Может быть встроен в Python-проекты — импортируйте maigret и выполняйте поиск программно (см. использование как библиотеки).
• Извлекает всю доступную информацию о владельце аккаунта со страниц профилей и API сайтов, включая ссылки на другие аккаунты.
• Выполняет рекурсивный поиск, используя обнаруженные имена пользователей и другие идентификаторы.
• Позволяет фильтровать по тегам (категории сайтов, страны).
• Обнаруживает и частично обходит блокировки, цензуру и CAPTCHA.
• Каждый запуск загружает автообновляемую базу данных сайтов из GitHub (раз в 24 часа) и использует встроенную базу данных, если вы находитесь в офлайне.
• Работает с сайтами в Tor и I2P; умеет проверять домены.
• Включает веб-интерфейс для просмотра результатов в виде графа и скачивания отчётов во всех форматах с одной страницы.
• Опциональный режим анализа с ИИ (--ai), который превращает сырые данные в краткое аналитическое резюме, используя API совместимое с OpenAI.

Полный список возможностей смотрите в документации по возможностям.

Используется в

Профессиональные инструменты для OSINT и анализа социальных сетей, построенные на Maigret:

Демо

Видео

Отчёты

PDF отчёт, HTML отчёт

Полный вывод в консоли

Установка

Вы уже выполнили шаги из раздела За минуту? Тогда у вас всё готово. Ниже приведены альтернативные методы.

Не хотите ничего устанавливать? Используйте community Telegram бота.

Windows

Скачайте maigret_standalone.exe из раздела Releases. Вы можете запустить его двумя способами:

• Дважды щёлкните по нему — Maigret запросит имя пользователя, выполнит поиск по умолчанию и будет ожидать завершения, чтобы ссылки на отчёт оставались видимыми.
• Запустите из терминала — откройте Командную строку (нажмите Win+R, введите cmd, нажмите Enter) или PowerShell для передачи дополнительных параметров:

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.

Облачные оболочки

Запустите Maigret в браузере через облачные оболочки или Jupyter ноутбуки:

Локальная установка (pip)

# install from pypi
pip3 install maigret

# usage
maigret username

Из исходного кода

# 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 — автоматически запускает веб-интерфейс

# 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

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

Ошибки сборки? См. руководство по устранению неполадок.

PDF-отчёты (--pdf) — опциональная функция — установите с помощью pip install 'maigret[pdf]'. Они требуют графических библиотек системного уровня в Linux/macOS; см. раздел PDF отчёты для инструкций по установке для каждой ОС.

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

Примеры

# make HTML, PDF, and Xmind8 reports
maigret user --html
maigret user --pdf
maigret user --xmind #Output not compatible with xmind 2022+

# 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.

Запустите maigret --help для получения всех опций. Документация: Опции CLI, больше примеров. Встретили ошибки 403 или тайм-ауты? Смотрите TROUBLESHOOTING.md.

Веб-интерфейс

Maigret имеет встроенный веб-интерфейс с графом результатов и отчётами для скачивания.

Скриншоты веб-интерфейса

maigret --web 5000

Откройте http://127.0.0.1:5000, введите имя пользователя и просмотрите результаты.

Библиотека для Python

Maigret можно встроить в ваши собственные проекты на Python. CLI — это обёртка над асинхронной функцией, которую можно вызвать напрямую — создавайте собственные конвейеры, подавайте результаты в свои инструменты или запускайте в рамках более крупного рабочего процесса OSINT.

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

Полезные флаги CLI

• --parse URL — разобрать страницу профиля, извлечь ID/имена пользователей и использовать их для запуска рекурсивного поиска.
• --permute — сгенерировать вероятные варианты имени пользователя из двух или более входных данных (например, john doe → johndoe, j.doe, …) и искать все из них.
• --self-check [--auto-disable] — проверить пары usernameClaimed / usernameUnclaimed на актуальных сайтах для поддержателей, аудирующих базу данных.
• --ai / --ai-model — выполнить ИИ-анализ над результатами поиска и вывести краткую сводку исследования в терминал.

ИИ-анализ

--ai собирает результаты поиска, формирует внутренний отчёт в Markdown и отправляет его в совместимый с OpenAI endpoint для завершения чата, чтобы создать краткую, нейтральную сводку исследования (возможное реальное имя, местоположение, профессия, интересы, языки, уверенность, направления для дальнейшего расследования). Прогресс по каждому сайту скрыт, а вывод модели стримится в stdout.

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, локальный сервер и т.д.). Смотрите документацию по настройкам для полного списка опций.

Tor / I2P / прокси

Maigret может направлять проверки через прокси, Tor или I2P — полезно для сайтов .onion / .i2p и для обхода WAF, блокирующих IP дата-центров.

# 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:

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 соответствует. Смотрите документацию по функции для параметров серверной части и конфигурации.

Участие в разработке

Добавляйте или исправляйте новые сайты точечно в data.json (без json.load/json.dump), затем запускайте ./utils/update_site_data.py для перегенерации sites.md и метаданных базы данных, и открывайте pull request. Для более подробной информации смотрите руководство по участию и документацию для разработчиков. История релизов: CHANGELOG.md.

Коммерческое использование

Open-source Maigret лицензирован по MIT и бесплатен для коммерческого использования без ограничений — но проверки сайтов со временем ломаются и требуют активного обслуживания.

Для серьёзного коммерческого использования — с ежедневно обновляемой базой данных сайтов или API для проверки имён пользователей — обращайтесь: 📧 maigret@soxoj.com

• Частная база данных сайтов — 5 000+ сайтов, обновляется ежедневно (отдельно от публичной open-source базы данных)
• API для проверки имён пользователей — интегрируйте Maigret в ваш продукт

О проекте

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

Только в образовательных и законных целях. Вы несёте ответственность за соблюдение всех применимых законов (GDPR, CCPA и т.д.) в вашей юрисдикции. Авторы не несут ответственности за неправильное использование.

Обратная связь

Создайте задачу · Обсуждения на GitHub · Telegram

Классификация SOWEL

Используемые техники OSINT: - SOTL-2.2. Поиск аккаунтов на других платформах - SOTL-6.1. Проверка повторного использования логинов для поиска другого аккаунта - SOTL-6.2. Проверка повторного использования никнеймов для поиска другого аккаунта

Лицензия

MIT © Maigret