SOsintOps/claudii-exploratores
GitHub: SOsintOps/claudii-exploratores
将包含 898 个工具的 OSINT 搜索目录封装为 Claude 的 Agent Skill 与 MCP Server，实现指标自动分类与搜索链接构建的 AI 原生情报调查套件。
Stars: 0 | Forks: 0
# Claudii Exploratores
### 专为 Claude 打造的 OSINT 套件 — Agent Skill + MCP Server
*“Claudius 的侦察兵”* — 致敬罗马侦察部队（*exploratores*）
并致敬 Claude。面向 AI agent 的 OSINT 侦察。
[](#-project-status)
[](#)
[](LICENSE)
[](#-requirements)
[](https://modelcontextprotocol.io)
[](#-features)
## 目录
- [关于](#-about)
- [功能](#-features)
- [工作原理](#-how-it-works)
- [仓库结构](#-repository-layout)
- [环境要求](#-requirements)
- [安装](#-installation)
- [Agent Skill](#agent-skill-claude-code--cowork)
- [MCP Server](#mcp-server-claude-desktop)
- [使用方法](#-usage)
- [可用的 MCP 工具](#-available-mcp-tools)
- [重建目录](#-rebuilding-the-catalog)
- [项目状态](#-project-status)
- [路线图](#-roadmap)
- [贡献](#-contributing)
- [安全与负责任的使用](#-security--responsible-use)
- [免责声明](#-disclaimer)
- [许可证](#-license)
- [致谢](#-acknowledgements)
## 🔎 关于
**Claudii Exploratores** 将 [**Exploratores OSINT Toolkit**](https://github.com/SOsintOps/Exploratores)
— 一个包含精选 OSINT 搜索链接的静态 Web 应用 — 转化为两个 AI 原生发行版：
1. **一个 Agent Skill** (`skill/`) — 可直接嵌入 Claude Code、Cowork 或 Agent SDK 中 Claude (Opus/Sonnet) 的技能。它向模型传授专业的 OSINT 技术方法（分析标准、5W1H 方法、OPSEC），并提供了一个 CLI，可将任何指标转化为精选的搜索链接集合。
2. **一个 MCP server** (`mcp/`) — 一个 [Model Context Protocol](https://modelcontextprotocol.io)
server (Python / FastMCP)，将相同的引擎作为可调用工具提供给 Claude
Desktop 或任何兼容 MCP 的客户端。
两者共享一个语言中性的核心：一个包含 **24 个类别**的 **898 个 OSINT 工具**目录、一个指标分类器、输入验证器、一个离线 IBAN 验证器和一个可逆的 PII 编辑器 — 全部从原始工具包移植而来。
## ✨ 功能
- **898 个精选 OSINT 工具**，涵盖 24 个类别（人物、用户名、电子邮件、
域名、IP、电话、公司、加密货币、IBAN、地图、媒体、社交平台等）。
- **指标分类器** — 自动检测值是域名、电子邮件、IP、
用户名、人名、电话、坐标、IBAN、加密货币地址、VIN 等。
- **精选 URL 构建器** — 仅填充和 URL 编码适合该指标的工具，
因此您可以获得相关且范围明确的集合，而不是 898 个原始链接。
- **跨平台追踪** — 一个用户名即可在每个支持它的
社交/社区平台中扩展到正确的搜索。
- **离线 IBAN 验证器** — 依据 71 个国家/地区表进行 ISO 13616 mod-97 校验。
- **可逆 PII 编辑器** — 在将案例文本发送到外部模型之前脱敏电子邮件、IP、电话、IBAN、卡号、URL 和
加密货币地址；之后再恢复。
- **该技能无强制依赖项** — 仅需 Python 3.9+ 标准库。
- **单一事实来源** — 一个共享的引擎 + 目录，由构建脚本同步到两个
交付物中；可从上游工具包重新生成。
## 🧭 工作原理
```
indicator ──▶ classify ──▶ build fields ──▶ select matching tools ──▶ URL-encode ──▶ curated link set
"Mario Rossi" PERSON_NAME {firstname,lastname,…} names + records %20… grouped Markdown / JSON
```
该引擎是工具包原始 JavaScript 逻辑
（`indicator-classifier.js`、`validators.js`、`main.js`）的忠实 Python 移植版，
因此生成的 URL 与 Web 工具包生成的相匹配。
## 📦 仓库结构
```
Claudii-Exploratores/
├── skill/claudii-exploratores/ # the Agent Skill (SKILL.md + scripts + references)
│ ├── SKILL.md
│ ├── scripts/ # exploratores.py CLI + engine + catalog.json
│ └── references/ # methodology.md, catalog_overview.md
├── mcp/ # the MCP server (Python, FastMCP)
│ ├── exploratores_osint_mcp/ # package: server.py + engine + catalog.json
│ ├── pyproject.toml
│ ├── config.example.json
│ └── README.md
├── shared/ # single source of truth for the engine + catalog
│ ├── osint_core.py # classifier, field builder, URL renderer
│ ├── iban_tools.py, redactor.py, _iban_countries.py
│ └── catalog.json # 898 tools (generated)
├── scripts/ # build & extraction tooling
│ ├── extract_catalog.js # (re)generate catalog.json from the web toolkit
│ └── build_release.sh # sync engine into skill+mcp, package .skill
├── docs/ # INSTALL.md, DISTRIBUTION.md
├── dist/ # build outputs (.skill archive) — git-ignored
├── LICENSE # AGPL-3.0 (inherited from Exploratores)
└── NOTICE
```
`shared/` 是权威来源。`scripts/build_release.sh` 将引擎 + 目录复制到
`skill/` 和 `mcp/` 中，因此每个都可以独立安装。
## ⚙️ 环境要求
- **Python 3.9+**（该技能仅需标准库；MCP 额外需要 `mcp` 包）。
- **Node.js** — 仅在需要从上游工具包*重新生成*目录时使用。
- 现代浏览器（建议使用 VPN + 无痕配置文件）以*打开*
生成的链接。
## 🚀 安装
### Agent Skill (Claude Code / Cowork)
将该技能复制到您的技能目录中，或者从
客户端的 UI 安装打包好的归档文件：
```
mkdir -p ~/.claude/skills
cp -R skill/claudii-exploratores ~/.claude/skills/
# 或从你的 Claude 客户端安装 dist/claudii-exploratores.skill
```
然后只需提问，例如 *“对域名 example.com 运行 OSINT”*。
### MCP Server (Claude Desktop)
```
cd mcp
pip install -e . # or: uv pip install -e .
```
将服务器添加到您的 MCP 客户端配置中（参见 [`mcp/README.md`](mcp/README.md) 和
[`docs/INSTALL.md`](docs/INSTALL.md)）：
```
{
"mcpServers": {
"claudii-exploratores": {
"command": "python",
"args": ["-m", "exploratores_osint_mcp.server"]
}
}
}
```
## 💻 使用方法
直接驱动该技能的 CLI：
```
cd skill/claudii-exploratores
# 检测 indicator 是什么
python scripts/exploratores.py classify "john.doe@example.com"
# 构建精选的 OSINT 链接集（默认为分组的 Markdown）
python scripts/exploratores.py urls "example.com" --format markdown
# 强制指定类型，添加结构化字段，或缩小到特定平台
python scripts/exploratores.py urls "Mario Rossi" --type PERSON_NAME \
--field firstname=Mario --field lastname=Rossi
python scripts/exploratores.py urls "johndoe" --categories x,instagram,vk
# 实用工具
python scripts/exploratores.py iban "GB82 WEST 1234 5698 7654 32"
python scripts/exploratores.py redact "Contact john@x.com from 8.8.8.8"
python scripts/exploratores.py search "wayback"
```
## 🛠 可用的 MCP 工具
| 工具 | 用途 |
| --- | --- |
| `classify_indicator(value)` | 检测指标类型及其置信度评分。 |
| `build_osint_urls(value, indicator_type?, categories?, fields?, include_onion?, limit?)` | 为指标提供精选的 OSINT 搜索 URL 集合。 |
| `search_catalog(query, limit?)` | 在 898 个工具目录中进行自由文本搜索。 |
| `list_categories()` | 类别和工具数量。 |
| `verify_iban(value)` | 离线 IBAN 验证 (ISO 13616 mod-97)。 |
| `redact_pii(text, only?, custom_patterns?)` | 脱敏 PII，返回一个可逆的映射。 |
| `restore_pii(text, redaction_map)` | 逆转脱敏操作。 |
## 🔄 重建目录
如果上游工具包已更新，请从中重新生成所有内容：
```
scripts/build_release.sh /path/to/Exploratores-3.4.1
```
这将重新提取 `catalog.json`（包含从工具包的 HTML 页面中抓取的人类可读标签），
将引擎重新同步到两个交付物中，并重新打包
`.skill` 归档文件。
## 🧪 项目状态
**Alpha (v1.0.0-alpha)。** 该套件功能齐全，并且已通过内部 QA 测试
（目录完整性、URL 编码、IBAN 和脱敏往返测试、MCP 工具
注册）。它**尚未**针对生产环境进行强化。已知局限性：
- 少量 URL 模板原样继承自上游，可能存在
不完善之处（例如，带有字面空格的 dork 运算符；一个退化的短 URL
模板）。
- 电话号码字段派生已尽力而为，并未复制原始 Web 工具包完整的
`libphonenumber` 逻辑。
- 针对于 IBAN 的离线**银行名称**解析未移植（仅进行了结构性
验证）；该数据集存在于原始 Web 工具包中。
请在**受控环境中进行测试**，并在任何
实际使用前报告问题。
## 🗺 路线图
- [ ] 自动化测试套件 (pytest)，覆盖分类器、渲染器、IBAN、编辑器。
- [ ] CI (GitHub Actions)，用于在每次 push 时进行 lint + 测试。
- [ ] 可选的 MCP server 的 PyPI 发布。
- [ ] 实现与上游工具包更完全一致的电话号码解析功能。
- [ ] 针对 IBAN 的可选银行名称解析。
## 🛡 安全与负责任的使用
- **仅用于授权、合法的调查** — 研究、安全、新闻、
尽职调查。请勿用于跟踪、骚扰或人肉搜索。
- **这些工具构建链接；它们不会抓取数据。** 打开页面会将您的 IP
和指纹暴露给目标控制的基础设施 — 请使用 VPN 和无痕
浏览器配置文件，并优先使用缓存/存档视图进行首次接触。
- **将所有输出视为需要验证的线索**，切勿作为最终结论。请通过
独立来源进行印证并记录出处。
- 部分目录条目是 **Tor 隐藏服务**（`.onion`），需要 Tor
浏览器；使用 `--no-onion` / `include_onion=false` 排除它们。
如需报告安全问题，请在 GitHub 上提交私人安全建议，而
不是发布公开 issue。
## ⚠️ 免责声明
本软件按**“原样”提供，不提供任何形式的保证**，无论是明示还是
暗示。它处于 **beta** 阶段，**不适用于生产环境**。作者和
贡献者对因使用本软件而产生的任何损害、损失、法律后果或
误用**不承担任何责任**。您需全权负责确保您的使用
符合所有适用法律、法规和第三方服务条款，并
在采取行动之前独立验证每项结果。
## 📄 许可证
基于 **GNU Affero General Public License v3.0 (AGPL-3.0)** 授权 — 与原始
作品相同。参见 [`LICENSE`](LICENSE) 和 [`NOTICE`](NOTICE)。
## 🙏 致谢
衍生自 *Ramingo* ([SOsintOps](https://github.com/SOsintOps/Exploratores)) 的 **Exploratores OSINT Toolkit**。
本项目将其搜索目录、分类器、验证器、IBAN 表和
编辑器概念移植到 Python 引擎中，并打包为 Claude 技能和 MCP server。
原始工具包及其精心整理的所有荣誉均归属于上游作者。标签：AI代理, ESC4, MCP, MITM代理, OSINT, Python, 实时处理, 无后门, 逆向工具