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: 2 months ago
JSON representation

🕵️‍♂️ Collect a dossier on a person by username from thousands of sites

Lists

README 

        
# 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](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 retries



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

Run on Replit



Open In Colab

Open In Binder



### Package installing



**NOTE**: Python 3.7 or higher and pip is required, **Python 3.8 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

pip3 install -r requirements.txt



# usage

./maigret.py 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 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).



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



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