{"id":13467845,"url":"https://github.com/soxoj/maigret","last_synced_at":"2026-10-18T20:41:03.862Z","repository":{"id":36969152,"uuid":"275386910","full_name":"soxoj/maigret","owner":"soxoj","description":"🕵️‍♂️ Collect a dossier on a person by username from 6K websites","archived":false,"fork":false,"pushed_at":"2026-10-18T05:59:21.000Z","size":30426,"stargazers_count":39189,"open_issues_count":55,"forks_count":3092,"subscribers_count":183,"default_branch":"main","last_synced_at":"2026-10-18T15:23:53.618Z","etag":null,"topics":["cli","cybersecurity","identification","information-gathering","infosec","investigation","open-source","osint","osint-framework","osint-python","pentesting","python","python3","reconnaissance","redteam","scraping","sherlock","social-network","socmint","username"],"latest_commit_sha":null,"homepage":"https://maigret.app/gh","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"claude":null,"gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null},"funding":{"patreon":"soxoj","github":"soxoj","buy_me_a_coffee":"soxoj"}},"created_at":"2020-06-27T14:16:42.000Z","updated_at":"2026-10-18T15:17:21.000Z","dependencies_parsed_at":"2026-08-30T10:22:00.538Z","dependency_job_id":null,"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":31,"template":false,"template_full_name":null,"purl":"pkg:github/soxoj/maigret","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","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soxoj%2Fmaigret/sbom","scorecard":{"id":839678,"data":{"date":"2025-08-11","repo":{"name":"github.com/soxoj/maigret","commit":"6bd047fda3dcaac2fc117eed91f833c37cafdd82"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5.3,"checks":[{"name":"Code-Review","score":5,"reason":"Found 3/6 approved changesets -- score normalized to 5","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:26","Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql-analysis.yml:25","Warn: no topLevel permission defined: .github/workflows/build-docker-image.yml:1","Warn: no topLevel permission defined: .github/workflows/codeql-analysis.yml:1","Warn: no topLevel permission defined: .github/workflows/pyinstaller.yml:1","Warn: no topLevel permission defined: .github/workflows/python-package.yml:1","Info: topLevel 'contents' permission set to 'read': .github/workflows/python-publish.yml:10","Warn: no topLevel permission defined: .github/workflows/update-site-data.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact main not signed: https://api.github.com/repos/soxoj/maigret/releases/188959762","Warn: release artifact dev not signed: https://api.github.com/repos/soxoj/maigret/releases/188830094","Warn: release artifact v0.4.4 not signed: https://api.github.com/repos/soxoj/maigret/releases/76202961","Warn: release artifact v0.4.3 not signed: https://api.github.com/repos/soxoj/maigret/releases/64400453","Warn: release artifact main does not have provenance: https://api.github.com/repos/soxoj/maigret/releases/188959762","Warn: release artifact dev does not have provenance: https://api.github.com/repos/soxoj/maigret/releases/188830094","Warn: release artifact v0.4.4 does not have provenance: https://api.github.com/repos/soxoj/maigret/releases/76202961","Warn: release artifact v0.4.3 does not have provenance: https://api.github.com/repos/soxoj/maigret/releases/64400453"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-docker-image.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/build-docker-image.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-docker-image.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/build-docker-image.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-docker-image.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/build-docker-image.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build-docker-image.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/build-docker-image.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:67: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pyinstaller.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/pyinstaller.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pyinstaller.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/pyinstaller.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pyinstaller.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/pyinstaller.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pyinstaller.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/pyinstaller.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pyinstaller.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/pyinstaller.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-package.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/python-package.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-package.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/python-package.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-package.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/python-package.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-publish.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/python-publish.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/python-publish.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/python-publish.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/python-publish.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/python-publish.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/update-site-data.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/soxoj/maigret/update-site-data.yml/main?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating python:3.10-slim to python:3.10-slim@sha256:420fbb0e468d3eaf0f7e93ea6f7a48792cbcadc39d43ac95b96bee2afe4367da","Warn: pipCommand not pinned by hash: Dockerfile:4","Warn: pipCommand not pinned by hash: Dockerfile:15","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:27","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:28","Warn: pipCommand not pinned by hash: .github/workflows/update-site-data.yml:20","Info:   0 out of  12 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   8 third-party GitHubAction dependencies pinned","Info:   0 out of   1 containerImage dependencies pinned","Info:   0 out of   5 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/build-docker-image.yml:8"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":7,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":7,"reason":"3 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-xqrq-4mgf-ff32","Warn: Project is vulnerable to: GHSA-4vvm-4w3v-6mr8","Warn: Project is vulnerable to: GHSA-jj5c-hhrg-vv5h"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-23T20:09:16.510Z","repository_id":36969152,"created_at":"2025-08-23T20:09:16.510Z","updated_at":"2025-08-23T20:09:16.510Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38341173,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-18T02:00:06.448Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cli","cybersecurity","identification","information-gathering","infosec","investigation","open-source","osint","osint-framework","osint-python","pentesting","python","python3","reconnaissance","redteam","scraping","sherlock","social-network","socmint","username"],"created_at":"2024-07-31T15:01:01.289Z","updated_at":"2026-10-18T20:41:03.849Z","avatar_url":"https://github.com/soxoj.png","language":"Python","funding_links":["https://patreon.com/soxoj","https://github.com/sponsors/soxoj","https://buymeacoffee.com/soxoj"],"categories":["Python","Security","Endpoint","[↑](#-table-of-contents) Nickname search","[↑](#-table-of-contents) Username Check","[↑](#-Table-of-Contents) Username Check","信息获取","1. [↑](#-content) OSINT","python3","OSINT","Repos","📊 At a glance","Trust \u0026 Safety","ابزارهای امنیتی","👤 People \u0026 Identity","🛠️ Developer Tools","🕵️ OSINT","Personal Information and Email Footprinting","Table of Contents","🕵️ Username \u0026 People Search","cli","50. 🇬🇪 Georgian OSINT Arsenal (500+ resources)"],"sub_categories":["Security Tools","Forensics","Tools","[↑](#-table-of-contents) Telegram","[↑](#-Table-of-Contents) Telegram","爬虫与抓取框架","Personensuche","Threat Intelligence","کار با زمان و تقویم","[↑](#-table-of-contents) GitHub","Usernames \u0026 People Search","AI Security Frameworks \u0026 Knowledge","Programs and Web Applications","🕵️ OSINT","Email \u0026 Username OSINT"],"readme":"# Maigret\n\n\u003cdiv align=\"center\"\u003e\n  \u003cdiv\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://pepy.tech/project/maigret\"\u003e\n      \u003cimg alt=\"Total downloads\" src=\"https://static.pepy.tech/badge/maigret\" /\u003e\n      \u003cimg alt=\"Downloads/month\" src=\"https://static.pepy.tech/badge/maigret/month\" /\u003e\n    \u003c/a\u003e\n  \u003c/div\u003e\n  \u003cdiv\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    \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://maigret.readthedocs.io/\"\u003e\n        \u003cimg alt=\"Maigret documentation\" src=\"https://img.shields.io/readthedocs/maigret?style=flat-square\u0026label=docs\" /\u003e\n    \u003c/a\u003e\n  \u003c/div\u003e\n  \u003cbr\u003e\n  \u003cdiv\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/soxoj/maigret/main/static/maigret.png\" height=\"300\" alt=\"Maigret logo\"/\u003e\n  \u003c/div\u003e\n  \u003cbr\u003e\n  \u003cdiv\u003e\n    \u003ca href=\"https://codewiki.google/github.com/soxoj/maigret\"\u003e\n        \u003cimg alt=\"Ask Code Wiki about Maigret\" src=\"https://img.shields.io/badge/Code_Wiki-ask_about_repo-yellow?logo=googlegemini\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://deepwiki.com/soxoj/maigret\"\u003e\n        \u003cimg alt=\"Ask DeepWiki about Maigret\" src=\"https://img.shields.io/badge/DeepWiki-ask_about_repo-yellow\" /\u003e\n    \u003c/a\u003e\n  \u003c/div\u003e\n  \u003cbr\u003e\n  \u003cdiv\u003e\n    \u003cb\u003eEnglish\u003c/b\u003e · \u003ca href=\"README.zh-CN.md\"\u003e简体中文\u003c/a\u003e · \u003ca href=\"README.fr.md\"\u003eFrançais\u003c/a\u003e\n  \u003c/div\u003e\n  \u003cbr\u003e\n  \u003cdiv\u003e\n    📖 \u003ca href=\"https://maigret.readthedocs.io/\"\u003e\u003cb\u003eDocumentation\u003c/b\u003e\u003c/a\u003e\n  \u003c/div\u003e\n  \u003cbr\u003e\n\u003c/div\u003e\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 required. **[AI profiling (demo)](#ai-analysis)**. \n\n## Sponsors\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://noimosiny.com/?utm_campaign=maigret\u0026utm_source=github\"\u003e\n    \u003cimg width=\"600\" alt=\"Noimosiny\" src=\"https://github.com/user-attachments/assets/cef16613-4337-47a3-9105-2621197b17d1\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://noimosiny.com/?utm_campaign=maigret\u0026utm_source=github\"\u003e\u003cb\u003eNoimosiny\u003c/b\u003e\u003c/a\u003e is a comprehensive OSINT platform for professional investigators and analysts. Reverse email, phone number, and username search across 250+ modules. Automate your intelligence gathering with our powerful tools.\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.rapidproxy.io/?ref=soxoj\"\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/4ed589d1-37cb-4a40-9273-bff4d6f1a514\" width=\"500\" alt=\"RapidProxy\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://www.rapidproxy.io/?ref=soxoj\"\u003e\u003cb\u003eRapidProxy\u003c/b\u003e\u003c/a\u003e provides high-performance residential proxies for Twitter scraping, Selenium automation, and web data extraction. 90M+ IPs • Smart rotation • Anti-block • Non-expiring traffic. \u003cbr\u003e\n\u003cb\u003eSpecial Offer\u003c/b\u003e: Try it free — Plans from $0.65/GB. Use code \u003cb\u003eRAPID10\u003c/b\u003e for 10% off.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.thordata.com/?ls=dmt\u0026lk=dmt\"\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/6d92bda0-c953-49b5-ab7e-73b0e67f17e2\" width=\"350\" alt=\"Thordata\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://www.thordata.com/?ls=dmt\u0026lk=dmt\"\u003e\u003cb\u003eThordata\u003c/b\u003e\u003c/a\u003e\n\u003c/a\u003e provides reliable residential proxies for OSINT research, username lookup, and public data collection workflows.\nAccess \u003cb\u003e100M+ real residential IPs\u003c/b\u003e across \u003cb\u003e195+ countries\u003c/b\u003e  \u003cb\u003eunlimited concurrent connections\u003c/b\u003ewith 99.99% uptime and stable connections, Rotating + Sticky Sessions, and high success rates.\n\u003cbr\u003e\n\u003cb\u003eSpecial Offer:\u003c/b\u003e Free 3-day trial + \u003cb\u003e10% OFF\u003c/b\u003e with code \u003cb\u003eSOXOJ10\u003c/b\u003e.\n\n\u003c/p\u003e\n\n## Contents\n\n- [In one minute](#in-one-minute)\n- [Main features](#main-features)\n- [Demo](#demo)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [Commercial Use](#commercial-use)\n- [About](#about)\n\n\u003ca id=\"one-minute\"\u003e\u003c/a\u003e\n## In one minute\n\nEnsure you have Python 3.10 or higher.\n\n```bash\npip install maigret\nmaigret YOUR_USERNAME\n```\n\nNo install? Try the [community Telegram bot](https://maigret.app/readme-en) or a [Cloud Shell](#cloud-shells). \n\nWant a web UI? See [how to launch it](#web-interface).\n\nSee also: [Quick start](https://maigret.readthedocs.io/en/latest/quick-start.html). \n\n## Main features\n\n- Supports 5,900 sites ([see full list](https://github.com/soxoj/maigret/blob/main/sites.md)). A default run checks the 500 highest-ranked sites by traffic; pass `-a` to scan everything, or `--tags` to narrow by category/country.\n- Embeddable in Python projects — import `maigret` and run searches programmatically (see [library usage](https://maigret.readthedocs.io/en/latest/library-usage.html)).\n- [Extracts](https://github.com/soxoj/socid_extractor) all available information about the account owner from profile pages and site APIs, including links to other accounts.\n- Performs recursive search using discovered usernames and other IDs.\n- Allows filtering by tags (site categories, countries).\n- Detects and partially bypasses blocks, censorship, and CAPTCHA.\n- Fetches an [auto-updated site database](https://maigret.readthedocs.io/en/latest/settings.html#database-auto-update) from GitHub each run (once per 24 hours), and falls back to the built-in database if offline.\n- Works with Tor and I2P websites; able to check domains.\n- Ships with a [web interface](#web-interface) for browsing results as a graph and downloading reports in every format from a single page.\n- Optional [AI analysis mode](#ai-analysis) (`--ai`) that turns raw findings into a short investigation summary using an OpenAI-compatible API.\n\nFor the complete feature list, see the [features documentation](https://maigret.readthedocs.io/en/latest/features.html).\n\n### Used by\n\nProfessional OSINT and social-media analysis tools built on Maigret:\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## Demo\n\n### Video\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## Installation\n\nAlready ran the [In one minute](#one-minute) steps? You're set. Below are alternative methods.\n\nDon't want to install anything? Use the [community Telegram bot](https://maigret.app/readme-en).\n\n### Windows\n\nDownload `maigret_standalone.exe` from [Releases](https://github.com/soxoj/maigret/releases). You can launch it two ways:\n\n- **Double-click it** — Maigret will ask for a username, run a default search, and wait at the end so the report links stay visible.\n- **Run it from a terminal** — open Command Prompt (press `Win+R`, type `cmd`, hit Enter) or PowerShell to pass extra options:\n\n```cmd\ncd %USERPROFILE%\\Downloads\nmaigret_standalone.exe USERNAME\nmaigret_standalone.exe USERNAME --html       :: also save an HTML report\nmaigret_standalone.exe --help                :: list all options\n```\n\nVideo guide: https://youtu.be/qIgwTZOmMmM.\n\n\u003ca id=\"cloud-shells\"\u003e\u003c/a\u003e\n### Cloud Shells\n\nRun Maigret in the browser via cloud shells or Jupyter notebooks:\n\n\u003ca href=\"https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/soxoj/maigret\u0026tutorial=cloudshell-tutorial.md\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/27065646/92304704-8d146d80-ef80-11ea-8c29-0deaabb1c702.png\" alt=\"Open in Cloud Shell\" height=\"50\"\u003e\u003c/a\u003e\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### Snap (Linux)\n\n\u003ca href=\"https://snapcraft.io/maigret\"\u003e\u003cimg src=\"https://snapcraft.io/static/images/badges/en/snap-store-black.svg\" alt=\"Get it from the Snap Store\" height=\"50\"\u003e\u003c/a\u003e\n\n```bash\nsudo snap install maigret\n\n# usage\nmaigret username\n```\n\nAvailable for amd64 and arm64, no Python required. The snap is strictly confined and can write inside your home directory, so run it from there. For USB drives, connect the interface once with `sudo snap connect maigret:removable-media`.\n\n### Local installation (pip)\n\n```bash\n# install from pypi\npip3 install maigret\n\n# usage\nmaigret username\n```\n\n### From source\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\nTwo image variants are published:\n\n- `soxoj/maigret:latest` — CLI mode (default)\n- `soxoj/maigret:web` — auto-launches the [web interface](#web-interface)\n\n```bash\n# official image (CLI)\ndocker pull soxoj/maigret\n\n# CLI usage\ndocker run -v /mydir:/app/reports soxoj/maigret:latest username --html\n\n# Web UI (open http://localhost:5000)\ndocker run -p 5000:5000 soxoj/maigret:web\n\n# Web UI on a custom port\ndocker run -e PORT=8080 -p 8080:8080 soxoj/maigret:web\n\n# manual build\ndocker build -t maigret .                  # CLI image (default target)\ndocker build --target web -t maigret-web . # Web UI image\n```\n\n### Troubleshooting\n\nBuild errors? See the [troubleshooting guide](https://maigret.readthedocs.io/en/latest/installation.html#troubleshooting).\n\nPDF reports (`--pdf`) are an optional extra — install with `pip install 'maigret[pdf]'`. They need system-level graphics libraries on Linux/macOS; see the [PDF reports section](https://maigret.readthedocs.io/en/latest/installation.html#optional-pdf-reports-maigret-pdf) for per-OS install steps.\n\n## Usage\n\n### Examples\n\n```bash\n# make HTML, PDF, and XMind reports\nmaigret user --html\nmaigret user --pdf\nmaigret user --xmind # legacy XML with a manifest for XMind 2022+ readers\n\n# machine-readable exports\nmaigret user --json ndjson   # newline-delimited JSON (also: --json simple)\nmaigret user --csv\nmaigret user --txt\nmaigret user --graph         # interactive D3 graph (HTML)\nmaigret user --neo4j         # Neo4j Cypher script (graph database)\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# highlight sites whose page also mentions specific keywords\nmaigret user --keywords python rust\n# keyword-matched sites are shown with \"[++]\" in bright green\n\n# search for three usernames on all available sites\nmaigret user1 user2 user3 -a\n\n# AI-assisted investigation summary (needs OPENAI_API_KEY)\nmaigret user --ai\n```\n\n`--neo4j` writes a `*_neo4j.cypher` script of the results graph; import it with `cypher-shell -u neo4j -p \u003cpassword\u003e \u003c report_user_neo4j.cypher` or paste it into the Neo4j Browser. Re-imports are idempotent. See the [Neo4j export docs](https://maigret.readthedocs.io/en/latest/command-line-options.html#neo4j-export).\n\nRun `maigret --help` for all options. Docs: [CLI options](https://maigret.readthedocs.io/en/latest/command-line-options.html), [more examples](https://maigret.readthedocs.io/en/latest/usage-examples.html). Running into 403s or timeouts? See [TROUBLESHOOTING.md](TROUBLESHOOTING.md).\n\n\u003ca id=\"web-interface\"\u003e\u003c/a\u003e\n### Web interface\n\nMaigret has a built-in web UI with a results graph and downloadable reports.\n\nDon't want to run it yourself? Deploy the published `soxoj/maigret:web` Docker image as a hosted app in one click:\n\n\u003ca href=\"https://render.com/deploy?repo=https://github.com/soxoj/maigret\u0026path=utils/render.yaml\"\u003e\u003cimg src=\"https://render.com/images/deploy-to-render-button.svg\" alt=\"Deploy to Render\" height=\"40\"\u003e\u003c/a\u003e\n\nRuns on Render's free tier (spins down after 15 min idle, spins back up on the next request). No login is set up on the instance, so anyone with the URL can use it.\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\n```console\nmaigret --web 5000\n```\n\nOpen http://127.0.0.1:5000, enter a username, and view results.\n\n### Python library\n\n**Maigret can be embedded in your own Python projects.** The CLI is a thin wrapper around an async function you can call directly — build custom pipelines, feed results into your own tooling, or run it inside a larger OSINT workflow.\n\nSee the full [library usage guide](https://maigret.readthedocs.io/en/latest/library-usage.html) for a working example, async patterns, and how to filter sites by tag.\n\n### Useful CLI flags\n\n- `--parse URL` — parse a profile page, extract IDs/usernames, and use them to kick off a recursive search.\n- `--permute` — generate likely username variants from two or more inputs (e.g. `john doe` → `johndoe`, `j.doe`, …) and search for all of them.\n- `--self-check [--auto-disable]` — verify `usernameClaimed` / `usernameUnclaimed` pairs against live sites for maintainers auditing the database.\n- `--ai` / `--ai-model` — run the [AI analysis](#ai-analysis) over the search results and stream a short investigation summary to the terminal.\n\n\u003ca id=\"ai-analysis\"\u003e\u003c/a\u003e\n### AI analysis\n\n[![asciicast](https://asciinema.org/a/979404.svg)](https://asciinema.org/a/979404)\n\n`--ai` collects the search results, builds an internal Markdown report, and sends it to an OpenAI-compatible chat completion endpoint to produce a short, neutral investigation summary (likely real name, location, occupation, interests, languages, confidence, follow-up leads). Per-site progress is suppressed and the model's output is streamed to stdout.\n\n```bash\nexport OPENAI_API_KEY=sk-...\nmaigret user --ai\n\n# pick a different model\nmaigret user --ai --ai-model gpt-4o-mini\n```\n\nThe key can also be set as `openai_api_key` in `settings.json`. The endpoint defaults to `https://api.openai.com/v1`, but `openai_api_base_url` in `settings.json` can point to any OpenAI-compatible API (Azure OpenAI, OpenRouter, a local server, …). See the [settings docs](https://maigret.readthedocs.io/en/latest/settings.html) for the full list of options.\n\n### Tor / I2P / proxies\n\nMaigret can route checks through a proxy, Tor, or I2P — useful for `.onion` / `.i2p` sites and for bypassing WAFs that block datacenter IPs.\n\n```bash\n# any HTTP/SOCKS proxy\nmaigret user --proxy socks5://127.0.0.1:1080\n\n# Tor (default gateway socks5://127.0.0.1:9050)\nmaigret user --tor-proxy socks5://127.0.0.1:9050\n\n# I2P (default gateway http://127.0.0.1:4444)\nmaigret user --i2p-proxy http://127.0.0.1:4444\n```\n\nStart your Tor / I2P daemon before running the command — Maigret does not manage these gateways.\n\n### Cloudflare bypass\n\n\u003e **Experimental.** The Cloudflare webgate is under active development; the configuration schema, CLI behaviour, and the set of routed sites may change without backwards-compatibility guarantees.\n\nA subset of sites in the database require a real browser to solve a JavaScript challenge. Maigret can offload these checks to a local [FlareSolverr](https://github.com/FlareSolverr/FlareSolverr) instance:\n\n```bash\ndocker run -d -p 8191:8191 --name flaresolverr ghcr.io/flaresolverr/flaresolverr:latest\nmaigret --cloudflare-bypass \u003cusername\u003e\n```\n\nThe bypass is opt-in (`--cloudflare-bypass` or `cloudflare_bypass.enabled` in `settings.json`) and only fires for sites whose `protection` field matches. See the [feature docs](https://maigret.readthedocs.io/en/latest/features.html#cloudflare-bypass) for backend options and configuration.\n\n## Contributing\n\nAdd or fix new sites surgically in `data.json` (no `json.load`/`json.dump`), then run `./utils/update_site_data.py` to regenerate `sites.md` and the database metadata, and open a pull request. For more details, see the [CONTRIBUTING guide](https://github.com/soxoj/maigret/blob/main/CONTRIBUTING.md) and [development docs](https://maigret.readthedocs.io/en/latest/development.html). Release history: [CHANGELOG.md](CHANGELOG.md).\n\n## Commercial Use\n\nThe open-source Maigret is MIT-licensed and free for commercial use without restriction — but site checks break over time and need active maintenance.\n\nFor serious commercial use — with a **daily-updated site database** or a **username-check API** — reach out: 📧 [maigret@soxoj.com](mailto:maigret@soxoj.com)\n\n- Private site database — 5 000+ sites, updated daily (separate from the public open-source database)\n- Username check API — integrate Maigret into your product\n\n## About\n\n### Disclaimer\n\n**For educational and lawful purposes only.** You are responsible for complying with all applicable laws (GDPR, CCPA, etc.) in your jurisdiction. The authors bear no responsibility for misuse.\n\n### Feedback\n\n[Open an issue](https://github.com/soxoj/maigret/issues) · [GitHub Discussions](https://github.com/soxoj/maigret/discussions) · [Telegram](https://t.me/soxoj)\n\n### SOWEL classification\n\nOSINT techniques used:\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)\n","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"}