Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/soxoj/maigret
🕵️♂️ Collect a dossier on a person by username from thousands of sites
https://github.com/soxoj/maigret
detective dossier identification investigation namechecker nickname osint page-parsing parsing profiles python python3 recursive-search sherlock social-network socmint username username-checker username-search
Last synced: about 1 month ago
JSON representation
🕵️♂️ Collect a dossier on a person by username from thousands of sites
- Host: GitHub
- URL: https://github.com/soxoj/maigret
- Owner: soxoj
- License: mit
- Created: 2020-06-27T14:16:42.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-07-23T14:19:43.000Z (about 2 months ago)
- Last Synced: 2024-07-24T16:52:42.380Z (about 2 months ago)
- Topics: detective, dossier, identification, investigation, namechecker, nickname, osint, page-parsing, parsing, profiles, python, python3, recursive-search, sherlock, social-network, socmint, username, username-checker, username-search
- Language: Python
- Homepage: https://t.me/osint_maigret_bot
- Size: 5.53 MB
- Stars: 9,938
- Watchers: 91
- Forks: 777
- Open Issues: 394
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome - soxoj/maigret - 🕵️♂️ Collect a dossier on a person by username from thousands of sites (Python)
- Offensive-OSINT-Tools - maigret
- project-awesome - soxoj/maigret - 🕵️♂️ Collect a dossier on a person by username from thousands of sites (Python)
- StarryDivineSky - soxoj/maigret
README
# Maigret
The Commissioner Jules Maigret is a fictional French police detective, created by Georges Simenon. His investigation method is based on understanding the personality of different people and their interactions.
👉👉👉 [Online Telegram bot](https://t.me/osint_maigret_bot)
## About
**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. Maigret is an easy-to-use and powerful fork of [Sherlock](https://github.com/sherlock-project/sherlock).
Currently supported more than 3000 sites ([full list](https://github.com/soxoj/maigret/blob/main/sites.md)), search is launched against 500 popular sites in descending order of popularity by default. Also supported checking of Tor sites, I2P sites, and domains (via DNS resolving).
## Main features
* Profile pages parsing, [extraction](https://github.com/soxoj/socid_extractor) of personal info, links to other profiles, etc.
* Recursive search by new usernames and other ids found
* Search by tags (site categories, countries)
* Censorship and captcha detection
* Requests retriesSee full description of Maigret features [in the documentation](https://maigret.readthedocs.io/en/latest/features.html).
## Installation
‼️ Maigret is available online via [official Telegram bot](https://t.me/osint_maigret_bot).
Maigret can be installed using pip, Docker, or simply can be launched from the cloned repo.
Standalone EXE-binaries for Windows are located in [Releases section](https://github.com/soxoj/maigret/releases) of GitHub repository.
Also, you can run Maigret using cloud shells and Jupyter notebooks (see buttons below).
[![Open in Cloud Shell](https://user-images.githubusercontent.com/27065646/92304704-8d146d80-ef80-11ea-8c29-0deaabb1c702.png)](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/soxoj/maigret&tutorial=README.md)
### Package installing
**NOTE**: Python 3.10 or higher and pip is required, **Python 3.11 is recommended.**
```bash
# install from pypi
pip3 install maigret# usage
maigret username
```### Cloning a repository
```bash
# or clone and install manually
git clone https://github.com/soxoj/maigret && cd maigret# build and install
pip3 install .# usage
maigret username
```### Docker
```bash
# official image
docker pull soxoj/maigret# usage
docker run -v /mydir:/app/reports soxoj/maigret:latest username --html# manual build
docker build -t maigret .
```## Usage examples
```bash
# make HTML, PDF, and Xmind8 reports
maigret user --html
maigret user --pdf
maigret user --xmind #Output not compatible with xmind 2022+# search on sites marked with tags photo & dating
maigret user --tags photo,dating# search on sites marked with tag us
maigret user --tags us# search for three usernames on all available sites
maigret user1 user2 user3 -a
```Use `maigret --help` to get full options description. Also options [are documented](https://maigret.readthedocs.io/en/latest/command-line-options.html).
## Contributing
Contribution guidelines can be found [here](CONTRIBUTING)
Maigret has open-source code, so you may contribute your own sites by adding them to `data.json` file, or bring changes to it's code!
If you want to contribute, don't forget to activate statistics update hook, command for it would look like this: `git config --local core.hooksPath .githooks/`
You should make your git commits from your maigret git repo folder, or else the hook wouldn't find the statistics update script.## Demo with page parsing and recursive username search
[PDF report](https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.pdf), [HTML report](https://htmlpreview.github.io/?https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotographycars.html)
![animation of recursive search](https://raw.githubusercontent.com/soxoj/maigret/main/static/recursive_search.svg)
![HTML report screenshot](https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotography_html_screenshot.png)
![XMind 8 report screenshot](https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotography_xmind_screenshot.png)
[Full console output](https://raw.githubusercontent.com/soxoj/maigret/main/static/recursive_search.md)
### SOWEL classification
This tool uses the following OSINT techniques:
- [SOTL-2.2. Search For Accounts On Other Platforms](https://sowel.soxoj.com/other-platform-accounts)
- [SOTL-6.1. Check Logins Reuse To Find Another Account](https://sowel.soxoj.com/logins-reuse)
- [SOTL-6.2. Check Nicknames Reuse To Find Another Account](https://sowel.soxoj.com/nicknames-reuse)## License
MIT © [Maigret](https://github.com/soxoj/maigret)
MIT © [Sherlock Project](https://github.com/sherlock-project/)
Original Creator of Sherlock Project - [Siddharth Dushantha](https://github.com/sdushantha)