MINT — 统一的 OSINT 与媒体指挥中心

MINT 是一个交互式的、基于终端的指挥中心，它将业界标准的 OSINT（开源情报）工具和强大的媒体归档器整合到了一个单一、连贯的界面中。MINT 专为研究人员、安全分析师和开发者打造，在一个简洁、由键盘驱动的环境中，简化了目标情报收集、社交媒体调查和媒体保存工作。

## 📖 目录 - [✨ 核心功能](#-key-features) - [🛠️ 集成工具详解](#️-integrated-tools-deep-dive) - [📦 安装与包管理器](#-installation--package-managers) - [⚡ 快速一键引导程序](#-quick-one-line-bootstrapper) - [🗂️ 包管理器](#️-package-managers) - [💻 手动安装](#-manual-installation) - [💾 智能路径解析安装器](#-smart-path-resolution-installer) - [🍪 媒体下载器的 Cookie 配置](#-cookie-configuration-for-media-downloader) - [🚀 运行方式与快捷键](#-how-to-run--hotkeys) - [⚙️ 配置文件 (`config.json`)](#️-configuration-file-configjson) - [🔧 故障排除与控制台设置](#-troubleshooting--console-setup) ## ✨ 核心功能 * **统一工作区：** 无需再管理多个终端窗口或仓库路径。在单一的 TUI 中运行审计、扫描和下载任务。 * **智能路径解析：** 自动构建您的目标目录结构，保持系统根目录和驱动器整洁有序。 * **自动依赖管理：** 检查系统前置条件，构建虚拟环境路径，并自动处理安装。 * **集成更新管理器：** 一键从所有子工具的官方 GitHub 仓库进行更新。 * **跨平台：** 在 Windows、macOS、Linux 和 Android（通过 Termux）上无缝运行。 ## 🛠️ 集成工具详解 MINT 聚合并配置了以下业界标准的引擎： | 工具 / 引擎 | 用途 | 功能 | 源码 | | :--- | :--- | :--- | :--- | | **Sherlock** | 用户名情报 | 同时扫描 300+ 个社交平台以定位账户。 | [sherlock-project/sherlock](https://github.com/sherlock-project/sherlock) | | **Holehe** | 邮箱侦察 | 通过密码恢复端点检查 120+ 个网站上的注册状态，且不会提醒目标。 | [megadose/holehe](https://github.com/megadose/holehe) | | **SpiderFoot** | OSINT 自动化 | 启动本地 Web 服务器，用于高级审计、域名侦察和威胁情报。 | [smicallef/spiderfoot](https://github.com/smicallef/spiderfoot) | | **Toutatis** | Instagram 元数据 | 提取关联的公开邮箱、电话号码和个人资料详情。 | [megadose/toutatis](https://github.com/megadose/toutatis) | | **MINT 社交工具** | 媒体归档 | 用于 Instagram、TikTok、Facebook 和 X (Twitter) 的高速、交互式备份引擎。由 `gallery-dl` 和 `yt-dlp` 提供支持。 | *内置* | ## 📦 安装与包管理器 ### ⚡ 快速一键引导程序 对于 **macOS**、**Linux** 和 **Android (Termux)**，您可以使用单条命令瞬间安装并配置 MINT： ``` curl -fsSL https://raw.githubusercontent.com/sayfalse/mint/main/setup.sh | bash ``` ### 🗂️ 包管理器 使用您喜欢的包管理器在系统上全局安装 MINT： ``` # Python Pip (跨平台) pip install mint-osint # Scoop (Windows) scoop bucket add sayfalse https://github.com/sayfalse/scoop-bucket.git scoop install mint # Homebrew (macOS & Linux) brew tap sayfalse/tap brew install mint # Nix (跨平台 / 可重现) nix run github:sayfalse/mint ``` ### 💻 手动安装 #### Windows 1. 克隆仓库并进入该目录： git clone https://github.com/sayfalse/mint.git cd mint 2. 运行交互式批处理安装程序： setup.bat #### macOS / Linux / Android (Termux) 1. 克隆仓库并进入该目录： git clone https://github.com/sayfalse/mint.git cd mint 2. 运行安装脚本： python installer.py ## 💾 智能路径解析安装器 为了保护您的目录，安装器会提示您一次以指定父目录（例如 `E:\mint` 或 `~/mint`），并自动构建一个干净、隔离的结构： * **`MINT_Tools/`** — 克隆并维护所有官方的外部 OSINT 仓库。 * **`mint-social/`** — 存放所有已下载的媒体、配置文件列表和配置模板。 * **`mint-social/cookies/`** — 预先生成 Cookie 绕过文件的模板。 * **全局命令包装器** — 自动将 `mint` 注册到您的系统路径中，允许全局执行。 ## 🍪 媒体下载器的 Cookie 配置 要从私密配置文件下载内容或绕过速率限制，媒体下载器会使用会话 Cookie。安装器会自动在以下位置生成 4 个空的模板 Cookie 文件： `/mint-social/cookies/` ### 如何使用： 1. 安装一个浏览器扩展，例如 **Get cookies.txt LOCALLY** (Chrome/Firefox)。 2. 在浏览器中登录目标社交网络（例如 Instagram）。 3. 使用该扩展以 **Netscape 格式**导出 Cookie。 4. 将内容粘贴到相应的文件中（例如 `instagram.com_cookies.txt`）并保存。 ## 🚀 运行方式与快捷键 安装完成后，打开一个**新的终端窗口**并输入： ``` mint ``` ### 导航与快捷方式 * **`↑ / ↓` 方向键** — 导航主菜单。 * **`Enter`** — 启动选定的工具。 * **`1 - 5` 键** — 直接跳转以启动特定工具。 * **`6` 键** — 启动一键更新管理器。 * **`7` 或 `Ctrl+C`** — 退出指挥中心。 ## ⚙️ 配置文件 (`config.json`) 安装器会在 MINT 根目录下生成一个 `config.json` 文件，以动态映射所有系统路径。如果您移动了目录，可以手动编辑此文件： ``` { "tools_dir": "E:\\mint\\MINT_Tools", "social_dir": "E:\\mint\\mint-social", "mint_dir": "E:\\mint", "mint_py_path": "E:\\mint\\mint.py", "sherlock_path": "E:\\mint\\MINT_Tools\\sherlock", "holehe_path": "E:\\mint\\MINT_Tools\\holehe", "spiderfoot_path": "E:\\mint\\MINT_Tools\\spiderfoot", "toutatis_path": "E:\\mint\\MINT_Tools\\toutatis" } ``` ## 🔧 故障排除与控制台设置 * **Unicode 显示问题 (Windows)：** 如果您的 Windows 控制台中出现了扭曲的制表符，MINT 会在启动时自动强制使用 UTF-8 编码。如果问题仍然存在，请在启动 MINT 之前在终端中运行此命令： chcp 65001 * **Git 凭据冲突：** 如果更新管理器由于本地凭据冲突而无法拉取更新，MINT 会自动回退到下载官方 zip 压缩包，并将其干净地解压，而不会中断您的会话。 * **Android Termux 问题：** 请确保在开始下载之前运行 `termux-setup-storage`，以便 MINT 拥有将文件保存到手机存储的写入权限。

标签：ESC4, OSINT, Python, 实时处理, 数据泄露, 无后门, 终端工具, 逆向工具