SOCMIntelligence

マルチプラットフォーム対応のSOCMINT / OSINT Webツール。

---

概要

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

モジュール

グループ	モジュール
ソーシャルネットワーク	X (Twitter) · Instagram · Bluesky · LinkedIn · YouTube · TikTok · Twitch · Kick · Snapchat · Reddit · Mastodon · Telegram · Discord · Steam
開発者向け	GitHub · GitLab · Stack Exchange · Hacker News
身元・アーカイブ	Keybase · Gravatar · Wayback Machine
検索・マップ	キーワード検索 (Bluesky · Reddit · Mastodon) · ハッシュタグマップ

各モジュールは公開データのみを読み取ります（キーが提供されている場合は公式 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 からすべて管理できます。

インストール

pipx（Linux で推奨）

pipx install socmintelligence
socmintelligence

または virtualenv 内で pip を使用する場合:

pip install socmintelligence
socmintelligence

次に http://localhost:8000 を開きます。オプション: socmintelligence --host 0.0.0.0 --port 8000 --data-dir ~/socmint-data --no-browser。 データ（ケース、設定）は、--data-dir または SOCMINT_DATA_DIR が設定されていない限り、~/.local/share/socmintelligence に保存されます。

GitHub から直接: pipx install git+https://github.com/emrekybs/SOCMIntelligence

クイックスタート（ソースから）

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モジュールに必須です。
  • HIKERAPI_TOKEN — Instagram（HikerAPI）。これがない場合、Instagramモジュールは明確にラベル付けされたサンプルデータを表示します。
  • 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のフォロワー「増加」は推定値（その旨明記）であり、実際の履歴ではありません。

ライセンス

Apache License 2.0 — LICENSE を参照してください。