README

Maigret


  
    
        
    
    
      
      
    
  
  
    
        
    
    
        
    
    
        
    
    
        
    
  
  
  
    
  
  
  
    
        
    
    
        
    
  
  
  
    English · 简体中文 · Français
  
  
  
    📖 文档
  
  


Maigret 仅凭一个用户名,就能在大量站点上查找其账号,并从网页中收集所有可获取的公开信息,为目标人物生成一份档案。无需任何 API 密钥。AI 画像(演示)。

 赞助商






不止于账号枚举。WebVetted 可将一个电子邮件地址或用户名转化为完整的身份调查，提供深度 OSINT 信息补全、数据泄露情报、AI 分析和交互式身份关系图。
开始调查 →





  
    
  



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



  
    
  



  ThorData 提供住宅代理和网页数据 API，适用于 OSINT 研究、用户名检索和搜索侦察。
  覆盖 190+ 个国家 的 1 亿+ 住宅 IP，减少请求失败、403 错误和地区限制。可使用 SERP API 获取结构化搜索结果，或使用 Web Scraper API 采集公开网页数据。
  特别优惠：免费 3 天试用，使用优惠码 SOXOJ10 享 9 折优惠。


 目录

- 一分钟上手
- 核心特性
- 演示
- 安装
- 使用
- 参与贡献
- 商业使用
- 关于


 一分钟上手

请先确认本机的 Python 版本不低于 3.10。

bash
pip install maigret
maigret YOUR_USERNAME


不想本地安装?可以试试社区 Telegram 机器人,或者使用云端 Shell。

想要一个 Web 界面?参见启动方式。

延伸阅读:快速入门。


 核心特性

- 支持 5900 站点(完整列表见 sites.md)。默认仅检查访问量排名前 500 的站点;加上 -a 可全量扫描,或使用 --tags 按分类/国家筛选。
- 可作为 Python 库嵌入到自己的项目中——直接 import maigret 即可在代码里发起搜索(参见库使用文档)。
- 通过 socid_extractor 从个人主页和站点 API 中提取账号所有者的所有可获取信息,包括指向其他账号的链接。
- 基于已发现的用户名和其他 ID,执行递归搜索。
- 支持按标签(站点分类、国家)进行筛选。
- 能够检测并部分绕过封锁、审查和 CAPTCHA。
- 每次运行时(每 24 小时一次)从 GitHub 拉取一份自动更新的站点数据库;离线时会回退到内置数据库。
- 可访问 Tor 与 I2P 站点;支持检查域名。
- 自带一个 Web 界面,可在同一页面将结果以图谱方式浏览,并下载各种格式的报告。
- 可选的 AI 分析模式(--ai),通过 OpenAI 兼容 API 将原始搜索结果整理成一份简短的调查摘要。

完整特性列表请见特性文档。

 谁在使用

基于 Maigret 构建的专业 OSINT 与社交媒体分析工具:






 演示

 视频


  


 报告示例

PDF 报告、HTML 报告

!HTML 报告截图

!XMind 8 报告截图

完整的命令行输出示例


 安装

如果你已经按一分钟上手的步骤跑通了,就无需再装。下面列出几种可选的安装方式。

什么都不想装?直接用社区 Telegram 机器人。

 Windows

从 Releases 下载 maigret_standalone.exe。有两种启动方式:

- 双击运行 —— Maigret 会询问用户名、执行一次默认搜索,并在结束时停留,方便你查看报告链接。
- 从终端运行 —— 打开命令提示符(按 Win+R,输入 cmd,回车)或 PowerShell,以便传入额外参数:

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


视频指引:https://youtu.be/qIgwTZOmMmM。


 云端 Shell

通过云端 Shell 或 Jupyter Notebook 在浏览器里运行 Maigret:







 Snap(Linux)



bash
sudo snap install maigret

 使用
maigret username


支持 amd64 与 arm64,无需安装 Python。该 snap 采用严格受限模式,只能写入你的主目录,因此请从主目录下运行;若要访问 USB 设备,需先执行一次 sudo snap connect maigret:removable-media 连接对应接口。

 本地安装(pip)

bash
 从 PyPI 安装
pip3 install maigret

 使用
maigret username


 从源码安装

bash
 也可以克隆仓库后手动安装
git clone https://github.com/soxoj/maigret && cd maigret

 构建并安装
pip3 install .

 使用
maigret username


 Docker

官方提供两个镜像变体:

- soxoj/maigret:latest —— CLI 模式(默认)
- soxoj/maigret:web —— 自动启动 Web 界面

bash
 拉取官方镜像(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 .            

Top issues

Discussions

Latest release

What's Changed
 Bump to 0.6.5 by @soxoj in https://github.com/soxoj/maigret/pull/3014
 Add a website link to the snap metadata by @soxoj in https://github.com/soxoj/maigret/pull/3017
 Drop the zero-width joiner from the snap summary by @soxoj in https://github.com/soxoj/maigret/pull/3022
 [LAPOINTE] Add 3 sites by @soxoj in https://github.com/soxoj/maigret/pull/3023
 [LAPOINTE] Disable fuzzies.wtf by @soxoj in https://github.com/soxoj/maigret/pull/3025
 Detect status-code checks in --submit fallback by @juliosuas in https://github.com/soxoj/maigret/pull/3024
 [LAPOINTE] Add 13 sites by @soxoj