OSINT Menace

v0.1.0 – Beta：在我机器上能跑版

有关此版本的变更和测试范围，请参阅 CHANGELOG.md。

开源侦察控制台

为猎人而建，而非浏览器。

OSINT Menace 是一个防御性思维项目。

OSINT Menace 是一个用于案件驱动型 OSINT 研究的 Python 应用程序，包含终端工作区和 Docker 化的 Web 界面。分析师可以收集公开来源的观察结果、审查结果、将有用的发现保存到案件中，并导出报告。

该工具专为防御性研究、数字足迹审查、调查笔记记录和授权安全工作而设计。它倾向于被动查询、生成的来源链接、公共记录关联、DNS/RDAP 信息、证书透明度、钱包浏览器以及分析师控制的案件管理。

状态

这是一个早期的本地构建版本，旨在日后发展为一个更完整的站点。当前版本可作为本地分析师控制台和 Docker 托管原型使用。

使用 python menace.py --version 检查已安装的版本。

终端界面

有关完整的终端工作流程和命令参考，请参阅 CLI.md。

终端搜索支持 GitHub/Bluesky/GitLab/Hacker News 公开个人资料、 电话元数据、比特币/以太坊摘要及近期交易、公开页面 文本/摘录以及结构化记录来源匹配。用户名/自动搜索默认 执行直接检查以及完整的候选个人资料链接列表；其他类型默认 执行收集。可显式选择 --mode links、--mode collect 或 --mode both。 CLI 还提供 OSINT Links 目录和独立的 HTML 导出。 SEC 和 CourtListener 需要来源配置；CLI 会明确报告缺失的配置以及被阻止/限流的 请求。请参阅 CLI 指南中的覆盖范围和凭据表。

在不启动浏览器或 Web 服务器的情况下运行 OSINT Menace：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python menace.py

编号菜单支持活动案件、选择性保存、重复检测、 案件/条目管理、审查状态、笔记/标签、引导式档案编辑、 批量输入以及 Word/Markdown/JSON/HTML 报告向导。直接命令支持 相同的已保存数据操作：

python menace.py search exampleuser --type username
python menace.py search example.com --type domain --json
python menace.py create "Investigation One"
python menace.py cases
python menace.py search exampleuser --type username --case CASE_ID --link 1 --link 3
python menace.py dossier --fields
python menace.py dossier CASE_ID --field summary --value "Analyst summary here"
python menace.py show CASE_ID
python menace.py export CASE_ID --format docx --output investigation.docx
python menace.py export demo --format docx --output demo.docx

--case 会保存完整结果，除非使用 --link 从单个目标中选择编号链接。 在分析师验证之前，链接仍为候选状态。 在命令前使用 --data-dir /path/to/data 可选择另一个数据目录； 默认是本检出目录下的 data 文件夹。Word 导出使用已保存的档案 字段。现有输出文件绝不会被覆盖。

使用 python menace.py --help 或 python menace.py search --help 查看标志。 原有的 osint_tool.py 搜索 CLI 仍然可用。

应用程序功能

• 赛博朋克风格的 Flask Web 界面。
• Docker 优先部署。
• 自动检测混合目标列表。
• 针对电子邮件、用户名、电话、全名、域名、IP 地址和加密钱包输入的搜索模块。
• 被动优先的 OSINT 工作流程。
• 按结果和按链接的案件捕获。
• 案件工作区以 JSON 文件形式存储在 data/cases 下。
• 当结果不匹配时删除单个案件条目。
• 通过精确名称确认删除整个案件。
• 将案件导出为 Word、JSON、Markdown 和样式化 HTML 报告。
• 从结果页面将原始搜索结果下载为 JSON。
• 在浏览器中筛选生成的结果。
• 包含精选公共 OSINT 资源的 OSINT Links 页面。
• 用于未来站点集成的 API 端点。

安全模型

OSINT Menace 默认有意保持保守。

默认包含：

• 公开个人资料 URL 候选。
• 搜索引擎关联链接。
• Gravatar 检查。
• DNS 记录。
• 可用时的 RDAP/WHOIS 风格公开注册数据。
• TLS 证书检查。
• 证书透明度链接和子域关联。
• Wayback/存档链接。
• 公开声誉查询链接。
• 钱包浏览器链接。
• ENS 查询链接。
• 仅在显式启用时可选的 basic port scan。

默认排除：

• 凭据搜寻。
• 针对私有服务的密码或泄露账户枚举。
• 暗网抓取。
• Onion 爬取。
• 规避逻辑。
• 需要登录的自动化。
• 针对私密通讯或家庭安全应用的账户发现。
• 仅 API 密钥的增强模块。
• 需要认证会话的自动化社交媒体抓取。

搜索类型

自动

自动模式接受由换行符、逗号或分号分隔的混合目标。它会检测可能的目标类型并运行匹配的模块。

示例：

[email protected]
John P. Smith
example.com
1.1.1.1
0x0000000000000000000000000000000000000000

电子邮件

电子邮件搜索包括：

• 格式验证。
• Gravatar 哈希/个人资料关联。
• 域名提取。
• MX/提供商线索。
• SPF/DMARC DNS 态势。
• 搜索引擎查询链接。
• 公开提及关联。

用户名

用户名搜索包括：

• 跨常见平台的候选个人资料 URL。
• GitHub、Reddit、YouTube、Pinterest、Tumblr、Telegram、Mastodon、Bluesky 以及其他公开个人资料风格的关联。
• 搜索引擎关联。
• 使用 {username} 的可选自定义论坛 URL 模式。

电话

电话搜索包括：

• 格式清理。
• 尽可能进行地区/国家猜测。
• 公开搜索查询生成。
• 公开提及关联。

Signal 和 Life360 账户发现有意不自动化。

全名

全名搜索包括：

• 搜索查询生成。
• LinkedIn/公开个人资料关联。
• 公共记录搜索链接。
• 商业登记搜索链接。

域名

域名搜索包括：

• DNS A、AAAA、MX、NS 和 TXT 记录。
• SPF/DMARC 态势。
• 可用时的 RDAP 公开注册详情。
• TLS 证书元数据。
• 证书透明度链接。
• 基于公开 CT 的子域发现关联。
• 技术线索。
• 存档/Wayback 关联。
• 声誉链接。

IP 地址

IP 搜索包括：

• IP 验证。
• 反向 DNS。
• RDAP/ASN 组织查询。
• 可用时的地理近似。
• 公开声誉链接。
• 被动 DNS 链接。
• 仅在用户显式启用授权扫描时可选的 basic port scan。

加密钱包

钱包搜索包括：

• 比特币/以太坊格式验证。
• 浏览器链接。
• 公开交易摘要关联。
• ENS 查询关联。

案件

案件是调查的工作文件夹。它们存储在：

data/cases/

案件工作流程支持：

• 创建新案件。
• 将完整搜索保存到案件。
• 将一个结果部分保存到案件。
• 将一个单独链接保存到案件。
• 存在多个案件时选择一个案件。
• 当恰好只有一个案件时自动保存到该案件。
• 添加到案件后让用户停留在结果页面。
• 删除单个已保存条目。
• 导出案件。
• 删除整个案件。

报告

在案件内使用 Edit Dossier 完成提供的背景、 调查结果、方法论、未完成任务和外部搜索笔记。 档案遵循所提供调查模板的结构。 已保存的搜索和选定的链接仍作为支持记录，并列在 捕获日志中。档案字段由分析师输入，并包含在 HTML、Markdown 和 JSON 导出中。使用 HTML 报告的打印操作 通过浏览器打印或保存为 PDF。在案件、 档案编辑器或报告页面上使用 Download Word 获取可编辑的 DOCX。在导出前保存你的档案编辑。 此版本未实现照片附件。

每个案件可以导出为四种格式：

• JSON：机器可读的案件数据。
• Word：可编辑的 DOCX 档案和已保存证据。
• Markdown：轻量级报告文本。
• HTML Report：样式化的最终报告页面，包含元数据、摘要、发现、链接、笔记和打印支持。

OSINT Links

/osint-links 页面包含一组精选的 OSINT 类别和链接，来源于：

https://start.me/p/L1rEYQ/osint4all

署名显示在 OSINT Links 页面底部。本地目录存储在：

data/catalog/osint_links.json

默认目录排除了明显不安全的身份生成、onion 镜像和抓取数据条目。

API

健康检查：

curl http://localhost:8088/health

运行搜索：

curl -sS http://localhost:8088/api/search \
  -H 'Content-Type: application/json' \
  -d '{"search_type":"auto","query":"[email protected]\nexampleuser\nexample.com"}'

支持的 search_type 值：

auto
email
username
phone
name
domain
ip
wallet

项目布局

.
├── menace.py               # Main CLI entry point and direct commands
├── cli_workspace.py        # Interactive search and case workflows
├── cli_catalog.py          # Platform coverage and OSINT Links catalog
├── collectors.py           # Direct public-source collectors
├── discovery.py            # Search modes and result classification
├── terminal_output.py      # Readable terminal output
├── app.py                  # Flask routes, case management, reports, API
├── osint_tool.py           # Shared search helpers and original CLI
├── dossier.py              # Dossier fields and Markdown sections
├── word_report.py          # Word report generation
├── demo.py                 # Fictional demo case
├── Dockerfile              # Python/Gunicorn container
├── docker-compose.yml      # Local service definition
├── requirements.txt        # Python dependencies
├── INSTALL.md              # Installation and operations guide
├── CLI.md                  # Terminal workflow and command reference
├── README.md               # Product and developer overview
├── data/
│   ├── cases/              # Saved case JSON files
│   └── catalog/            # OSINT Links catalog
├── exports/                # Created for local exports, excluded from Git
├── tests/                  # Automated CLI, collector, and report tests
├── static/
│   └── styles.css          # Cyberpunk UI styling
└── templates/              # Flask/Jinja HTML templates

开发检查

在项目根目录下，安装依赖后：

python -m unittest discover -s tests -v
git diff --check

测试使用临时案件目录和模拟网络响应。实时提供商 可用性与此测试套件无关。将本地报告保存在 exports/ 下，例如：

python menace.py export demo --format docx --output exports/demo.docx

已保存的案件、CLI 状态、凭据和本地导出均从 Git 中排除。 data/catalog 资源目录仍是应用程序的一部分。

启发了此应用程序的 GitHub 来源

以下 GitHub 项目作为参考材料被审查，用于工作流程思路、目标类别、UI/报告概念、防御边界或被动关联模式。OSINT Menace 不会在运行结果中展示这些署名，但在此记录以用于归属和项目历史。