SOCMIntelligence

マルチプラットフォーム対応のSOCMINT / OSINT Webツール。
15のソースモジュール、クロスプラットフォームのアイデンティティグラフ、同一人物スコアリング、ケース管理、改ざん検知レポート — これらすべてを、単一コマンドで起動する1つのFastAPIアプリに統合。

概要

SOCMIntelligenceは、多くのプラットフォームから公開データを収集し、各結果をチャート、検出テーブル、関係グラフに変換し、すべてを単一のクロスプラットフォーム・アイデンティティグラフに統合します。同じアカウントにはどこでも同じノードIDが付与されるため、2つの異なるスキャンに現れたメールアドレス、ドメイン、ユーザー名は自動的にリンクされます — これにより、サービスをまたいで誰が誰であるかを把握できます。

モジュール

各モジュールは公開データのみを読み取ります（またはキーが提供された場合は公式API）。プライベートアカウントの認証情報/セッションのスクレイピングは行いません。

機能

• 関係グラフ — 成功したすべてのスキャンを統合するD3フォースグラフ。クロスプラットフォームの一致（共有メール、ドメイン、ユーザー名）、ピボット（ノードをダブルクリックして適切なモジュールでスキャン）、検索、タイプフィルター、PNG/JSONエクスポート。
• タイムライン — すべてのアカウントの投稿、コメント、アップロード、アカウント作成イベントを1つの軸に表示。さらに時間帯重複ヒートマップと時間類似度テーブル。
• アイデンティティマッチング — アカウントペアごとの0〜100の「同一人物か？」スコアとその理由（検証済み/暗号学的リンク、共有メール、ユーザー名と表示名の類似性、共有パーソナルドメイン、アバターpHash、活動時間）。40以上のペアがグラフに描画されます。
• 比較 — 同じモジュールのスキャン済みアカウントを2つ以上並べて表示（KPIテーブル＋棒グラフ、最高値をハイライト）。
• アナリストマーク — グラフノードを検証済み/疑わしい/却下としてマークし、メモを追加し、手動でノードとリンクを追加。すべてケースに保存されます。
• ケース管理 — ケースを作成し、アクティブ化すると、スキャン/マーク/メモが自動的に保存されます。.socmintパッケージのインポート/エクスポート。
• 変更追跡（モニタリング） — スケジュールに従ってターゲットを再スキャンし、変更点（フィールド、追加/削除されたリンク）を記録。
• 証拠の完全性 — 各スキャンの生データは収集時にハッシュ化（正規化JSONに対するSHA-256）。検証ボタンで改ざんの有無を証明。
• エクスポート — HTML / PDFレポート、Excel (.xlsx)、GraphML (Gephi/yEd)、GEXF (Gephi)、Maltego CSV、JSON。
• バイリンガルUI — トルコ語/英語の切り替え（デフォルトはトルコ語）。レポート、スプレッドシート、チャートラベル、日付と数値の形式はすべて選択した言語に従います。
• 設定ページ — APIキー、プロキシ / Tor / プロキシリストのローテーションとレート制限を、.envではなくUIから管理。

クイックスタート

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn server:app --host 0.0.0.0 --port 8000

次に**http://localhost:8000**を開きます — APIドキュメントはhttp://localhost:8000/docs。

次回以降の実行に必要なのは：

source .venv/bin/activate && uvicorn server:app --port 8000

Docker: docker compose up --build（単一サービス）。

設定

すべての設定は設定ページにあります（data/settings.jsonに保存。.envも引き続き読み込まれますが、設定が優先されます）：

• APIキー — サーバー側に保存され、ブラウザには返されません（「設定済み」＋末尾4文字のみ表示）。
  • YOUTUBE_API_KEY — YouTubeモジュールに必須。
  • X_BEARER_TOKEN — X (Twitter) API v2。これがない場合、Xモジュールは明確にラベル付けされたサンプルデータを表示するため、トークンを追加する前に出力をプレビューできます。
  • STEAM_API_KEY、STACKEXCHANGE_KEY、GRAVATAR_API_KEY、GITLAB_TOKEN — オプション。追加データを利用可能にします。
• プロキシ / Tor — オフ、Tor、単一のカスタムプロキシ、またはスキャンごとにラウンドロビンでローテーションするプロキシリスト（レート制限を分散）。
• レート — 並列スキャン数とリクエスト間の遅延。

注意事項

• X (Twitter): 無料のXプランは非常に制限されています — トークンがあっても、一部のプランでは投稿履歴が空で返ることがあります。モジュールはそのケースにラベルを付けます。
• Telegramは公開のt.me/s/プレビューのみを読み取ります（ログインなし）。
• GravatarはメールアドレスのMD5/SHA-256ハッシュのみを受け取り、メールアドレス自体は受け取りません。
• TikTokは頻繁にレート制限/ボットブロックを行います。モジュールはリトライし、実際の「見つかりません」と一時的なブロックを区別します。
• 時間分布はUTCです。TikTokフォロワーの「増加」は推定値（そのようにマークされています）であり、実際の履歴ではありません。
• backend/app/tools/youtube_osint.pyにはハードコードされたフォールバックAPIキーが同梱されています — 設定から自分のキーに置き換え、その行を削除してください。

ライセンス

Apache License 2.0 — LICENSEを参照。