Maigret
Username dossier builder — 2800+ sites, profile data extraction, identity correlation.
Quick Start
pip install maigret
# Basic search
maigret username
# Search with HTML report
maigret username --html
# Limit to top N sites (faster)
maigret username --top-sites 500
# Search multiple usernames
maigret username1 username2
Core Flags
| Flag | Purpose |
|---|---|
--top-sites <n> |
Search only top N sites by Alexa rank |
--html |
Generate HTML report |
--pdf |
Generate PDF report |
--csv |
CSV output |
--json |
JSON output |
--timeout <n> |
Per-site timeout (default: 30s) |
--retries <n> |
Retries per site |
--proxy <url> |
Use proxy |
--tor |
Route via Tor |
-a |
All sites (no limit) |
--parse-url <url> |
Extract username from profile URL |
--self-check |
Test site database integrity |
--tags <tags> |
Filter by site tags (e.g. social, dating, gaming) |
Common Workflows
Deep profile investigation:
maigret johndoe --html --pdf --top-sites 1000
# Opens report in browser; PDF for reporting
Fast sweep (quick wins):
maigret johndoe --top-sites 200 --timeout 10
Tagged category search:
# Social media only
maigret johndoe --tags social
# Dating sites (for social engineering intel)
maigret johndoe --tags dating
# Gaming platforms
maigret johndoe --tags gaming
Extract username from a known profile URL:
maigret --parse-url https://twitter.com/johndoe
# Auto-extracts "johndoe", runs full search
Via Tor (opsec):
# Start tor first
sudo service tor start
maigret johndoe --tor --top-sites 500
Multiple username variants (pipeline):
for user in johndoe john.doe john_doe jdoe83; do
maigret "$user" --csv --top-sites 300 2>/dev/null
done
vs Sherlock
| maigret | sherlock | |
|---|---|---|
| Sites | 2800+ | 400 |
| Profile data | Extracts name/bio/location | URL only |
| Linked accounts | Detects aliases | No |
| Reports | HTML/PDF/CSV | TXT/JSON/CSV |
| Speed | Slower | Fast |
| Best for | Deep investigation | Fast initial sweep |
Recommended workflow: sherlock for fast sweep → maigret on confirmed usernames.
Parse JSON Output
# Accounts found (from JSON report)
cat maigret_johndoe.json | jq '.sites | to_entries[] | select(.value.status == "Claimed") | {site: .key, url: .value.url}'
# Extracted personal data
cat maigret_johndoe.json | jq '.sites | to_entries[] | select(.value.extracted_data != null) | {site: .key, data: .value.extracted_data}'
Resources
| File | When to load |
|---|---|
references/dossier.md |
Report interpretation, linked account correlation, data extraction patterns |