Hostile‑Command‑Suite

Hostile Command Suite - OSINT Package

作者： cycloarcane
联系： [email protected]
许可证： PolyForm Noncommercial License 1.0.0

智能开源情报调查系统

基于终端的 OSINT 调查框架，具备 AI 驱动的分析和智能 Agent 决策功能。支持自动抓取个人资料、跨平台用户名调查，以及本地 LLM 集成，以增强情报收集能力。

---

🚀 快速开始

前置条件

1. 安装 ollama（用于 AI 分析）：

curl -fsSL https://ollama.ai/install.sh | sh
ollama pull qwen3:8b  # recommended model

2. 安装 OSINT 工具：

# Arch Linux
yay -S sherlock-git mosint

# Ubuntu/Debian  
pip install sherlock-project
# For mosint, download from: https://github.com/alpkeskin/mosint

安装

git clone https://github.com/cycloarcane/Hostile-Command-Suite.git
cd Hostile-Command-Suite
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
pip install -r requirements.txt

使用方法

交互式综合调查：

python3 HCSO.py --interactive
# Then provide ALL target information: names, usernames, emails, addresses, etc.

命令行调查：

# Single targets (backward compatibility)
python3 HCSO.py cycloarcane
python3 HCSO.py [email protected]

# Comprehensive targets (multiple data points)
python3 HCSO.py "John Smith, @johnsmith123, [email protected], works at Acme Corp"
python3 HCSO.py --model llama3.2 "Jane Doe [email protected] https://linkedin.com/in/janedoe"

---

🛠️ 功能

核心功能

• 🔍 用户名调查：集成 Sherlock，覆盖 400 多个社交媒体平台
• 📧 电子邮件调查：集成 Mosint，用于电子邮件情报和泄露分析
• 🌐 个人资料抓取：自动提取已发现账户的个人资料详情
• 🔍 网络搜索情报：集成 DuckDuckGo 搜索，全面收集 OSINT
• 🤖 AI Agent：集成本地 ollama，实现智能决策和分析
• ⚡ 智能工作流：自动串联工具并调整调查方向
• 🎨 丰富的终端界面：专业的红黑主题界面，带进度指示器

支持的目标

目标类型	主要工具	辅助工具	AI 分析
用户名	Sherlock → 个人资料抓取器	DuckDuckGo 搜索、链接分析器	✅ 完整分析
电子邮件	Mosint	DuckDuckGo 搜索	✅ 完整分析
任意目标	DuckDuckGo 搜索	依上下文调整调查方向	✅ 完整分析

MCP 工具架构

系统使用基于 Model Context Protocol（MCP）的工具服务：

• sherlock_server.py：跨平台用户名调查
• mosint_server.py：电子邮件枚举和泄露调查
• profile_scraper_server.py：智能提取个人资料内容
• duckduckgo_server.py：网络搜索，全面收集情报
• link_analyzer_server.py：深入分析 URL 和 GitHub 个人资料

AI 驱动的情报分析

AI Agent 可提供：

• 全面的数据提取：使用 LLM 解析和分类提供的所有目标信息
• 智能工具选择：根据数据类型自动选择合适的工具：
  • 姓名 → 使用 DuckDuckGo 网络搜索公开记录和新闻
  • 用户名 → 使用 Sherlock 搜索社交媒体平台
  • 电子邮件 → 使用 Mosint 查询泄露数据并分析域名
  • 组织 → 通过网络搜索收集企业情报
  • URL → 使用链接分析器深入分析内容
• 调查方向调整：发现新线索并建议后续操作
• 安全风险评估：评估暴露程度和安全影响
• 模式识别：识别跨平台和数据源的关联
• 决策：判断调查是否完成，或是否需要继续

---

🏗️ 架构

智能 Agent 设计

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   HCSO Agent    │──▶│  Ollama AI       │───▶│ Investigation   │
│                 │    │  Decision Engine │    │ Recommendations │
└─────────────────┘    └──────────────────┘    └─────────────────┘
         │
         ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│ MCP Tool        │──▶│  Tool Results    │───▶│ Profile Scraper │
│ Manager         │    │  Analysis        │    │ Auto-Trigger    │
└─────────────────┘    └──────────────────┘    └─────────────────┘
         │
         ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│ Sherlock        │    │ Mosint           │    │ Profile         │
│ Username Search │    │ Email Intel      │    │ Scraper         │
└─────────────────┘    └──────────────────┘    └─────────────────┘

调查工作流

1. 全面输入：用户提供所有可用的目标信息（姓名、用户名、电子邮件、地址、组织、URL 等）
2. AI 数据提取：大模型解析信息，并将其分类为结构化数据类型
3. 智能工具选择：系统根据每种数据类型自动选择合适的工具：
   • 姓名 → 搜索网络以获取公开情报
   • 用户名 → 查找社交媒体平台
   • 电子邮件 → 泄露数据分析和域名情报
   • 组织 → 搜索企业和公开记录
   • URL → 深入分析内容和个人资料
4. 并行调查：根据提取的数据，同时执行多个工具
5. AI 分析：智能分析所有发现并交叉比对
6. 决策点：AI 建议开展其他调查或标记为已完成
7. 迭代增强：根据发现的线索开展后续调查

---

📊 示例输出

  ╔═════════════════════════════════════════════════════════════════════════╗
  ║  ██   ██ ███████ ██████         ███████ ███████  ██ ███    ██ ████████  ║
  ║  ██   ██ ██      ██             ██   ██ ██       ██ ████   ██    ██     ║
  ║  ███████ ███████ ██      █████  ██   ██ ███████  ██ ██ ██  ██    ██     ║
  ║  ██   ██      ██ ██             ██   ██      ██  ██ ██  ██ ██    ██     ║
  ║  ██   ██ ███████ ██████         ███████ ███████  ██ ██   ████    ██     ║
  ╚═════════════════════════════════════════════════════════════════════════╝

      Hostile Command Suite - OSINT Package
      Intelligent Open Source Intelligence Investigation System

  Using AI Model: qwen3:8b
  Available Tools: sherlock, mosint, profile_scraper, duckduckgo_search, link_analyzer

  ──────────────────────────────────────────────────────────────────────────────

  ═══ COMPREHENSIVE TARGET INFORMATION ═══
  Provide ALL available information about your target for intelligent analysis
  Include: names, usernames, emails, addresses, organizations, social profiles, etc.

  Enter ALL target information: John Smith, @johnsmith123, [email protected], works at TechCorp

  Analyzing Provided Information
  ──────────────────────────────────────────────────────────────────────────────

   Extracted Target Intelligence 
  ┏━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
  ┃ Data Type      ┃ Extracted Values                                                  ┃
  ┡━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
  │ Names          │ John Smith                                                        │
  │ Usernames      │ johnsmith123                                                      │
  │ Emails         │ [email protected]                                           │
  │ Organizations  │ TechCorp                                                          │
  └────────────────┴───────────────────────────────────────────────────────────────────┘
  ────────────────────────────────────────────────────────────────

  Investigating Name: John Smith

   SHERLOCK Investigation Results 
  ┏━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓
  ┃ Metric         ┃ Value       ┃
  ┡━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩
  │ Target         │ cycloarcane │
  │ Accounts Found │ 17          │
  │ Status         │ Success     │
  └────────────────┴─────────────┘
  ────────────────────────────────────────────────────────────

  Found 17 profiles, scraping for additional intelligence...
  PROFILE_SCRAPER Investigation Results
  ┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┓
  ┃ Metric           ┃ Value   ┃
  ┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━┩
  │ Total Scraped    │ 5       │
  │ Successful       │ 4       │
  │ With Useful Info │ 4       │
  │ Status           │ Success │
  └──────────────────┴─────────┘
  ────────────────────────────────────────────────────────────

  AI Agent Analyzing...
  ╭─ AI Investigation Analysis ──────────────────────────────────────────────╮
  │ ANALYSIS: Investigation revealed GitHub profile with security research    │
  │ interests (LLMs + red team). High-value intelligence gathered from        │
  │ multiple platforms. Profile scraping provided sufficient context.        │
  │                                                                           │
  │ RECOMMENDATION: Investigation complete - sufficient intelligence gathered │
  │ TOOL: NONE                                                                │
  │ TARGET: N/A                                                               │
  │ REASONING: Profile analysis reveals technical expertise and security      │
  │ focus. No additional tools needed for current investigation scope.        │
  ╰───────────────────────────────────────────────────────────────────────────╯

---

🛡️ 安全与道德规范

负责任地使用

• 遵守法律：所有调查都必须遵守适用法律
• 获得授权：仅调查已获准研究的目标
• 速率限制：遵守平台的速率限制并实施延迟
• 本地处理：所有 AI 分析均通过 ollama 在本地完成（不使用云服务）

隐私与安全

• 不持久化数据：调查结果不会长期存储
• 本地大模型：AI 分析不会离开你的设备
• 工具隔离：每个 OSINT 工具独立运行
• 专业用途：专为防御性安全和合法研究而设计

---

🔧 配置

AI 模型选择

# Use different ollama models
python3 HCSO.py --model llama3.2 target
python3 HCSO.py --model qwen3:8b target
python3 HCSO.py --model mixtral target

可配置的提示词

可通过 YAML 文件配置 Agent 行为：

• prompts/agent_system.yaml：核心 Agent 指令和工具选择逻辑
• prompts/tool_prompts.yaml：特定工具的分析模板

工具功能

工具	输入	功能	自动触发
DuckDuckGo Search	姓名、组织	网络情报、新闻、公开记录	姓名时自动触发
Sherlock	用户名	搜索 400+ 个平台	用户名时自动触发
Mosint	电子邮件	泄露数据、域名情报	电子邮件时自动触发
Link Analyzer	URL	GitHub 个人资料、网络内容分析	URL 时自动触发
Profile Scraper	URL	简介、关注者、认证信息	Sherlock 之后

---

🚧 开发

添加新的 OSINT 工具

1. 在 mcp_tools/new_tool_server.py 中创建 MCP 服务
2. 在 MCPToolManager.check_available_tools() 中添加工具检测
3. 在 MCPToolManager.call_tool() 中实现工具调用
4. 在 display_investigation_result() 中添加结果显示
5. 更新 Agent 提示词中的工具选择逻辑

架构优势

之前的复杂架构：

• 使用 FastMCP 的 15+ 个微服务
• 需要 PostgreSQL 数据库
• Web UI 和 API 复杂
• 多层身份验证

当前的智能 Agent 架构：

• 一个配备 MCP 工具的智能 Agent
• 无需数据库
• 配备 AI 的纯终端界面
• 使用本地 ollama 进行决策
• 自动串联和切换工具

---

📈 路线图

第 1 阶段：核心情报 ✅

• 使用 AI 分析开展 Sherlock 用户名调查
• 使用 AI 分析开展 Mosint 电子邮件调查
• 智能抓取社交媒体个人资料
• 由 AI 驱动的调查决策
• 基于 MCP 的工具架构

第 2 阶段：增强分析 🚧

• 用于深入分析 GitHub/社交媒体的链接分析器
• 域名调查功能
• 集成电话号码 OSINT
• 对调查发现进行关联分析

第 3 阶段：高级情报 📋

• 调查会话管理
• 自定义工具集成框架
• 自动化调查工作流
• 高级 AI 推理和切换

---

🤝 贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/new-tool）
3. 按照现有模式添加 MCP 工具服务
4. 更新用于集成工具的 Agent 提示词
5. 使用各种目标类型进行测试
6. 提交拉取请求

开发环境设置

git clone https://github.com/cycloarcane/Hostile-Command-Suite.git
cd Hostile-Command-Suite
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 HCSO.py --interactive

---

📄 许可证

本项目采用 PolyForm Noncommercial License 1.0.0 许可，详情请参阅 LICENSE 文件。

版权所有 © cycloarcane（[email protected]）

---

智能。终端。高效。

借助 AI 驱动的决策开展高级 OSINT 调查

如有疑问或功能请求，请联系 [email protected]