内容
<div align="center">
```
___ ____ ________ _______
/ | / __ \/ ____/ / / / ___/
/ /| | / /_/ / / __/ / / /\__ \
/ ___ |/ _, _/ /_/ / /_/ /___/ /
/_/ |_/_/ |_|\____/\____//____/
百眼巨人. 无所不察.
100% 本地运行. 零 API 密钥. 零云依赖.
```
# 阿耳戈斯
### 本地优先的开源情报框架
**13个模块. 100% 开源. 零 API 密钥. 零云依赖.**
[](LICENSE)
[](https://www.python.org/)
[](https://modelcontextprotocol.io/)
<p align="center">
<em>AI 问题 硬停工具调用. 您的代码执行真正的二进制文件. 虚构的发现在结构上是不可能的.</em>
</p>
---
</div>
## 这是什么？
阿耳戈斯（Argus）是一个开源情报（OSINT）调查框架，**完全在您的机器上运行**。无需 API 密钥，无需云服务，无需遥测数据。每个模块都使用开源工具和免费的端点。
AI 代理自动链接工具 - 用纯英文描述您的目标，阿耳戈斯决定运行哪些工具并链接各个模块的发现结果。由 [Ollama](https://ollama.ai) 提供本地推理支持。
## 模块
| 模块 | 功能 | 替代工具 | 需要 API 密钥？ |
|--------|-------------|----------|---------|
| `email_recon` | 邮箱 → 58 个社交服务 | holehe | ❌ |
| `username_enum` | 用户名 → 52 个平台 | sherlock | ❌ |
| `subdomains` | 域名 → 子域名（crt.sh + DNS 暴力） | sublist3r | ❌ |
| `crawler` | 爬取 URL，搜索秘密/端点/错误 | Bright Data | ❌ |
| `network_recon` | nmap 端口扫描 + 横幅抓取 | Shodan + Censys | ❌ |
| `dns` | DNS 记录 + SPF/DMARC 分析 | — | ❌ |
| `whois` | 域名注册人信息 | — | ❌ |
| `breach` | 查询本地泄露数据库（您提供数据） | HIBP API | ❌ |
| `github` | GitHub 个人资料，仓库，提交电子邮件 | — | ❌* |
| `phone` | 手机运营商，位置，线路类型 | phoneinfoga | ❌ |
| `ipgeo` | IP 地理位置（GeoLite2 本地数据库） | IP2Location API | ❌ |
| `dorks` | 生成 12 个 Google dork URL | Bright Data SERP | ❌ |
| `paste` | 搜索粘贴转储（psbdmp.ws） | — | ❌ |
*GitHub: 免费情况下 60 req/min，无需令牌；可选令牌情况下 5000。
> **注意 breach_check 模块：** 该模块查询一个**本地** SQLite 数据库，您需要自己填充它。它不爬取暗网，不访问 Telegram 频道，也不查询 HIBP 的后端。如果您需要全面的泄露数据，[HIBP](https://haveibeenpwned.com) 和 [intelx](https://intelx.io) 是合适的工具。泄露模块适用于已经拥有泄露数据汇编的研究人员，并希望在本地查询它们，而无需向第三方 API 发送电子邮件。
## 快速开始
```bash
# 安装
git clone https://github.com/cotcollective/argus.git
cd argus
python3 -m venv venv --copies
./venv/bin/pip install -e .
# 运行单个模块
./venv/bin/argus dns example.com
./venv/bin/argus whois github.com
./venv/bin/argus subdomains target.com
./venv/bin/argus crawl https://target.com
./venus/bin/argus github username
./venv/bin/argus ipgeo 8.8.8.8
./venv/bin/argus dorks target@email.com
./venv/bin/argus paste target@email.com
./venv/bin/argus email target@example.com
./venv/bin/argus username johndoe
./venv/bin/argus phone +15145551234
./venv/bin/argus breach email@example.com
./venv/bin/argus network 10.0.0.1
# AI 链接调查（需要 Ollama）
./venv/bin/argus investigate "investigate johndoe@gmail.com"
# 交互式 REPL
./venv/bin/argus
# JSON 输出
./venv/bin/argus dns example.com --json
# 列出所有模块
./venv/bin/argus modules
```
## AI 链接
阿耳戈斯使用 [Ollama](https://ollama.ai) 进行本地 AI 驱动的工具链接。AI 代理：
1. **分析** 您的目标（邮箱，用户名，域名，IP，URL，电话号码）
2. **选择** 根据输入类型运行哪些模块
3. **链接** 模块的发现结果（邮箱 → 泄露 → 用户名枢轴 → 平台枚举）
4. **生成** 带有 Markdown 和 JSON 报告
```bash
# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 拉取模型（推荐 qwen2.5:7b — 原生工具调用支持）
ollama pull qwen2.5:7b
# 运行调查
./venv/bin/argus investigate "investigate the domain github.com"
./venv/bin/argus investigate "who is edoardottt?"
./venv/bin/argus investigate "find everything about john@example.com"
```
无需 Claude，无需 Anthropic API，无需 OpenAI。100% 本地推理。
## MCP 服务器
阿耳戈斯将所有 13 个模块公开为 [MCP](https://modelcontextprotocol.io/) 工具。将其连接到任何 MCP 兼容的客户端（Hermes Agent，Claude Code，Cursor 等）：
```yaml
# Hermes Agent 配置（~/.hermes/config.yaml）
mcp_servers:
argus:
command: "/path/to/venv/bin/python3"
args: ["-m", "argus.mcp_server"]
timeout: 300
```
重启后，工具显示为 `mcp_argus_dns`、`mcp_argus_whois`、`mcp_argus_crawler` 等。
## 架构
```
argus/
cli.py # Click CLI + prompt-toolkit REPL
config.py # 基于环境的配置
core/
base.py # BaseModule ABC + Finding 数据类
registry.py # 模块注册 + 自动发现
report.py # Markdown + JSON 报告生成器
modules/
email_recon.py # 58 个服务，异步，纯 Python
username_enum.py # 52 个平台，异步，纯 Python
subdomain_enum.py # crt.sh + DNS 暴力
crawler.py # cariddi Go 二进制包装器
network_recon.py # nmap XML 解析器
dns_recon.py # dnspython + SPF/DMARC/DKIM
whois_lookup.py # python-whois
breach_check.py # 本地 SQLite 数据库
github_recon.py # GitHub REST API
phone_recon.py # libphonenumber
ip_geolocation.py # GeoLite2 + ipinfo.io 备用
dork_generator.py # 12 个 dork URL 模板
paste_search.py # psbdmp.ws API
ai/
chain.py # Ollama 工具链接代理
mcp_server.py # MCP 服务器（stdio 传输）
```
## 可选增强
<details>
<summary>📦 GeoLite2（100% 离线 IP 地理位置）</summary>
```bash
# 免费 MaxMind 账户：https://www.maxmind.com/en/geolite2/signup
# 下载 GeoLite2-City.mmdb，放置在 ~/.argus/
./venv/bin/pip install maxminddb
```
</details>
<details>
<summary>📦 泄露数据库（本地泄露数据汇编）</summary>
```bash
sqlite3 ~/.argus/breaches.db \
"CREATE TABLE breaches (email TEXT, breach_name TEXT, date TEXT, data_classes TEXT)"
# 通过您喜欢的方法导入泄露数据汇编
```
</details>
<details>
<summary>📦 电话全分析</summary>
```bash
./venv/bin/pip install phonenumbers
```
</details>
<details>
<summary>📦 Cariddi（网页爬虫引擎）</summary>
```bash
# cariddi 是爬虫引擎（可选 — 没有它，爬虫模块将无法工作）
git clone https://github.com/edoardottt/cariddi.git
cd cariddi && go get ./... && go build -o /usr/local/bin/cariddi ./cmd/cariddi/
# 或设置 ARGUS_CARIDDI 环境变量为二进制文件路径
```
</details>
## 配置
所有配置均通过环境变量完成（均为可选）：
| 变量 | 默认值 | 描述 |
|----------|---------|-------------|
| `ARGUS_OLLAMA_HOST` | `http://127.0.0.1:11434` | Ollama API 主机 |
| `ARGUS_OLLAMA_MODEL` | `qwen2.5:7b` | Ollama AI 链接模型 |
| `ARGUS_CARIDDI` | `cariddi` | cariddi 二进制文件路径 |
| `ARGUS_GEOLITE2_DB` | `~/.argus/GeoLite2-City.mmdb` | MaxMind GeoLite2 数据库路径 |
| `ARGUS_BREACH_DB` | `~/.argus/breaches.db` | 本地泄露 SQLite 数据库 |
| `ARGUS_REPORT_DIR` | `./reports` | 报告输出目录 |
| `ARGUS_GITHUB_TOKEN` | （无） | GitHub 令牌（将速率限制提高到 5000/小时） |
| `ARGUS_PROXY` | （无） | HTTP 代理 URL |
| `ARGUS_CONCURRENCY` | `20` | 并发请求限制 |
| `ARGUS_TIMEOUT` | `30` | HTTP 请求超时（秒） |
## 与其他工具集成
阿耳戈斯补充了进攻性安全工具：
- **[T3MP3ST](https://github.com/elder-plinius/T3MP3ST)** — 红队 CVE 狩猎、CTF、漏洞利用链的工具
- **[cariddi](https://github.com/edoardottt/cariddi)** — 阿耳戈斯中的爬虫引擎
- **[nmap](https://nmap.org/)** — 阿耳戈斯中的网络扫描器
**自然链**: 阿耳戈斯绘制目标地图 → T3MP3ST 进行攻击。
## 哲学
- **本地优先**: 所有操作都在您的机器上运行。除目标网站外，无需云调用。
- **零 API 密钥**: 所有模块均无需付费 API 密钥。替换 HIBP、Shodan、Censys、IP2Location 为本地等效工具。
- **无虚构**: AI 建议工具调用，代码执行真正的二进制文件。发现结果是真实的。
- **模块化**: 每个模块都是独立的。单独运行或通过 AI 链接。
- **开源**: MIT 许可证。基于开源工具构建。
## 法律免责声明
> **阿耳戈斯仅用于合法和授权的用途。**
>
> 用户完全负责确保其使用符合所有适用的法律和法规。作者不对滥用行为承担任何责任。
>
> 阿耳戈斯是一个开源情报（OSINT）框架，设计用于安全研究人员、渗透测试人员、漏洞赏金猎人和分析师进行授权调查，使用公开可用的信息。
>
> **请勿使用阿耳戈斯：**
> - 跟踪、骚扰或恐吓个人
> - 未经明确授权访问系统或数据
> - 违反任何平台的服务条款
> - 进行未经授权的监控
>
> 在调查任何目标之前，请始终获得适当的授权。如有疑问，请咨询法律顾问。
## 致谢
**阿耳戈斯** 由 [COT Collective](https://github.com/cotcollective) 构建，并结合 AI 协作。
由以下项目提供支持：
- [cariddi](https://github.com/edoardottt/cariddi) by @edoardottt — 网络爬虫 + 秘密猎人
- [dnspython](https://www.dnspython.org/) — DNS 工具包
- [python-whois](https://github.com/richardpenman/whois) — WHOIS 查询
- [Ollama](https://ollama.ai/) — 本地 LLM 推理
- [MCP](https://modelcontextprotocol.io/) — 模型上下文协议
## 许可证
MIT — 请参阅 [LICENSE](LICENSE) 文件。
