soxoj maigret

原文标题：soxoj / maigret

Maigret

English · 简体中文

Maigret 仅通过用户名收集某人的档案，检查大量网站上的账户，并从网页中收集所有可用信息。无需 API 密钥。

一分钟上手

确保你已安装 Python 3.10 或更高版本。

pip install maigret
maigret YOUR_USERNAME

不想安装？试试 Telegram 机器人或 Cloud Shell。想要 Web 界面？查看如何启动它。另见：快速入门。

主要功能

支持 3000+ 个网站（查看完整列表）。
默认运行会检查流量排名前 500 的网站；使用 -a 扫描所有网站，或使用 --tags 按类别/国家筛选。
可嵌入 Python 项目 —— 导入 maigret 并以编程方式运行搜索（参见库使用）。
从个人资料页面和网站 API 中提取账户所有者的所有可用信息，包括其他账户的链接。
使用发现的用户名和其他 ID 执行递归搜索。
允许按标签（网站类别、国家）进行筛选。
检测并部分绕过封锁、审查和 CAPTCHA。
每次运行时（每 24 小时一次）从 GitHub 获取自动更新的网站数据库，离线时回退到内置数据库。
支持 Tor 和 I2P 网站；能够检查域名。
附带 Web 界面，可将结果以图形形式浏览，并从一个页面下载各种格式的报告。

完整功能列表，请参阅功能文档。

演示

视频

报告

PDF 报告
HTML 报告
完整控制台输出

安装

已经完成了“一分钟上手”的步骤？那就已经设置好了。以下是其他安装方法。

不想安装任何东西？使用 Telegram 机器人。

Windows

从 Releases 下载独立的 EXE 文件。视频指南：https://youtu.be/qIgwTZOmMmM。

Cloud Shells

通过 Cloud Shell 或 Jupyter notebooks 在浏览器中运行 Maigret：

本地安装（pip）

# 从 pypi 安装
pip3 install maigret

# 使用
maigret username

从源码安装

# 或者克隆并手动安装
git clone https://github.com/soxoj/maigret && cd maigret

# 构建并安装
pip3 install .

# 使用
maigret username

Docker

发布两种镜像变体：

soxoj/maigret:latest —— CLI 模式（默认）
soxoj/maigret:web —— 自动启动 Web 界面

# 官方镜像（CLI）
docker pull soxoj/maigret

# CLI 使用
docker run -v /mydir:/app/reports soxoj/maigret:latest username --html

# Web UI（打开 http://localhost:5000）
docker run -p 5000:5000 soxoj/maigret:web

# 自定义端口的 Web UI
docker run -e PORT=8080 -p 8080:8080 soxoj/maigret:web

# 手动构建
docker build -t maigret .           # CLI 镜像（默认目标）
docker build --target web -t maigret-web .  # Web UI 镜像

故障排除

构建出错？请参阅故障排除指南。

使用

示例

# 生成 HTML、PDF 和 Xmind8 报告
maigret user --html
maigret user --pdf
maigret user --xmind   # 输出与 xmind 2022+ 不兼容

# 机器可读的导出
maigret user --json ndjson   # 换行符分隔的 JSON（也可用：--json simple）
maigret user --csv
maigret user --txt
maigret user --graph         # 交互式 D3 图（HTML）

# 在标记为 photo 和 dating 的网站上搜索
maigret user --tags photo,dating

# 在标记为 us 的网站上搜索
maigret user --tags us

# 在所有可用网站上搜索三个用户名
maigret user1 user2 user3 -a

运行 maigret --help 查看所有选项。文档：CLI 选项，更多示例。

遇到 403 或超时？请参阅 TROUBLESHOOTING.md。

Web 界面

Maigret 内置了 Web UI，带有结果图和可下载的报告。

Web 界面截图

maigret --web 5000

打开 http://127.0.0.1:5000，输入用户名，查看结果。

Python 库

Maigret 可以嵌入到你自己的 Python 项目中。CLI 是一个薄封装层，底层是一个你可以直接调用的异步函数 —— 构建自定义管道、将结果输入到你自己的工具中，或在更大的 OSINT 工作流中运行它。

请参阅完整的库使用指南，了解工作示例、异步模式以及如何按标签筛选网站。

有用的 CLI 标志

--parse URL —— 解析个人资料页面，提取 ID/用户名，并用它们启动递归搜索。
--permute —— 从两个或多个输入生成可能的用户名变体（例如 john doe → johndoe、j.doe 等），并搜索所有这些变体。
--self-check [--auto-disable] —— 针对活跃网站验证 usernameClaimed / usernameUnclaimed 对，供维护者审计数据库。

Tor / I2P / 代理

Maigret 可以通过代理、Tor 或 I2P 路由检查 —— 这对于 .onion / .i2p 网站以及绕过阻止数据中心 IP 的 WAF 非常有用。

# 任何 HTTP/SOCKS 代理
maigret user --proxy socks5://127.0.0.1:1080

# Tor（默认网关 socks5://127.0.0.1:9050）
maigret user --tor-proxy socks5://127.0.0.1:9050

# I2P（默认网关 http://127.0.0.1:4444）
maigret user --i2p-proxy http://127.0.0.1:4444

在运行命令之前启动你的 Tor / I2P 守护进程 —— Maigret 不管理这些网关。

贡献

在 data.json 中添加或修复新网站（不要使用 json.load / json.dump），然后运行 ./utils/update_site_data.py 重新生成 sites.md 和数据库元数据，并提交 Pull Request。

更多详情，请参阅 CONTRIBUTING 指南和开发文档。发布历史：CHANGELOG.md。

商业用途

开源的 Maigret 采用 MIT 许可证，可免费用于商业用途，无限制 —— 但网站检查会随时间失效，需要主动维护。

对于严肃的商业用途 —— 需要每日更新的网站数据库或用户名检查 API —— 请联系： 📧 maigret@soxoj.com

私有网站数据库 —— 5000+ 个网站，每日更新（与公共开源数据库分开）
用户名检查 API —— 将 Maigret 集成到你的产品中

关于

免责声明

仅用于教育和合法目的。你有责任遵守你所在司法管辖区的所有适用法律（GDPR、CCPA 等）。作者对滥用行为不承担任何责任。

反馈

提交 Issue
GitHub Discussions
Telegram
SOWEL 分类