Skip to content
forked from soxoj/maigret

πŸ•΅οΈβ€β™‚οΈ Collect a dossier on a person by username from thousands of sites

License

Notifications You must be signed in to change notification settings

hababisha/maigret

This branch is 110 commits behind soxoj/maigret:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4331b5f Β· Oct 21, 2024
Oct 1, 2022
Oct 21, 2024
Apr 12, 2023
Oct 21, 2024
Oct 15, 2023
Jan 18, 2022
Jul 23, 2024
May 14, 2024
Dec 4, 2020
Jun 7, 2022
Sep 3, 2022
Jun 12, 2021
Jun 20, 2024
Oct 4, 2022
May 24, 2024
Jan 31, 2021
Jan 12, 2021
Nov 5, 2021
Jun 20, 2024
Oct 27, 2023
Oct 21, 2024
May 24, 2024
Oct 21, 2024
Oct 21, 2024
Jan 15, 2022
May 24, 2024
May 24, 2024
Jul 7, 2023

Repository files navigation

Maigret

PyPI PyPI - Downloads Views

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

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.

Currently supported more than 3000 sites (full list), 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 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 retries

See full description of Maigret features in the documentation.

Installation

‼️ Maigret is available online via official Telegram 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 of GitHub repository.

Also, you can run Maigret using cloud shells and Jupyter notebooks (see buttons below).

Open in Cloud Shell Run on Replit

Open In Colab Open In Binder

Package installing

NOTE: Python 3.10 or higher and pip is required, Python 3.11 is recommended.

# install from pypi
pip3 install maigret

# usage
maigret username

Cloning a repository

# or clone and install manually
git clone https://github.com/soxoj/maigret && cd maigret

# build and install
pip3 install .

# usage
maigret username

Docker

# 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

# 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.

Contributing

Contribution guidelines can be found here

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, HTML report

animation of recursive search

HTML report screenshot

XMind 8 report screenshot

Full console output

SOWEL classification

This tool uses the following OSINT techniques:

License

MIT Β© Maigret
MIT Β© Sherlock Project
Original Creator of Sherlock Project - Siddharth Dushantha

About

πŸ•΅οΈβ€β™‚οΈ Collect a dossier on a person by username from thousands of sites

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 65.2%
  • HTML 29.0%
  • Smarty 3.7%
  • Batchfile 1.2%
  • Makefile 0.3%
  • Jupyter Notebook 0.3%
  • Other 0.3%