┌─────────────┐     ┌──────────────┐     ┌───────────┐
│  React SPA  │────▶│  FastAPI      │────▶│  MongoDB  │
│  (Vite)     │ WS  │  Backend      │     │           │
└─────────────┘     └──────┬───────┘     └───────────┘
                           │
              ┌────────────┼────────────┐
              ▼            ▼            ▼
        ┌──────────┐ ┌──────────┐ ┌──────────┐
        │  Shodan  │ │  Nuclei  │ │  Redis   │
        │  API     │ │  Scanner │ │  Streams │
        └──────────┘ └──────────┘ └──────────┘

# クローン
git clone [email protected]:BishopFox/aimap.git
cd aimap

# 設定
cp .env.example .env
# .env を編集 — 最低でも SHODAN_API_KEY を設定

# 起動
docker compose up --build

# バックエンド
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

# フロントエンド (別のターミナル)
cd frontend
npm install
npm run dev   # http://localhost:5173 で起動

# Required
SHODAN_API_KEY=your_shodan_api_key

# Optional — Censys as an additional discovery source
CENSYS_API_ID=
CENSYS_API_SECRET=

# Optional — enables AI-powered attack analysis
ANTHROPIC_API_KEY=

# MongoDB (defaults work for local dev)
MONGODB_URI=mongodb://localhost:27017
MONGODB_DB=aimap

# Redis (defaults work for local dev; optional)
REDIS_URL=redis://localhost:6379/0

# CORS (default allows all origins)
CORS_ORIGINS=*

# Modal serverless (dispatches scans/attacks to Modal containers)
MODAL_ENABLED=false

# Clerk auth — see below
CLERK_ISSUER=

protocol:mcp                          # MCPサーバー
auth:none                             # 認証なし
risk:critical                         # リスクスコア >= 9.0
risk:high                             # リスクスコア 7.0 – 8.9
risk:medium                           # リスクスコア 4.0 – 6.9
risk:low                              # リスクスコア 1.0 – 3.9
tool:query_db                         # 特定のツールを公開しているエンドポイント
country:US                            # 国コードで検索
port:11434                            # ポート番号で検索
org:"Amazon AWS"                      # ホスティング組織で検索（複数語は引用符で囲む）
has:system_prompt                     # システムプロンプトが漏洩しているエンドポイント

protocol:mcp auth:none country:US     # 米国の認証なしMCPサーバー
risk:critical tool:exec_code          # コード実行ツールがあるクリティカルエンドポイント
protocol:ollama port:11434            # デフォルトポートのOllama

aimap/
├── backend/
│   ├── app/
│   │   ├── main.py                  # FastAPIアプリ、ライフスパン、CORS、ルーター
│   │   ├── config.py                # 環境変数からのPydantic設定
│   │   ├── auth.py                  # Clerk JWT検証（CLERK_ISSUERが空の場合はバイパス）
│   │   ├── database.py              # 非同期MongoDB (Motor) 接続
│   │   ├── limiter.py               # SlowAPIレート制限
│   │   ├── routes/
│   │   │   ├── endpoints.py         # CRUD + 検索 + 地球儀 + エンリッチメント
│   │   │   ├── scans.py             # スキャンライフサイクル + 実行 + WebSocket
│   │   │   └── attack.py            # 攻撃ディスパッチ + Redisストリーム + WebSocket
│   │   ├── discovery/
│   │   │   ├── orchestrator.py      # スキャンパイプライン: Shodan → httpx → Nuclei → 取り込み
│   │   │   ├── shodan_adapter.py    # 32の厳選されたShodanクエリ + 結果の正規化
│   │   │   ├── nuclei_runner.py     # Nucleiサブプロセスランナー + 結果パーサー
│   │   │   └── base.py              # SourceAdapter抽象基底
│   │   └── services/
│   │       ├── attack_mcp.py        # MCPプロトコル攻撃エンジン
│   │       ├── attack_ollama.py     # Ollama攻撃エンジン
│   │       ├── attack_openclaw.py   # OpenClaw/Clawdbot攻撃エンジン
│   │       ├── enrichment.py        # Shodan/Nucleiエンリッチメント + リスクスコアリング
│   │       ├── live_probe.py        # モデル/ツール列挙のためのHTTPプローブ
│   │       ├── search.py            # Shodanスタイルクエリパーサー → MongoDBフィルター
│   │       ├── redis_client.py      # フォールバック付き非同期Redisシングルトン
│   │       └── concurrency.py       # セマフォ + Redisベースのスロット制限
│   ├── Dockerfile
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── App.tsx                  # ルート + Clerk認証ラッパー
│   │   ├── pages/
│   │   │   ├── Marketing.tsx        # 3D地球儀付き公開ランディングページ
│   │   │   ├── Landing.tsx          # 地球儀付き認証済みダッシュボード
│   │   │   ├── Search.tsx           # クエリ構文を使用したエンドポイント検索
│   │   │   ├── Explore.tsx          # すべてのエンドポイントのブラウズ/フィルター
│   │   │   ├── AgentDetail.tsx      # 単一エンドポイントの詳細
│   │   │   ├── TestAgent.tsx        # 攻撃テストランチャー
│   │   │   ├── Scans.tsx            # スキャン管理
│   │   │   └── Ranges.tsx           # CIDR範囲管理
│   │   ├── components/
│   │   │   ├── GlobeVisualization.tsx  # globe.gl 3D地球儀 + 凡例
│   │   │   ├── Layout.tsx           # アプリシェル（サイドバー + ナビバー）
│   │   │   └── ui/                  # shadcn/uiコンポーネント
│   │   ├── hooks/useApi.ts          # すべてのAPIエンドポイント用SWRフック
│   │   └── lib/api-client.ts        # Clerkトークン注入付きFetchラッパー
│   ├── Dockerfile
│   ├── nginx.conf
│   └── tailwind.config.js
├── templates/                       # Nuclei YAMLテンプレート
├── docs/                            # GitHub Pages静的サイト
├── docker-compose.yml
├── .env.example
└── README.md

MODAL_ENABLED=true