jasperan/whatsapp-osint

# 🕵️‍♂️ WhatsApp Beacon (OSINT 追踪器)    **WhatsApp Beacon** 是一个功能强大的跨平台 OSINT 工具，旨在追踪 WhatsApp 用户的在线状态。它利用 Selenium 和 Web WhatsApp 监控连接模式，并生成详细的日志和报告。 ## 安装 ## ✨ 功能 - **跨平台**：在 Windows、Linux 和 macOS 上无缝运行。 - **自动化驱动管理**：无需手动下载 `chromedriver`。 - **无头模式**：在后台运行，不显示浏览器窗口。 - **详细日志**：精确追踪在线/离线事件。 - **数据导出**：将会话日志导出为 Excel 以供分析。 - **可配置**：使用 CLI 参数或简单的 `config.yaml` 文件。 - **弹性恢复**：处理网络中断和浏览器重启。 ## 🛠️ 安装 1. **克隆仓库**： git clone https://github.com/jasperan/whatsapp-osint.git cd whatsapp-osint 2. **安装依赖**： 建议使用虚拟环境。 pip install -r requirements.txt ## 🚀 使用方法 您可以使用命令行参数或配置文件运行追踪器。 ### 快速开始 ``` python3 -m src.whatsapp_beacon.main -u "John Doe" ``` ### 命令行参数 | 参数 | 描述 | 默认值 | |----------|-------------|---------| | `-u`, `--username` | 要追踪的 WhatsApp 用户名（即您联系人中保存的名称）。 | 必填 | | `-l`, `--language` | 您的 WhatsApp Web 界面的语言代码（例如 `en`、`es`、`fr`）。 | `en` | | `-e`, `--excel` | 启动时将数据库日志导出到 Excel 文件。 | `False` | | `--headless` | 以无头模式运行（无浏览器窗口）。 | `False` | | `--config` | 自定义配置文件的路径。 | `config.yaml` | ### 示例 **使用西班牙语 WhatsApp Web 在无头模式下追踪用户：** ``` python3 -m src.whatsapp_beacon.main -u "Maria" -l es --headless ``` **将数据导出到 Excel：** ``` python3 -m src.whatsapp_beacon.main -u "John Doe" -e ``` ## ⚙️ 配置 您可以在 `config.yaml` 中永久设置您的偏好： ``` username: "Target Name" language: "en" headless: false excel: false browser: "chrome" log_level: "INFO" data_dir: "data" ``` ## 📊 输出 - **日志**：保存到 `logs/whatsapp_beacon.log` 并显示在控制台中。 - **数据库**：所有会话存储在 `data/victims_logs.db` 中。 - **Excel**：导出的报告保存为 `History_wp.xlsx`（路径可在代码中配置）。 ## 🤖 无头模式与身份验证 首次在**无头模式**下运行时： 1. 该工具将尝试登录。 2. 如果未通过身份验证，它将把 QR 码的截图保存到 `qrcode.png`。 3. 打开 `qrcode.png` 并使用手机上的 WhatsApp 进行扫描。 4. 该工具将检测到登录并继续运行。 *注意：建议在非无头模式下运行一次以进行身份验证，因为会话会保存在 `data/chrome_profile` 中。* ## 📜 许可证 根据 MIT 许可证分发。有关更多信息，请参阅 `LICENSE`。

标签：ESC4, ESC8, OSINT, Python, Selenium, Spyware, WhatsApp, 在线状态追踪, 密码管理, 情报收集, 数据导出, 无后门, 漏洞研究, 用户行为分析, 监控工具, 社会工程学, 网络调试, 自动化, 追踪器, 逆向工具, 隐私侵犯, 隐私安全