l3abouch/L3ABOUCH-Searcher

## 📸 截图 ## ✨ 功能特性 | 特性 | 描述 | |---------|-------------| | 🔎 **多平台搜索** | 在一次会话中查询 12 个以上的公共平台 | | 📱 **电话号码验证** | 兼容 E.164 标准的输入验证，并提供友好的错误提示 | | 📂 **会话导出** | 将您的研究会话保存为带有时间戳的 `.txt` 报告 | | 📝 **搜索历史** | 查看当前会话中执行过的每一次搜索 | | ⚙️ **配置文件** | 完全可编辑的 `config.json` —— 无需修改源码即可添加平台 | | 📋 **自动日志** | 每日自动将循环日志文件写入 `logs/` 目录 | | 🌀 **动画加载指示器** | 在浏览器标签页打开时提供视觉反馈 | | 📐 **响应式布局** | 适应您的终端宽度 —— 无论是宽屏桌面还是狭窄的 Termux | | 🐍 **纯 Python** | 零外部依赖 —— 仅使用标准库 | | 🐧 **跨平台** | Kali Linux · Debian · Ubuntu · Termux | ## 📦 安装说明 ### Kali Linux / Debian / Ubuntu ``` git clone https://github.com/l3abouch/L3ABOUCH-Searcher.git cd L3ABOUCH-Searcher python3 l3abouch.py ``` ### Termux (Android) ``` pkg update && pkg install git python git clone https://github.com/l3abouch/L3ABOUCH-Searcher.git cd L3ABOUCH-Searcher python l3abouch.py ``` ## ⚙️ 环境要求 - Python **3.9** 或更高版本 - 活跃的互联网连接 - 已安装现代 Web 浏览器 - 无需任何第三方包 ## 🗂️ 项目结构 ``` L3ABOUCH-Searcher/ │ ├── l3abouch.py # Main script — single-file, drop-in ├── config.json # Auto-generated on first run; fully editable ├── README.md ├── LICENSE │ ├── logs/ # Auto-created — daily rotating session logs │ └── YYYY-MM-DD.log │ ├── exports/ # Auto-created — timestamped session exports │ └── session_YYYYMMDD_HHMMSS.txt │ └── images/ ├── home.png └── menu.png ``` ## 🧭 使用说明 运行脚本并按照屏幕上的菜单操作： ``` [01] Facebook [07] TikTok [02] Instagram [08] Truecaller [03] LinkedIn [09] WhatsApp [04] Twitter/X [10] Pastebin [05] GitHub [11] PDF Files [06] YouTube [12] All Web [A] Open All Searches [H] View Session History [E] Export Session to File [N] Search New Number [Q] Quit ``` ### 键盘快捷键 | 按键 | 操作 | |-----|--------| | `1`–`12` | 在浏览器中打开对应的平台 | | `A` | 一次性打开所有平台 | | `H` | 显示会话内的搜索历史 | | `E` | 将会话导出到 `exports/` | | `N` | 开始新的电话号码搜索 | | `Q` | 退出（如果存在历史记录则自动导出） | | `Ctrl+C` | 安全中断 → 干净退出 | ### 自定义平台 编辑 `config.json` 即可添加、删除或重新排序平台，而无需更改源码： ``` { "platforms": [ { "name": "Facebook", "query": "\"{phone}\" site:facebook.com" }, { "name": "MyCustom", "query": "\"{phone}\" site:example.com" } ], "search_engine": "https://www.google.com/search?q=", "tab_delay": 0.40, "log_enabled": true } ``` ## 🔒 隐私与道德规范 此工具仅执行**基于 Google 的搜索** —— 它不会联系任何电话运营商、社交网络 API 或第三方数据代理商。每个查询都被构造为标准的 Google 搜索 URL，并在您的本地浏览器中打开。 **预期的使用场景：** - 安全研究人员验证数据泄露情况 - 渗透测试人员进行授权的测试工作 - 个人检查自己的数字足迹 - 网络安全学生和教育工作者 **严禁用于：** 监视、骚扰、跟踪或任何违反适用法律或平台服务条款的活动。 ## ⚠️ 免责声明 ## 👨‍💻 作者 ## 📜 更新日志 | 版本 | 更新亮点 | |---------|-----------| | **3.0** | 支持 `config.json` · 每日日志 · 会话导出 · `[H]` 历史记录 · 加载指示器 · 响应式布局 · Termux 浏览器修复 · 统一退出 | | **2.0** | 多平台搜索 · 彩色 UI · 菜单循环 · 电话号码验证 | | **1.0** | 首次发布 | ## 🗺️ 路线图 - [ ] 用于脚本/自动化的 `--phone` CLI 参数 - [ ] 将 DuckDuckGo / Bing 作为备用搜索引擎（通过配置） - [ ] 用于机器可读会话的 JSON 导出格式 - [ ] 内联日志查看器 `[L]` 菜单选项 - [ ] 插件系统 —— 将 `.json` 拖放到 `plugins/` 即可添加平台 - [ ] 会话内的结果去重

标签：ESC4, OSINT, Python, 实时处理, 无后门, 逆向工具