[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-91":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":45,"readmeContent":46,"aiSummary":47,"trendingCount":16,"starSnapshotCount":16,"syncStatus":48,"lastSyncTime":49,"discoverSource":50},91,"maigret","soxoj\u002Fmaigret","soxoj","🕵️‍♂️ Collect a dossier on a person by username from 3000+ sites",null,"https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret","Python",32478,2383,146,37,0,623,1215,4622,2370,45,false,"main",[25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"osint","social-network","identification","socmint","sherlock","investigation","namechecker","python","python3","open-source","cybersecurity","scraping","osint-python","redteam","blueteam","osint-framework","cli","reconnaissance","infosec","pentesting","2026-06-12 02:00:07","# Maigret\n\n\u003Cdiv align=\"center\">\n  \u003Cdiv>\n    \u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Fmaigret\u002F\">\n        \u003Cimg alt=\"PyPI version badge for Maigret\" src=\"https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fmaigret?style=flat-square\" \u002F>\n    \u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Fmaigret\u002F\">  \n        \u003Cimg alt=\"PyPI download count for Maigret\" src=\"https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fdw\u002Fmaigret?style=flat-square\" \u002F>\n    \u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret\">\n        \u003Cimg alt=\"Minimum Python version required: 3.10+\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.10%2B-brightgreen?style=flat-square\" \u002F>\n    \u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret\u002Fblob\u002Fmain\u002FLICENSE\">\n        \u003Cimg alt=\"License badge for Maigret\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fsoxoj\u002Fmaigret?style=flat-square\" \u002F>\n    \u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret\">\n        \u003Cimg alt=\"View count for Maigret project\" src=\"https:\u002F\u002Fkomarev.com\u002Fghpvc\u002F?username=maigret&color=brightgreen&label=views&style=flat-square\" \u002F>\n    \u003C\u002Fa>\n  \u003C\u002Fdiv>\n  \u003Cbr>\n  \u003Cdiv>\n    \u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fsoxoj\u002Fmaigret\u002Fmain\u002Fstatic\u002Fmaigret.png\" height=\"300\" alt=\"Maigret logo\"\u002F>\n  \u003C\u002Fdiv>\n  \u003Cbr>\n  \u003Cdiv>\n    \u003Cb>English\u003C\u002Fb> · \u003Ca href=\"README.zh-CN.md\">简体中文\u003C\u002Fa>\n  \u003C\u002Fdiv>\n  \u003Cbr>\n\u003C\u002Fdiv>\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.\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\">\u003C\u002Fa>\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 [Telegram bot](https:\u002F\u002Ft.me\u002Fmaigret_search_bot) or a [Cloud Shell](#cloud-shells). \n\nWant a web UI? See [how to launch it](#web-interface).\n\nSee also: [Quick start](https:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Fquick-start.html). \n\n## Main features\n\n- Supports 3,000+ sites ([see full list](https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret\u002Fblob\u002Fmain\u002Fsites.md)). A default run checks the 500 highest-ranked sites by traffic; pass `-a` to scan everything, or `--tags` to narrow by category\u002Fcountry.\n- Embeddable in Python projects — import `maigret` and run searches programmatically (see [library usage](https:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Flibrary-usage.html)).\n- [Extracts](https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fsocid_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:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Fsettings.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:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Ffeatures.html).\n\n### Used by\n\nProfessional OSINT and social-media analysis tools built on Maigret:\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSocialLinks-IO\u002Fsociallinks-api\">\u003Cimg height=\"60\" alt=\"Social Links API\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F789747b2-d7a0-4d4e-8868-ffc4427df660\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fsociallinks.io\u002Fproducts\u002Fsl-crimewall\">\u003Cimg height=\"60\" alt=\"Social Links Crimewall\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F0b18f06c-2f38-477b-b946-1be1a632a9d1\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fusersearch.ai\u002F\">\u003Cimg height=\"60\" alt=\"UserSearch\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F66daa213-cf7d-40cf-9267-42f97cf77580\">\u003C\u002Fa>\n\n## Demo\n\n### Video\n\n\u003Ca href=\"https:\u002F\u002Fasciinema.org\u002Fa\u002FAo0y7N0TTxpS0pisoprQJdylZ\">\n  \u003Cimg src=\"https:\u002F\u002Fasciinema.org\u002Fa\u002FAo0y7N0TTxpS0pisoprQJdylZ.svg\" alt=\"asciicast\" width=\"600\">\n\u003C\u002Fa>\n\n### Reports\n\n[PDF report](https:\u002F\u002Fraw.githubusercontent.com\u002Fsoxoj\u002Fmaigret\u002Fmain\u002Fstatic\u002Freport_alexaimephotographycars.pdf), [HTML report](https:\u002F\u002Fhtmlpreview.github.io\u002F?https:\u002F\u002Fraw.githubusercontent.com\u002Fsoxoj\u002Fmaigret\u002Fmain\u002Fstatic\u002Freport_alexaimephotographycars.html)\n\n![HTML report screenshot](https:\u002F\u002Fraw.githubusercontent.com\u002Fsoxoj\u002Fmaigret\u002Fmain\u002Fstatic\u002Freport_alexaimephotography_html_screenshot.png)\n\n![XMind 8 report screenshot](https:\u002F\u002Fraw.githubusercontent.com\u002Fsoxoj\u002Fmaigret\u002Fmain\u002Fstatic\u002Freport_alexaimephotography_xmind_screenshot.png)\n\n[Full console output](https:\u002F\u002Fraw.githubusercontent.com\u002Fsoxoj\u002Fmaigret\u002Fmain\u002Fstatic\u002Frecursive_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 [Telegram bot](https:\u002F\u002Ft.me\u002Fmaigret_search_bot).\n\n### Windows\n\nDownload a standalone EXE from [Releases](https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret\u002Freleases). Video guide: https:\u002F\u002Fyoutu.be\u002FqIgwTZOmMmM.\n\n\u003Ca id=\"cloud-shells\">\u003C\u002Fa>\n### Cloud Shells\n\nRun Maigret in the browser via cloud shells or Jupyter notebooks:\n\n\u003Ca href=\"https:\u002F\u002Fconsole.cloud.google.com\u002Fcloudshell\u002Fopen?git_repo=https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret&tutorial=cloudshell-tutorial.md\">\u003Cimg src=\"https:\u002F\u002Fuser-images.githubusercontent.com\u002F27065646\u002F92304704-8d146d80-ef80-11ea-8c29-0deaabb1c702.png\" alt=\"Open in Cloud Shell\" height=\"50\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Frepl.it\u002Fgithub\u002Fsoxoj\u002Fmaigret\">\u003Cimg src=\"https:\u002F\u002Freplit.com\u002Fbadge\u002Fgithub\u002Fsoxoj\u002Fmaigret\" alt=\"Run on Replit\" height=\"50\">\u003C\u002Fa>\n\n\u003Ca href=\"https:\u002F\u002Fcolab.research.google.com\u002Fgist\u002Fsoxoj\u002F879b51bc3b2f8b695abb054090645000\u002Fmaigret-collab.ipynb\">\u003Cimg src=\"https:\u002F\u002Fcolab.research.google.com\u002Fassets\u002Fcolab-badge.svg\" alt=\"Open In Colab\" height=\"45\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fmybinder.org\u002Fv2\u002Fgist\u002Fsoxoj\u002F9d65c2f4d3bec5dd25949197ea73cf3a\u002FHEAD\">\u003Cimg src=\"https:\u002F\u002Fmybinder.org\u002Fbadge_logo.svg\" alt=\"Open In Binder\" height=\"45\">\u003C\u002Fa>\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:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret && 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\u002Fmaigret:latest` — CLI mode (default)\n- `soxoj\u002Fmaigret:web` — auto-launches the [web interface](#web-interface)\n\n```bash\n# official image (CLI)\ndocker pull soxoj\u002Fmaigret\n\n# CLI usage\ndocker run -v \u002Fmydir:\u002Fapp\u002Freports soxoj\u002Fmaigret:latest username --html\n\n# Web UI (open http:\u002F\u002Flocalhost:5000)\ndocker run -p 5000:5000 soxoj\u002Fmaigret:web\n\n# Web UI on a custom port\ndocker run -e PORT=8080 -p 8080:8080 soxoj\u002Fmaigret: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:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Finstallation.html#troubleshooting).\n\n## Usage\n\n### 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# 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)\n\n# search on sites marked with tags photo & 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# AI-assisted investigation summary (needs OPENAI_API_KEY)\nmaigret user --ai\n```\n\nRun `maigret --help` for all options. Docs: [CLI options](https:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Fcommand-line-options.html), [more examples](https:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Fusage-examples.html). Running into 403s or timeouts? See [TROUBLESHOOTING.md](TROUBLESHOOTING.md).\n\n\u003Ca id=\"web-interface\">\u003C\u002Fa>\n### Web interface\n\nMaigret has a built-in web UI with a results graph and downloadable reports.\n\n\u003Cdetails>\n\u003Csummary>Web Interface Screenshots\u003C\u002Fsummary>\n\n![Web interface: how to start](https:\u002F\u002Fraw.githubusercontent.com\u002Fsoxoj\u002Fmaigret\u002Fmain\u002Fstatic\u002Fweb_interface_screenshot_start.png)\n\n![Web interface: results](https:\u002F\u002Fraw.githubusercontent.com\u002Fsoxoj\u002Fmaigret\u002Fmain\u002Fstatic\u002Fweb_interface_screenshot.png)\n\n\u003C\u002Fdetails>\n\n```console\nmaigret --web 5000\n```\n\nOpen http:\u002F\u002F127.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:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Flibrary-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\u002Fusernames, 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` \u002F `usernameUnclaimed` pairs against live sites for maintainers auditing the database.\n- `--ai` \u002F `--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\">\u003C\u002Fa>\n### AI analysis\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:\u002F\u002Fapi.openai.com\u002Fv1`, 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:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Fsettings.html) for the full list of options.\n\n### Tor \u002F I2P \u002F proxies\n\nMaigret can route checks through a proxy, Tor, or I2P — useful for `.onion` \u002F `.i2p` sites and for bypassing WAFs that block datacenter IPs.\n\n```bash\n# any HTTP\u002FSOCKS proxy\nmaigret user --proxy socks5:\u002F\u002F127.0.0.1:1080\n\n# Tor (default gateway socks5:\u002F\u002F127.0.0.1:9050)\nmaigret user --tor-proxy socks5:\u002F\u002F127.0.0.1:9050\n\n# I2P (default gateway http:\u002F\u002F127.0.0.1:4444)\nmaigret user --i2p-proxy http:\u002F\u002F127.0.0.1:4444\n```\n\nStart your Tor \u002F I2P daemon before running the command — Maigret does not manage these gateways.\n\n## Contributing\n\nAdd or fix new sites surgically in `data.json` (no `json.load`\u002F`json.dump`), then run `.\u002Futils\u002Fupdate_site_data.py` to regenerate `sites.md` and the database metadata, and open a pull request. For more details, see the [CONTRIBUTING guide](https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret\u002Fblob\u002Fmain\u002FCONTRIBUTING.md) and [development docs](https:\u002F\u002Fmaigret.readthedocs.io\u002Fen\u002Flatest\u002Fdevelopment.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:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret\u002Fissues) · [GitHub Discussions](https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret\u002Fdiscussions) · [Telegram](https:\u002F\u002Ft.me\u002Fsoxoj)\n\n### SOWEL classification\n\nOSINT techniques used:\n- [SOTL-2.2. Search For Accounts On Other Platforms](https:\u002F\u002Fsowel.soxoj.com\u002Fother-platform-accounts)\n- [SOTL-6.1. Check Logins Reuse To Find Another Account](https:\u002F\u002Fsowel.soxoj.com\u002Flogins-reuse)\n- [SOTL-6.2. Check Nicknames Reuse To Find Another Account](https:\u002F\u002Fsowel.soxoj.com\u002Fnicknames-reuse) \n\n### License\n\nMIT © [Maigret](https:\u002F\u002Fgithub.com\u002Fsoxoj\u002Fmaigret)\n","Maigret 是一个通过用户名从3000多个网站收集个人资料的工具。它支持从网页和个人资料页面提取所有可用信息，包括链接到其他账户的信息，并能够递归地使用发现的用户名和其他标识符进行搜索。该工具不需要API密钥即可运行，支持按类别或国家筛选站点，并能检测和部分绕过封锁、审查和验证码。适用于网络安全调查、渗透测试以及开源情报（OSINT）搜集等场景。",2,"2026-06-11 02:30:50","trending"]