好的,这是您要求的英文文章的中文翻译,已按照规范保留格式、技术术语和代码块。
soxoj / maigret
Maigret 仅通过用户名收集一个人的档案,检查大量网站上的账户,并从网页中收集所有可用信息。无需 API 密钥。AI 分析(演示)。
赞助商
- RapidProxy 为 Twitter 抓取、Selenium 自动化和网络数据提取提供高性能住宅代理。9000万+ IP • 智能轮换 • 反屏蔽 • 流量永不过期
特别优惠:免费试用 — 套餐低至 $0.65/GB。使用代码 RAPID10 享 10% 折扣。
- VaultProxies — 当运维团队受够了被限速、标记或猜测时,他们会选择的代理网络。企业级轮换 • 高可用性 • 抗限速路由
特别优惠:套餐低至 $1/GB — 最低可达 $0.50/GB。使用代码 50OFF 享 50% 折扣。
- 9Proxy 提供住宅代理,价格低至 $0.018/IP 或 $0.68/GB。覆盖 90 多个国家/地区的 2000万+ IP。支持粘性会话或轮换会话,可通过桌面或移动应用管理。
目录
- 一分钟上手
- 主要功能
- 演示
- 安装
- 使用方法
- 贡献
- 商业用途
- 关于
一分钟上手
确保你已安装 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 将原始发现转化为简短的调查摘要。
有关完整功能列表,请参阅功能文档。
被专业 OSINT 和社交媒体分析工具使用
基于 Maigret 构建的工具:
演示
视频
报告
- PDF 报告,HTML 报告
- 完整控制台输出
安装
已经完成“一分钟上手”的步骤?那就准备好了。以下是其他安装方法。
不想安装任何东西?使用社区 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:
本地安装 (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)
maigret user --neo4j # Neo4j Cypher 脚本(图数据库)
# 在标记为 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/用户名,并使用它们来启动递归搜索。