{"id":13467845,"url":"https://github.com/soxoj/maigret","last_synced_at":"2025-05-13T10:52:02.125Z","repository":{"id":36969152,"uuid":"275386910","full_name":"soxoj/maigret","owner":"soxoj","description":"🕵️‍♂️ Collect a dossier on a person by username from thousands of sites","archived":false,"fork":false,"pushed_at":"2025-04-11T06:42:44.000Z","size":13249,"stargazers_count":15218,"open_issues_count":288,"forks_count":1043,"subscribers_count":110,"default_branch":"main","last_synced_at":"2025-05-05T20:27:26.749Z","etag":null,"topics":["blueteam","cybersecurity","identification","investigation","namechecker","open-source","osint","osint-framework","osint-python","parsing","python","python3","redteam","scraping","sherlock","social-network","socmint","username","username-checker","username-search"],"latest_commit_sha":null,"homepage":"https://t.me/osint_maigret_bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soxoj.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"patreon":"soxoj","github":"soxoj","buy_me_a_coffee":"soxoj"}},"created_at":"2020-06-27T14:16:42.000Z","updated_at":"2025-05-05T17:20:55.000Z","dependencies_parsed_at":"2024-04-10T10:45:44.118Z","dependency_job_id":"c221ed24-70f4-4c42-8a97-7f8342bdc995","html_url":"https://github.com/soxoj/maigret","commit_stats":{"total_commits":651,"total_committers":26,"mean_commits":25.03846153846154,"dds":0.695852534562212,"last_synced_commit":"4c2a21832bf16392e680fbda65f6a7abc0b5fc7b"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soxoj%2Fmaigret","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soxoj%2Fmaigret/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soxoj%2Fmaigret/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soxoj%2Fmaigret/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soxoj","download_url":"https://codeload.github.com/soxoj/maigret/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253929189,"owners_count":21985799,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blueteam","cybersecurity","identification","investigation","namechecker","open-source","osint","osint-framework","osint-python","parsing","python","python3","redteam","scraping","sherlock","social-network","socmint","username","username-checker","username-search"],"created_at":"2024-07-31T15:01:01.289Z","updated_at":"2025-05-13T10:52:02.049Z","avatar_url":"https://github.com/soxoj.png","language":"Python","readme":"# Maigret\n\n\u003cp align=\"center\"\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pypi.org/project/maigret/\"\u003e\n        \u003cimg alt=\"PyPI version badge for Maigret\" src=\"https://img.shields.io/pypi/v/maigret?style=flat-square\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/maigret/\"\u003e  \n        \u003cimg alt=\"PyPI download count for Maigret\" src=\"https://img.shields.io/pypi/dw/maigret?style=flat-square\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/soxoj/maigret\"\u003e\n        \u003cimg alt=\"Minimum Python version required: 3.10+\" src=\"https://img.shields.io/badge/Python-3.10%2B-brightgreen?style=flat-square\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/soxoj/maigret/blob/main/LICENSE\"\u003e\n        \u003cimg alt=\"License badge for Maigret\" src=\"https://img.shields.io/github/license/soxoj/maigret?style=flat-square\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/soxoj/maigret\"\u003e\n        \u003cimg alt=\"View count for Maigret project\" src=\"https://komarev.com/ghpvc/?username=maigret\u0026color=brightgreen\u0026label=views\u0026style=flat-square\" /\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/soxoj/maigret/main/static/maigret.png\" height=\"300\"/\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\u003ci\u003eThe 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.\u003c/i\u003e\n\n\u003cb\u003e👉👉👉 [Online Telegram bot](https://t.me/osint_maigret_bot)\u003c/b\u003e\n\n## About\n\n**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 are required. Maigret is an easy-to-use and powerful fork of [Sherlock](https://github.com/sherlock-project/sherlock).\n\nCurrently supports 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 Tor sites, I2P sites, and domains (via DNS resolving).\n\n## Powered By Maigret\n\nThese are professional tools for social media content analysis and OSINT investigations that use Maigret (banners are clickable).\n\n\u003ca href=\"https://github.com/SocialLinks-IO/sociallinks-api\"\u003e\u003cimg height=\"60\" alt=\"Social Links API\" src=\"https://github.com/user-attachments/assets/789747b2-d7a0-4d4e-8868-ffc4427df660\"\u003e\u003c/a\u003e\n\u003ca href=\"https://sociallinks.io/products/sl-crimewall\"\u003e\u003cimg height=\"60\" alt=\"Social Links Crimewall\" src=\"https://github.com/user-attachments/assets/0b18f06c-2f38-477b-b946-1be1a632a9d1\"\u003e\u003c/a\u003e\n\u003ca href=\"https://usersearch.ai/\"\u003e\u003cimg height=\"60\" alt=\"UserSearch\" src=\"https://github.com/user-attachments/assets/66daa213-cf7d-40cf-9267-42f97cf77580\"\u003e\u003c/a\u003e\n\n## Main features\n\n* Profile page parsing, [extraction](https://github.com/soxoj/socid_extractor) of personal info, links to other profiles, etc.\n* Recursive search by new usernames and other IDs found\n* Search by tags (site categories, countries)\n* Censorship and captcha detection\n* Requests retries\n\nSee the full description of Maigret features [in the documentation](https://maigret.readthedocs.io/en/latest/features.html).\n\n## Installation\n\n‼️ Maigret is available online via [official Telegram bot](https://t.me/osint_maigret_bot). Consider using it if you don't want to install anything.\n\n### Windows\n\nStandalone EXE-binaries for Windows are located in [Releases section](https://github.com/soxoj/maigret/releases) of GitHub repository.\n\nVideo guide on how to run it: https://youtu.be/qIgwTZOmMmM.\n\n### Installation in Cloud Shells\n\nYou can launch Maigret using cloud shells and Jupyter notebooks. Press one of the buttons below and follow the instructions to launch it in your browser.\n\n[![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\u0026tutorial=README.md)\n\u003ca href=\"https://repl.it/github/soxoj/maigret\"\u003e\u003cimg src=\"https://replit.com/badge/github/soxoj/maigret\" alt=\"Run on Replit\" height=\"50\"\u003e\u003c/a\u003e\n\n\u003ca href=\"https://colab.research.google.com/gist/soxoj/879b51bc3b2f8b695abb054090645000/maigret-collab.ipynb\"\u003e\u003cimg src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\" height=\"45\"\u003e\u003c/a\u003e\n\u003ca href=\"https://mybinder.org/v2/gist/soxoj/9d65c2f4d3bec5dd25949197ea73cf3a/HEAD\"\u003e\u003cimg src=\"https://mybinder.org/badge_logo.svg\" alt=\"Open In Binder\" height=\"45\"\u003e\u003c/a\u003e\n\n### Local installation\n\nMaigret can be installed using pip, Docker, or simply can be launched from the cloned repo.\n\n\n**NOTE**: Python 3.10 or higher and pip is required, **Python 3.11 is recommended.**\n\n```bash\n# install from pypi\npip3 install maigret\n\n# usage\nmaigret username\n```\n\n### Cloning a repository\n\n```bash\n# or clone and install manually\ngit clone https://github.com/soxoj/maigret \u0026\u0026 cd maigret\n\n# build and install\npip3 install .\n\n# usage\nmaigret username\n```\n\n### Docker\n\n```bash\n# official image\ndocker pull soxoj/maigret\n\n# usage\ndocker run -v /mydir:/app/reports soxoj/maigret:latest username --html\n\n# manual build\ndocker build -t maigret .\n```\n\n## Usage examples\n\n```bash\n# make HTML, PDF, and Xmind8 reports\nmaigret user --html\nmaigret user --pdf\nmaigret user --xmind #Output not compatible with xmind 2022+\n\n# search on sites marked with tags photo \u0026 dating\nmaigret user --tags photo,dating\n\n# search on sites marked with tag us\nmaigret user --tags us\n\n# search for three usernames on all available sites\nmaigret user1 user2 user3 -a\n```\n\nUse `maigret --help` to get full options description. Also options [are documented](https://maigret.readthedocs.io/en/latest/command-line-options.html).\n\n### Web interface\n\nYou can run Maigret with a web interface, where you can view the graph with results and download reports of all formats on a single page.\n\n\u003cdetails\u003e\n\u003csummary\u003eWeb Interface Screenshots\u003c/summary\u003e\n\n![Web interface: how to start](https://raw.githubusercontent.com/soxoj/maigret/main/static/web_interface_screenshot_start.png)\n\n![Web interface: results](https://raw.githubusercontent.com/soxoj/maigret/main/static/web_interface_screenshot.png)\n\n\u003c/details\u003e\n\nInstructions:\n\n1. Run Maigret with the ``--web`` flag and specify the port number.\n\n```console\nmaigret --web 5000\n```\n2. Open http://127.0.0.1:5000 in your browser and enter one or more usernames to make a search.\n\n3. Wait a bit for the search to complete and view the graph with results, the table with all accounts found, and download reports of all formats.\n\n## Contributing\n\nMaigret 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!\n\nFor more information about development and contribution, please read the [development documentation](https://maigret.readthedocs.io/en/latest/development.html).\n\n## Demo with page parsing and recursive username search\n\n### Video (asciinema)\n\n\u003ca href=\"https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ\"\u003e\n  \u003cimg src=\"https://asciinema.org/a/Ao0y7N0TTxpS0pisoprQJdylZ.svg\" alt=\"asciicast\" width=\"600\"\u003e\n\u003c/a\u003e\n\n### Reports\n\n[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)\n\n![HTML report screenshot](https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotography_html_screenshot.png)\n\n![XMind 8 report screenshot](https://raw.githubusercontent.com/soxoj/maigret/main/static/report_alexaimephotography_xmind_screenshot.png)\n\n[Full console output](https://raw.githubusercontent.com/soxoj/maigret/main/static/recursive_search.md)\n\n## Disclaimer\n\n**This tool is intended for educational and lawful purposes only.** The developers do not endorse or encourage any illegal activities or misuse of this tool. Regulations regarding the collection and use of personal data vary by country and region, including but not limited to GDPR in the EU, CCPA in the USA, and similar laws worldwide.\n\nIt is your sole responsibility to ensure that your use of this tool complies with all applicable laws and regulations in your jurisdiction. Any illegal use of this tool is strictly prohibited, and you are fully accountable for your actions.\n\nThe authors and developers of this tool bear no responsibility for any misuse or unlawful activities conducted by its users.\n\n## Feedback\n\nIf you have any questions, suggestions, or feedback, please feel free to [open an issue](https://github.com/soxoj/maigret/issues), create a [GitHub discussion](https://github.com/soxoj/maigret/discussions), or contact the author directly via [Telegram](https://t.me/soxoj).\n\n## SOWEL classification\n\nThis tool uses the following OSINT techniques:\n- [SOTL-2.2. Search For Accounts On Other Platforms](https://sowel.soxoj.com/other-platform-accounts)\n- [SOTL-6.1. Check Logins Reuse To Find Another Account](https://sowel.soxoj.com/logins-reuse)\n- [SOTL-6.2. Check Nicknames Reuse To Find Another Account](https://sowel.soxoj.com/nicknames-reuse) \n\n## License\n\nMIT © [Maigret](https://github.com/soxoj/maigret)\u003cbr/\u003e\nMIT © [Sherlock Project](https://github.com/sherlock-project/)\u003cbr/\u003e\nOriginal Creator of Sherlock Project - [Siddharth Dushantha](https://github.com/sdushantha)\n","funding_links":["https://patreon.com/soxoj","https://github.com/sponsors/soxoj","https://buymeacoffee.com/soxoj"],"categories":["Python","Endpoint","[↑](#-table-of-contents) Nickname search","扫描器、资产收集、子域名","[↑](#-table-of-contents) Username Check","[↑](#-Table-of-Contents) Username Check","1. [↑](#-content) OSINT","python3","OSINT","Repos","ابزارهای امنیتی"],"sub_categories":["Forensics","Tools","网络服务_其他","[↑](#-table-of-contents) Telegram","[↑](#-Table-of-Contents) Telegram","Personensuche","کار با زمان و تقویم","[↑](#-table-of-contents) GitHub"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoxoj%2Fmaigret","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoxoj%2Fmaigret","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoxoj%2Fmaigret/lists"}