soxoj /maigret

🕵️‍♂️ Collect a dossier on a person by username from 6K websites

★ 40,743⑂ 3,291👁 186⑃ 1,609● 1,663▤ 29
PythonMITCreated 2020-06-27maigret.app/gh
Download: v0.6.6v0.6.6 ↓0.6.62026-09-18
+75
Daily
+861
Weekly
+1,600
Monthly
40,743
stars
3,291
forks
186
watchers
1,609
prs
1,663
issues
29
releases

README

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.

bash
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

Top issues

Discussions

Latest release

v0.6.6 v0.6.6 2026-09-18
What's Changed
 Bump to 0.6.5 by @soxoj in https://github.com/soxoj/maigret/pull/3014
 Add a website link to the snap metadata by @soxoj in https://github.com/soxoj/maigret/pull/3017
 Drop the zero-width joiner from the snap summary by @soxoj in https://github.com/soxoj/maigret/pull/3022
 [LAPOINTE] Add 3 sites by @soxoj in https://github.com/soxoj/maigret/pull/3023
 [LAPOINTE] Disable fuzzies.wtf by @soxoj in https://github.com/soxoj/maigret/pull/3025
 Detect status-code checks in --submit fallback by @juliosuas in https://github.com/soxoj/maigret/pull/3024
 [LAPOINTE] Add 13 sites by @soxoj 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON