soxoj maigret

好的，这是您要求的英文文章的中文翻译，已按照要求保留原文结构、代码块、技术术语，并输出为 Markdown 格式。

soxoj / maigret

Maigret 仅通过用户名收集一个人的档案，检查大量网站上的账户，并从网页中收集所有可用信息。无需 API 密钥。AI 分析（演示）。

赞助商

RapidProxy 为 Twitter 抓取、Selenium 自动化和网页数据提取提供高性能住宅代理。9000万+ IP • 智能轮换 • 反屏蔽 • 流量永不过期 特别优惠： 免费试用 — 套餐低至 $0.65/GB。使用代码 RAPID10 享受 10% 折扣。

VaultProxies — 当运维团队受够了被限速、标记或猜测时，他们会选择的代理网络。企业级轮换 • 高可用性 • 抗限速路由 特别优惠： 套餐低至 $1/GB — 最低可达 $0.50/GB。使用代码 50OFF 享受 50% 折扣。

一分钟上手

确保你已安装 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 界面，用于以图形方式浏览结果，并从单个页面下载各种格式的报告。
可选的 AI 分析模式（--ai），使用兼容 OpenAI 的 API 将原始发现结果转化为简短的调查摘要。

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

被使用

由基于 Maigret 构建的专业 OSINT 和社交媒体分析工具使用：

[Demo Video](https://www.youtube.com/watch?v=4Tj0qP5L1eA)
[Reports](https://github.com/soxoj/maigret/releases)

演示

[PDF 报告](https://github.com/soxoj/maigret/releases/download/v1.0.0/report.pdf)
[HTML 报告](https://github.com/soxoj/maigret/releases/download/v1.0.0/report.html)
[完整控制台输出](https://github.com/soxoj/maigret/releases/download/v1.0.0/output.txt)

安装

已经运行了“一分钟上手”的步骤？那你就准备好了。以下是其他安装方法。

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

Windows

从 Releases 下载 maigret_standalone.exe。你可以通过两种方式启动它：

双击它 — Maigret 会询问用户名，运行默认搜索，并在最后等待，以便报告链接保持可见。
从终端运行它 — 打开命令提示符（按 Win+R，输入 cmd，按回车）或 PowerShell 以传递额外选项：

cd %USERPROFILE%\Downloads
maigret_standalone.exe USERNAME
maigret_standalone.exe USERNAME --html :: 同时保存 HTML 报告
maigret_standalone.exe --help :: 列出所有选项

视频指南：https://youtu.be/qIgwTZOmMmM。

Cloud Shells

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

[Google Cloud Shell](https://shell.cloud.google.com/?show=ide&terminal=1)
[GitHub Codespaces](https://github.com/features/codespaces)
[Binder](https://mybinder.org/v2/gh/soxoj/maigret/HEAD)

本地安装 (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 镜像

故障排除

构建错误？请参阅故障排除指南。
PDF 报告（--pdf）是一个可选附加功能 — 使用 pip install 'maigret[pdf]' 安装。它们在 Linux/macOS 上需要系统级图形库；有关每个操作系统的安装步骤，请参阅 PDF 报告部分。

使用

示例

# 生成 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 user --keywords python rust # 关键字匹配的网站会以亮绿色显示 "[++]"

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

# AI 辅助调查摘要 (需要 OPENAI_API_KEY)
maigret user --ai

运行 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 状态。