Maigret

Русский · 简体中文

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

Sponsors

IPcook предоставляет надёжные резидентские прокси для онлайн-исследований, обнаружения имён пользователей и сбора публичных данных. Высокая скорость выполнения • 99.99% времени безотказной работы • Время ответа менее 0.5с • Ежемесячные и оплата за факт • Трафик не истекает • До 10 бесплатных подаккаунтов для командной работы • Резидентские прокси от $0.3–$3.2/ГБ.
Специальное предложение: Бесплатная пробная версия 100 МБ. Используйте код WELCOME20 для получения 20% скидки.

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

Contents

• In one minute
• Main features
• Demo
• Installation
• Usage
• Contributing
• Commercial Use
• About

In one minute

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

pip install maigret
maigret YOUR_USERNAME

Без установки? Попробуйте бота в Telegram или облачную оболочку.

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

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

Main features

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

Для полного списка функций смотрите документацию по функциям.

Used by

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

Демонстрация

Видео

Отчёты

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

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

Установка

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

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

Windows

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

• Дважды щёлкните по файлу — Maigret попросит ввести имя пользователя, выполнит поиск по умолчанию и остановится в конце, чтобы ссылки на отчёты оставались видимыми.
• Запустите из терминала — откройте Command Prompt (нажмите 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 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 минут простоя и снова запускается при следующем запросе). На экземпляре не настроена авторизация, поэтому им может пользоваться любой, у кого есть ссылка.

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

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

Contributing

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

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

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

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

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

О проекте

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

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

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

Создать issue · GitHub Discussions · Telegram

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

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

Лицензия

MIT © Maigret