Metadata-Version: 2.1
Name: maigret
Version: 0.4.4
Summary: Collect a dossier on a person by username from a huge number of sites
Home-page: https://github.com/soxoj/maigret
Author: Soxoj
Author-email: soxoj@protonmail.com
License: MIT
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiodns (==3.0.0)
Requires-Dist: aiohttp (==3.8.1)
Requires-Dist: aiohttp-socks (==0.7.1)
Requires-Dist: arabic-reshaper (==2.1.3)
Requires-Dist: async-timeout (==4.0.2)
Requires-Dist: attrs (==22.1.0)
Requires-Dist: certifi (==2022.6.15)
Requires-Dist: chardet (==5.0.0)
Requires-Dist: colorama (==0.4.5)
Requires-Dist: future (==0.18.2)
Requires-Dist: future-annotations (==1.0.0)
Requires-Dist: html5lib (==1.1)
Requires-Dist: idna (==3.3)
Requires-Dist: Jinja2 (==3.1.2)
Requires-Dist: lxml (==4.9.1)
Requires-Dist: MarkupSafe (==2.1.1)
Requires-Dist: mock (==4.0.3)
Requires-Dist: multidict (==6.0.2)
Requires-Dist: pycountry (==22.3.5)
Requires-Dist: PyPDF2 (==2.10.4)
Requires-Dist: PySocks (==1.7.1)
Requires-Dist: python-bidi (==0.4.2)
Requires-Dist: requests (==2.28.1)
Requires-Dist: requests-futures (==1.0.0)
Requires-Dist: six (==1.16.0)
Requires-Dist: socid-extractor (>=0.0.21)
Requires-Dist: soupsieve (==2.3.2.post1)
Requires-Dist: stem (==1.8.0)
Requires-Dist: torrequest (==0.1.0)
Requires-Dist: tqdm (==4.64.1)
Requires-Dist: typing-extensions (==4.3.0)
Requires-Dist: webencodings (==0.5.1)
Requires-Dist: xhtml2pdf (==0.2.8)
Requires-Dist: XMind (==1.2.0)
Requires-Dist: yarl (==1.7.2)
Requires-Dist: networkx (==2.5.1)
Requires-Dist: pyvis (==0.2.1)
Requires-Dist: reportlab (==3.6.11)
Requires-Dist: cloudscraper (==1.2.64)

# Maigret

<p align="center">
  <p align="center">
    <a href="https://pypi.org/project/maigret/">
      <img alt="PyPI" src="https://img.shields.io/pypi/v/maigret?style=flat-square">
    </a>
    <a href="https://pypi.org/project/maigret/">
      <img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dw/maigret?style=flat-square">
    </a>
    <a href="https://pypi.org/project/maigret/">
      <img alt="Views" src="https://komarev.com/ghpvc/?username=maigret&color=brightgreen&label=views&style=flat-square">
    </a>
  </p>
  <p align="center">
    <img src="https://raw.githubusercontent.com/soxoj/maigret/main/static/maigret.png" height="200"/>
  </p>
</p>

<i>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.</i>

## 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](https://github.com/sherlock-project/sherlock).

Currently supported more than 2500 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 retries

See full description of Maigret features [in the documentation](https://maigret.readthedocs.io/en/latest/features.html).

## Installation

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)
<a href="https://repl.it/github/soxoj/maigret"><img src="https://user-images.githubusercontent.com/27065646/92304596-bf719b00-ef7f-11ea-987f-2c1f3c323088.png" alt="Run on Repl.it" height="50"></a>

<a href="https://colab.research.google.com/gist/soxoj/879b51bc3b2f8b695abb054090645000/maigret-collab.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab" height="45"></a>
<a href="https://mybinder.org/v2/gist/soxoj/9d65c2f4d3bec5dd25949197ea73cf3a/HEAD"><img src="https://mybinder.org/badge_logo.svg" alt="Open In Binder" height="45"></a>

### Package installing

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

```bash
# 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

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

# usage
./maigret.py username
```

### Docker

```bash
# official image
docker pull soxoj/maigret

# usage
docker run soxoj/maigret:latest username

# manual build
docker build -t maigret .
```

## Usage examples

```bash
# 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](https://maigret.readthedocs.io/en/latest/command-line-options.html).


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

## License

MIT © [Maigret](https://github.com/soxoj/maigret)<br/>
MIT © [Sherlock Project](https://github.com/sherlock-project/)<br/>
Original Creator of Sherlock Project - [Siddharth Dushantha](https://github.com/sdushantha)