Maigret

English · 简体中文 · Français

📖 Documentation

Maigret collects a dossier on a person by username only, checking for accounts on a huge number of sites and gathering all the available information from web pages. No API keys required. AI profiling (demo).

Sponsors

Noimosiny is a comprehensive OSINT platform for professional investigators and analysts. Reverse email, phone number, and username search across 250+ modules. Automate your intelligence gathering with our powerful tools.

RapidProxy provides high-performance residential proxies for Twitter scraping, Selenium automation, and web data extraction. 90M+ IPs • Smart rotation • Anti-block • Non-expiring traffic.
Special Offer: Try it free — Plans from $0.65/GB. Use code RAPID10 for 10% off.

ThorData provides residential proxies and web data APIs for OSINT research, username lookup, and search reconnaissance. Access 100M+ residential IPs across 190+ countries to reduce failed requests, 403 errors, and location-based restrictions. Use SERP API for structured search results or Web Scraper API to collect public web data.
Special Offer: Get a free 3-day trial and 10% OFF with code SOXOJ10.

Contents

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

In one minute

Ensure you have Python 3.10 or higher.

pip install maigret
maigret YOUR_USERNAME

No install? Try the community Telegram bot or a Cloud Shell.

Want a web UI? See how to launch it.

See also: Quick start.

Main features

• Supports 5,900 sites (see full list). A default run checks the 500 highest-ranked sites by traffic; pass -a to scan everything, or --tags to narrow by category/country.
• Embeddable in Python projects — import maigret and run searches programmatically (see library usage).
• Extracts all available information about the account owner from profile pages and site APIs, including links to other accounts.
• Performs recursive search using discovered usernames and other IDs.
• Allows filtering by tags (site categories, countries).
• Detects and partially bypasses blocks, censorship, and CAPTCHA.
• Fetches an auto-updated site database from GitHub each run (once per 24 hours), and falls back to the built-in database if offline.
• Works with Tor and I2P websites; able to check domains.
• Ships with a web interface for browsing results as a graph and downloading reports in every format from a single page.
• Optional AI analysis mode (--ai) that turns raw findings into a short investigation summary using an OpenAI-compatible API.

For the complete feature list, see the features documentation.

Used by

Professional OSINT and social-media analysis tools built on Maigret:

Demo

Video

Reports

PDF report, HTML report