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

Go beyond account enumeration. WebVetted turns an email or username into a complete identity investigation with deep OSINT enrichment, breach intel, AI analysis, and an interactive identity graph.
Start an Investigation →

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