PAIN-hub/OSINT-Recon

# OSINT 侦察工具包 [](https://pypi.org/) [](LICENSE) [](https://www.python.org) 一个专业、模块化且符合道德规范的 OSINT（开源情报）工具包，用于侦察、数字足迹分析和威胁情报富化。使用 Python 编写，并设计为可通过附加模块进行扩展。 - 代码库：https://github.com/PAIN-hub/OSINT-Recon - 包名：`osint-toolkit` 目录 - 功能 - 安装 - 用法 - 命令行入口 - 项目结构 - 模块 - 开发与测试 - 安全与道德规范 - 许可证 - 贡献 - 作者与支持 ## 功能 - 在许多公共平台上查询用户名 - IP 地址查询（地理位置、ISP、ASN、代理/VPN 检测） - 电子邮件泄露检查（兼容 HaveIBeenPwned 的检查） - 域名 WHOIS 查询和基本域名情报 - 结构化输出导出（JSON）保存在 `reports/` 中 - 模块化架构：在 `osint/modules` 下添加新模块 ## 安装 要求：Python 3.8+ 推荐（通过 GitHub 使用 pip）： ``` pip install git+https://github.com/PAIN-hub/OSINT-Recon.git ``` 或者从本地克隆安装： ``` git clone https://github.com/PAIN-hub/OSINT-Recon.git cd OSINT-Recon pip install -e . # 对于开发附加项（tests、linters） pip install -e .[dev] ``` 如果你愿意，也可以使用提供的依赖文件： ``` pip install -r requirements.txt ``` ## 用法 运行交互式控制台界面： ``` # 从 repository root 开始 python3 recon.py # 或者使用已安装的 console script osint-recon ``` 按照屏幕上的菜单执行用户名、IP、电子邮件和域名查询。报告将以 JSON 文件的形式保存到 `reports/` 目录。 示例（用户名查询）： ``` $ python3 recon.py Select an option: 1 Enter username: johndoe [+] Checking across platforms... [+] Report saved: reports/johndoe.json ``` ## 命令行入口 该包会安装一个名为 `osint-recon` 的控制台脚本，用于调用该工具的主入口点。安装该包后，运行： ``` osint-recon ``` ## 项目结构 ``` OSINT-Recon/ ├── osint/ # Package modules and CLI │ ├── cli.py # CLI implementation │ ├── recon.py # (if present) older top-level script │ ├── modules/ # Recon modules (username, ip, email, whois, ...) │ └── utils/ # Utility helpers ├── reports/ # Generated JSON output ├── tests/ # Unit tests ├── pyproject.toml # Build configuration ├── setup.py # Setuptools compatibility ├── requirements.txt # Optional requirements list ├── MANIFEST.in # Files included in source distribution ├── README.md # This file └── LICENSE # Project license (MIT) ``` ## 模块 在 `osint/modules/` 中添加新的侦察模块。每个模块都应公开一个简单的函数接口并返回可序列化为 JSON 的结果。示例模块职责： - `username_lookup.py` — 查询多个公共服务以匹配账户 - `ip_lookup.py` — 地理位置、ASN、ISP、代理检查 - `email_breach.py` — 查询泄露数据库以获取受影响的地址 - `domain_whois.py` — 返回解析后的 WHOIS 信息 ## 开发与测试 使用 pytest 运行测试： ``` pytest ``` 关于代码风格和格式化，推荐使用的工具（在 `[dev]` 扩展依赖中提供）：`black`、`flake8`、`isort`。 ## 安全与道德规范 此工具仅供合法、符合道德规范且经授权的使用。使用此软件即表示您同意： - 仅对您拥有明确权限的系统和账户进行侦察。 - 尊重您所在司法管辖区的隐私和适用法律。 - 不使用该工具骚扰、跟踪或以其他方式伤害他人或组织。 作者和贡献者对滥用行为不承担任何责任。 有关负责任的 OSINT 实践的更多详细信息，请参阅 `ethics.md`。 ## 许可证 该项目在 MIT 许可证下授权——详情请参阅 `LICENSE` 文件。 摘要（简述）： ``` MIT License Copyright (c) PAIN-hub ``` ## 作者与支持 - PAIN-hub — 项目作者和维护者 如果您觉得这个项目有用，请给该代码库加星 ⭐，并考虑提出 issue 或 PR 来改进它。 联系方式 / 社交媒体： - GitHub: https://github.com/PAIN-hub - X: https://x.com/0x_beely 感谢您使用 OSINT 侦察工具包。请负责任地使用。

标签：ESC4, OSINT, Python, 内存取证对抗, 安全规则引擎, 实时处理, 情报收集, 无后门, 漏洞研究, 逆向工具