Maigret

English · 简体中文

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

Спонсоры

IPcook предоставляет надёжные резидентные прокси для онлайн-исследований, поиска имён пользователей и рабочих процессов сбора публичных данных. Высокий процент успешных запросов • Аптайм 99.99% • Время ответа менее 0.5 с • Помесячная оплата и Pay-as-you-go • Бессрочный трафик • До 10 бесплатных субакаунтов для командной работы • Резидентные прокси от $0.3 до $3.2/GB.
Специальное предложение: доступен бесплатный пробный трафик 100MB. Используйте код WELCOME20 для скидки 20%.

RapidProxy предоставляет высокопроизводительные резидентные прокси для парсинга Twitter, автоматизации Selenium и извлечения веб-данных. 90M+ IP • Умная ротация • Защита от блокировок • Бессрочный трафик.
Специальное предложение: Попробуйте бесплатно — тарифы от $0.65/GB. Используйте код RAPID10 для скидки 10%.

За одну минуту

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

pip install maigret
maigret YOUR_USERNAME

Без установки? Попробуйте Telegram-бота сообщества или Cloud Shell.

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

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

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

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

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

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

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

Демо

Видео

Отчёты

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

Скриншот HTML-отчёта

Скриншот отчёта XMind 8

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

Установка

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

Не хотите ничего устанавливать? Воспользуйтесь 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.

Cloud Shells

Запустите Maigret в браузере через Cloud Shell или 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 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.

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

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

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

Не хотите запускать сами? Разверните опубликованный Docker-образ soxoj/maigret:web как хостинговое приложение в один клик:

Работает на бесплатном тарифе Render (останавливается после 15 минут простоя и снова запускается при следующем запросе). На инстансе не настроен вход, поэтому любой, у кого есть URL, может им пользоваться.

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

Веб-интерфейс: как начать

Веб-интерфейс: результаты

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 конечную точку chat completion, чтобы получить краткую нейтральную сводку расследования (вероятное настоящее имя, местоположение, профессия, интересы, языки, уверенность, дальнейшие зацепки). Прогресс по каждому сайту скрывается, а вывод модели потоково передаётся в 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. По умолчанию конечная точка — https://api.openai.com/v1, но openai_api_base_url в settings.json может указывать на любой OpenAI-совместимый API (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. Подробнее см. руководство по CONTRIBUTING и документацию для разработчиков. История релизов: CHANGELOG.md.

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

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

Для серьёзного коммерческого использования — с ежедневно обновляемой базой сайтов или API проверки имён пользователей — свяжитесь с нами: 📧 [email protected]

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

О проекте

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

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

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

Открыть issue · Обсуждения на GitHub · Telegram

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

Используемые OSINT-техники:

Лицензия

MIT © Maigret

maigret v0.6.4

Категории