Summary

Maigret is an open-source tool designed for collecting comprehensive user dossiers from over 3,000 websites using only a username. It targets OSINT professionals, researchers, and social media analysts seeking to quickly identify and gather information about individuals across the internet without the need for API keys. Its primary benefit is automating the laborious process of cross-referencing usernames across numerous platforms, providing a consolidated view of online presence.

How It Works

The tool operates by systematically querying a vast database of websites for a given username. It extracts available data directly from profile pages and, where possible, site APIs, including links to other associated accounts. Maigret employs a recursive search mechanism, leveraging discovered usernames and IDs to find further connections. It maintains an up-to-date site database, fetching updates from GitHub daily, with a fallback to a local version if offline. The system is engineered to detect and partially circumvent common blocking techniques like CAPTCHAs and censorship.

Quick Start & Requirements

• Primary Install: pip install maigret
• Prerequisites: Python 3.10 or higher.
• Usage: maigret YOUR_USERNAME
• Alternatives: Telegram bot, Cloud Shells, standalone Windows EXE, Docker images.
• Documentation: Quick start, features documentation, CLI options, library usage guide.

Highlighted Details

• Supports 3,000+ sites, with options to scan top-ranked, all, or filter by category/country tags.
• Performs recursive searches using discovered usernames and IDs to map connections.
• Detects and attempts to bypass blocks, censorship, and CAPTCHA mechanisms.
• Native support for Tor and I2P websites, including .onion and .i2p domains.
• Offers an embeddable Python library for programmatic integration.
• Includes a built-in web interface for visualizing results as a graph and downloading reports in various formats.

Maintenance & Community

The project relies on an auto-updated site database fetched from GitHub. Contributions are guided by a detailed CONTRIBUTING document. Community interaction is facilitated through GitHub Discussions and a Telegram group.

Licensing & Compatibility

Maigret is released under the MIT license, permitting free commercial use without explicit restrictions.

Limitations & Caveats

The effectiveness of site checks can degrade over time due to website changes, necessitating ongoing maintenance. For critical commercial applications requiring guaranteed up-to-date data, the project offers a separate, daily-updated site database and username-check API service. The tool is intended strictly for educational and lawful purposes, with users solely responsible for adhering to all applicable laws.