Phishunt

phishunt-mcp

phishunt.io 用の Model Context Protocol（MCP）サーバーです。

公開されているフィッシングドメインのフィードを MCP ツールとして公開し、AI エージェントが不審なドメインを検索したり、標的ブランド別にフィッシングを一覧表示したり、検出差分を同期したりできます。

• エンドポイント：https://mcp.phishunt.io/（HTTP JSON-RPC 2.0、POST）
• プロトコルバージョン：2025-11-25
• 認証：不要（データは CC0）
• ライセンス（データ）：CC0-1.0 · ライセンス（コード）：MIT

ツール

名前	目的
check_domain	このホスト（または最大 20 件のリスト）が有効な phishunt フィードに含まれているかを確認します。完全一致で照合し、見つからない場合はアーカイブを確認します。PREVIOUSLY DETECTED は、アーカイブ内のレコードの判定が medium、high、critical の場合にのみ表示されます。low/noise のアーカイブレコードは低シグナル候補として報告され、有効な DNS ではないホストは上流エラーの代わりにその旨が報告されます。
list_brand_phishings	ブランド（例：microsoft）を標的とする有効なフィッシングを一覧表示します。
get_recent_detections	差分同期：ISO 日付以降の検出を取得します。
get_brand_metadata	ブランドの厳選されたメタデータ（表示名、カテゴリ、AI による特徴づけ、有効件数）を取得します。
get_cert_metadata	悪用された TLS 中間 CA の事実に基づくメタデータ（運営者、ルート、鍵の種類、同系列の CA）を取得します。
search_phishings	有効なフィッシング URL／ドメイン／IP を全文検索します（最小 3 文字）。
analyze_url	あらゆる URL／ドメインを受動的にフィッシングシグナル分析します。単一の判定済みverdict（phishing / likely_phishing / suspicious / no_evidence / not_assessed）と、その横に調整済みのprobabilityブロック（API の約 1.3％のベースレートにおける悪意ある確率、相対リスク、80％区間、クラスごとの証拠）を返します。URL のみを使った推定値は意図的に低く保たれるため、確率が低くても安全の証明にはなりません。また、裏付けとなる証拠（URL 形状のヒューリスティクス、既知の場合は保存済みスコア／判定、外部フィードとの相互参照、過去の検出）も返します。不明な不審ドメインは、完全分析のため自動的にキューに追加されます。
analyze_url_deep	URL をアクティブに詳細分析します（SOCKS5 で分離された環境から対象に接続し、HTTP + TLS 証明書 + RDAP + NS + GeoIP を確認します）。レンダリングレーンが空いている場合は、同じプロキシ経由でヘッドレスブラウザーを使ってページをレンダリングします。5 層すべてのエンジンで再スコアリングし、coverage（active_rendered / active_no_render）、render.status、probabilityブロックを返します。処理は低速（通常 15～45 秒、最大約 50 秒）で、トークンが必要なうえ、レート制限（共有の日次上限 50 件、同時実行は 1 件）があります。この Worker に DEEP_TOKEN が設定されている必要があります。analyze_urlで判断できない場合にのみ使用してください。
get_related_infrastructure	既知のインジケーターに関連するインフラ／コンテンツの重複（共有 IP、証明書、ネームサーバー、ファビコンなど）を特定し、関連する可能性のあるキャンペーン／疑わしいクラスターを表示します。
get_campaigns	可能性のあるキャンペーン／疑わしいクラスター（共有インフラに基づくグループ）を一覧表示します。ブランドまたは有効なもののみで絞り込むこともできます。
get_campaign	1 件の可能性のあるキャンペーン／疑わしいクラスターの詳細を表示します。証拠の内訳、すべてのメンバーインジケーター、エクスポート用リンクが含まれます。

Claude Desktop / Claude.ai / その他の MCP クライアントでの使用

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "phishunt": {
      "url": "https://mcp.phishunt.io/"
    }
  }
}

クイックテスト

curl -sX POST https://mcp.phishunt.io/ \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' | jq .

シークレット

analyze_url_deepには、Worker シークレットDEEP_TOKEN（バックエンドの X-Phishunt-Deep-Token）が必要です。設定しなくても、このツールは tools/listには表示されますが、tools/callでは正常に失敗し、バックエンドには到達しません。

wrangler secret put DEEP_TOKEN

開発

npm install
npm run dev          # wrangler dev on http://localhost:8787
MCP_URL=http://localhost:8787 npm test

デプロイ

npm run deploy       # wrangler deploy
MCP_URL=https://mcp.phishunt.io npm test
# after the phishunt-backend release that adds `probability` and `history.apex_candidates_seen`:
REQUIRE_PROBABILITY=1 MCP_URL=https://mcp.phishunt.io npm test

REQUIRE_PROBABILITY=1を指定しない場合、バックエンドのフィールドが存在しないか、probability.statusがunavailableである間、ライブのprobability／historyに関するアサーションは SKIPPED として報告されます。指定した場合は失敗になります。