Hostile‑Command‑Suite

Hostile Command Suite - OSINT Package

作成者: cycloarcane
連絡先: [email protected]
ライセンス: PolyForm Noncommercial License 1.0.0

インテリジェントなオープンソースインテリジェンス調査システム

AI を活用した分析とインテリジェントなエージェントの意思決定機能を備えた、ターミナルベースの OSINT 調査フレームワークです。プロファイルの自動スクレイピング、複数プラットフォームにわたるユーザー名の調査、ローカル 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 エージェント: ローカルの 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 エージェントは次の機能を提供します。

• 包括的なデータ抽出: LLM を使用して、提供された対象情報をすべて解析し、分類します
• インテリジェントなツール選択: データの種類に基づいて適切なツールを自動選択します。
  • 氏名 → 公開記録やニュースを DuckDuckGo でウェブ検索
  • ユーザー名 → Sherlock でソーシャルメディアプラットフォームを検索
  • メールアドレス → Mosint で漏えいデータとドメインを分析
  • 組織 → 企業情報をウェブ検索
  • URL → リンクアナライザーでコンテンツを詳細に分析
• 調査の方向転換: 新たな手がかりを見つけ、追加調査のアクションを提案
• セキュリティリスク評価: 情報の露出度とセキュリティへの影響を評価
• パターン認識: プラットフォームやデータソースをまたぐ関連性を特定
• 意思決定: 調査が完了したか、継続が必要かを判断

---

🏗️ アーキテクチャ

インテリジェントエージェントの設計

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   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 によるデータ抽出：LLM が情報を解析し、構造化されたデータ型に分類します
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 を介してローカルで実行されます（クラウドは使用しません）

プライバシーとセキュリティ

• データを永続化しない：調査結果は長期保存されません
• ローカル LLM：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 ファイルで設定できます：

• prompts/agent_system.yaml：エージェントの基本指示とツール選択ロジック
• 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. ツール選択ロジックに対応するよう、エージェントのプロンプトを更新します

アーキテクチャの利点

以前の複雑なアーキテクチャ：

• FastMCP を使用する 15 以上のマイクロサービス
• PostgreSQL データベースが必要
• ウェブ UI と API が複雑
• 複数の認証レイヤー

現在のインテリジェントなエージェントアーキテクチャ：

• MCP ツールを備えた単一のインテリジェントなエージェント
• データベース不要
• AI を備えた純粋なターミナルインターフェース
• 意思決定にローカルの ollama を使用
• ツールの自動連携とピボット

---

📈 ロードマップ

フェーズ 1：中核となるインテリジェンス ✅

• AI 分析を備えた Sherlock によるユーザー名調査
• AI 分析を備えた Mosint によるメール調査
• ソーシャルメディアからのインテリジェントなプロフィール収集
• AI を活用した調査の意思決定
• MCP ベースのツールアーキテクチャ

フェーズ 2：分析の強化 🚧

• GitHub／ソーシャルメディアの詳細分析に対応する Link Analyzer
• ドメイン調査機能
• 電話番号 OSINT の統合
• 調査結果の相関分析

フェーズ 3：高度なインテリジェンス 📋

• 調査セッション管理
• カスタムツール統合フレームワーク
• 調査ワークフローの自動化
• 高度な AI 推論とピボット

---

🤝 貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/new-tool）
3. 既存のパターンに従って MCP ツールサーバーを追加します
4. ツール統合のためにエージェントのプロンプトを更新します
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 ファイルをご覧ください。

Copyright © cycloarcane ([email protected])

---

インテリジェント。ターミナル。効果的。

AI を活用した意思決定による高度な OSINT 調査

質問や機能リクエストについては、[email protected] までお問い合わせください。