Skip to main content

Collect a dossier on a person by username from a huge number of sites

Reason this release was yanked:

report generation bug

Project description

Maigret

PyPI PyPI - Downloads Chat - Gitter

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

Purpose of Maigret - collect a dossier on a person by username only, checking for accounts on a huge number of sites.

This is a sherlock fork with cool features under heavy development. Don't forget to regularly update source code from repo.

Currently supported more than 2000 sites (full list), by default search is launched against 500 popular sites in descending order of popularity.

Main features

  • Profile pages parsing, extracting personal info, links to other profiles, etc.
  • Recursive search by new usernames found
  • Search by tags (site categories, countries)
  • Censorship and captcha detection
  • Very few false positives
  • Failed requests' restarts

Installation

NOTE: Python 3.6 or higher and pip is required.

Python 3.8 is recommended.

Package installing

# install from pypi
pip3 install maigret

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

Cloning a repository

git clone https://github.com/soxoj/maigret && cd maigret

You can use a free virtual machine, the repo will be automatically cloned:

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

pip3 install -r requirements.txt

Using examples

# for a cloned repo
https://raw.githubusercontent.com/soxoj/maigret/main/maigret.py user

# for a package
maigret user

Features:

# 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

Run maigret --help to get arguments description. Also options are documented in the Maigret Wiki.

With Docker:

# manual build
docker build -t maigret . && docker run maigret user

# official image
docker run soxoj/maigret:latest user

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

maigret-0.1.20.tar.gz (127.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

maigret-0.1.20-py3-none-any.whl (136.7 kB view details)

Uploaded Python 3

File details

Details for the file maigret-0.1.20.tar.gz.

File metadata

  • Download URL: maigret-0.1.20.tar.gz
  • Upload date:
  • Size: 127.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4

File hashes

Hashes for maigret-0.1.20.tar.gz
Algorithm Hash digest
SHA256 072633779b8715e325c874b25cd1f0449eb9a25a736963fc5923639879df31c1
MD5 02adbda5b40d7d25bb72545eb0a8c032
BLAKE2b-256 9fac2fd7fb60882543899ebfa8605667a77824b3abe3a4149baed17231ed8e61

See more details on using hashes here.

File details

Details for the file maigret-0.1.20-py3-none-any.whl.

File metadata

  • Download URL: maigret-0.1.20-py3-none-any.whl
  • Upload date:
  • Size: 136.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4

File hashes

Hashes for maigret-0.1.20-py3-none-any.whl
Algorithm Hash digest
SHA256 77b75dd01ee2228ffdb208ca23ef99cf95a400114b5f2ca32ccc2de712ea3a0b
MD5 8a7364c42df0c9af72eaa1656061d537
BLAKE2b-256 718f575324eb78db6f0c093563f3e1a35b7bd15e6afa40cb8583a98c5f38a255

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page