soxoj / maigret

# 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 reliable residential proxies for OSINT research, username lookup, and public data collection workflows.
Access 100M+ real residential IPs across 195+ countries unlimited concurrent connections with 99.99% uptime and stable connections, Rotating + Sticky Sessions, and high success rates.
 Special Offer: Free 3-day trial + 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.
 [code] 
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
Full console output
## Installation
Already ran the In one minute steps? You're set. Below are alternative methods.
Don't want to install anything? Use the community Telegram bot.
### Windows
Download `maigret_standalone.exe` from Releases. You can launch it two ways:
- **Double-cli