Skip to main content

Maigret

PyPI PyPI - Downloads

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.

About

Maigret collect 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 2000 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 Wiki.

Installation

Maigret can be installed using pip, Docker, or simply can be launched from the cloned repo. Also you can run Maigret using cloud shells (see buttons below).

Open in Cloud Shell Run on Repl.it Open In Colab

Package installing

NOTE: Python 3.6 or higher and pip is required, Python 3.8 is recommended.

# install from pypi
pip3 install maigret

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

# usage
maigret username

Cloning a repository

git clone https://github.com/soxoj/maigret && cd maigret
pip3 install -r requirements.txt

# usage
https://raw.githubusercontent.com/soxoj/maigret/main/maigret.py username

Docker

# official image
docker pull soxoj/maigret

# usage
docker run soxoj/maigret:latest username

# manual build
docker build -t maigret .

Usage examples

# make HTML and PDF reports
maigret user --html --pdf

# search on sites marked with tags photo & dating
maigret user --tags photo,dating

# 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 in the Maigret Wiki.

Demo with page parsing and recursive username search

PDF report, HTML report

animation of recursive search

HTML report screenshot

XMind report screenshot

Full console output

License

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

Metadata

Release files for maigret 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for maigret 0.3.0
File Size Uploaded
maigret-0.3.0.tar.gz 141.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for maigret 0.3.0
File Interpreter ABI Platform
maigret-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 293.7 kB

Release files / maigret-0.3.0.tar.gz

Download URL maigret-0.3.0.tar.gz
Size 141.7 kB
Tags Source
SHA-256 checksum
How to use checksums
3a7e6085e456d5b50cd56332345c0316deacec6e759c8812674ac5fc43aafa5b
BLAKE2b-256 checksum
How to use checksums
04554eecd84c9b3d1c5c49713f8779461c5ae3914b4e5e161c75c52f786823bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/4.4.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

Release files / maigret-0.3.0-py3-none-any.whl

Download URL maigret-0.3.0-py3-none-any.whl
Size 152.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bbb07834f5c71252cc7f732491a61132f0cbb5f058b04ca140a16f62d3d662d9
BLAKE2b-256 checksum
How to use checksums
f4e5642e42ed431a486a5d325412afb3c42ed1cb5c7d5880c08a9dcd6604365a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/4.4.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

Release history Release notifications | RSS feed

0.6.6

2 release files

0.6.5

2 release files

0.6.4

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.1

2 release files

This release

0.3.0 This release

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.1.19

2 release files

0.1.18

2 release files

0.1.17

2 release files

0.1.15

2 release files

0.1.14

2 release files

0.1.12

2 release files

0.1.11

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

1 release file

0.1.6

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page