soxoj / maigret

查看原文 / View Original

soxoj / maigret

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 仅凭用户名即可收集某人的档案，通过检查海量网站上的账户并从网页中抓取所有可用信息。无需 API 密钥。

Contents

目录

In one minute, Main features, Demo, Installation, Usage, Contributing, Commercial Use, About. 一分钟上手、主要功能、演示、安装、使用方法、贡献指南、商业用途、关于。

In one minute

一分钟上手

Ensure you have Python 3.10 or higher. 确保你已安装 Python 3.10 或更高版本。

pip install maigret maigret YOUR_USERNAME

No install? Try the Telegram bot or a Cloud Shell. Want a web UI? See how to launch it. See also: Quick start. 不想安装？试试 Telegram 机器人或云端 Shell。想要 Web 界面？查看如何启动它。另请参阅：快速入门。

Main features

主要功能

  • Supports 3,000+ sites (see full list). A default run checks the 500 highest-ranked sites by traffic; pass -a to scan everything, or --tags to narrow by category/country. 支持 3,000 多个网站（查看完整列表）。默认运行会检查流量排名前 500 的网站；添加 -a 参数可扫描所有网站，或使用 --tags 按类别/国家进行筛选。
  • Embeddable in Python projects — import maigret and run searches programmatically (see library usage). 可嵌入 Python 项目 — 导入 maigret 并以编程方式运行搜索（查看库使用说明）。
  • Extracts all available information about the account owner from profile pages and site APIs, including links to other accounts. 从个人资料页面和网站 API 中提取关于账户所有者的所有可用信息，包括指向其他账户的链接。
  • Performs recursive search using discovered usernames and other IDs. 使用发现的用户名和其他 ID 执行递归搜索。
  • Allows filtering by tags (site categories, countries). 允许按标签（网站类别、国家）进行过滤。
  • Detects and partially bypasses blocks, censorship, and CAPTCHA. 检测并部分绕过封锁、审查和验证码。
  • Fetches an auto-updated site database from GitHub each run (once per 24 hours), and falls back to the built-in database if offline. 每次运行（每 24 小时一次）从 GitHub 获取自动更新的网站数据库，离线时则回退到内置数据库。
  • Works with Tor and I2P websites; able to check domains. 支持 Tor 和 I2P 网站；能够检查域名。
  • Ships with a web interface for browsing results as a graph and downloading reports in every format from a single page. 附带 Web 界面，用于以图形方式浏览结果，并可从单个页面下载各种格式的报告。

For the complete feature list, see the features documentation. Used by Professional OSINT and social-media analysis tools built on Maigret. 完整功能列表请参阅功能文档。Maigret 被用于构建专业的开源情报（OSINT）和社交媒体分析工具。

Demo

演示

Video, Reports (PDF report, HTML report), Full console output. 视频、报告（PDF 报告、HTML 报告）、完整控制台输出。

Installation

安装

Already ran the In one minute steps? You’re set. Below are alternative methods. Don’t want to install anything? Use the Telegram bot. 已经完成了“一分钟上手”的步骤？那就没问题了。以下是其他安装方法。不想安装任何东西？请使用 Telegram 机器人。

Windows: Download a standalone EXE from Releases. Video guide: https://youtu.be/qIgwTZOmMmM. Windows: 从 Releases 下载独立 EXE 文件。视频指南：https://youtu.be/qIgwTZOmMmM。

Cloud Shells: Run Maigret in the browser via cloud shells or Jupyter notebooks. 云端 Shell: 通过云端 Shell 或 Jupyter Notebook 在浏览器中运行 Maigret。

Local installation (pip): 本地安装 (pip):

# install from pypi
pip3 install maigret
# usage
maigret username

From source: 从源码安装:

# or clone and install manually
git clone https://github.com/soxoj/maigret && cd maigret
# build and install
pip3 install .
# usage
maigret username

Docker: Two image variants are published: soxoj/maigret:latest (CLI mode) and soxoj/maigret:web (auto-launches the web interface). 发布了两个镜像版本：soxoj/maigret:latest（CLI 模式）和 soxoj/maigret:web（自动启动 Web 界面）。

Usage

使用方法

Examples: 示例:

# make HTML, PDF, and Xmind8 reports
maigret user --html
maigret user --pdf
maigret user --xmind

# machine-readable exports
maigret user --json ndjson
maigret user --csv
maigret user --txt
maigret user --graph # interactive D3 graph (HTML)

# 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

Run maigret --help for all options. Docs: CLI options, more examples. Running into 403s or timeouts? See TROUBLESHOOTING.md. 运行 maigret --help 查看所有选项。文档：CLI 选项、更多示例。遇到 403 或超时错误？请参阅 TROUBLESHOOTING.md。

Web interface

Web 界面

Maigret has a built-in web UI with a results graph and downloadable reports. Maigret 内置了 Web UI，提供结果图形展示和可下载的报告。

maigret --web 5000 Open http://127.0.0.1:5000, enter a username, and view results. 打开 http://127.0.0.1:5000，输入用户名即可查看结果。

Python library

Python 库

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. Maigret 可以嵌入到你自己的 Python 项目中。CLI 只是一个异步函数的轻量级封装，你可以直接调用它——构建自定义流水线、将结果输入到你自己的工具中，或在更大的 OSINT 工作流中运行它。

Commercial Use

商业用途

The open-source Maigret is MIT-licensed and free for commercial use without restriction — but site checks break over time and need active maintenance. For serious commercial use — with a daily-updated site database or a username-check API — reach out: 📧 maigret@soxoj.com 开源的 Maigret 采用 MIT 许可证，可无限制地免费用于商业用途——但网站检查规则会随时间失效，需要持续维护。如需进行严肃的商业使用（包含每日更新的网站数据库或用户名检查 API），请联系：📧 maigret@soxoj.com

About

关于

Disclaimer: 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. 免责声明: 仅用于教育和合法目的。你有责任遵守你所在司法管辖区的所有适用法律（GDPR、CCPA 等）。作者对滥用行为不承担任何责任。

← 返回新闻列表 / Back to news list