TGSherlock

ローカル Web パネルで実現する Telegram OSINT：リアルタイム監視、アラート、ユーザー追跡、キーワードスイープ。

インストール

pipx install tgsherlock

GitHub から最新版を取得：pipx install git+https://github.com/emrekybs/tgsherlock.git（その後 tgsherlock が見つからない場合は、pipx ensurepath を実行して新しいターミナルを開いてください）。

実行

tgsherlock

パネルがブラウザで http://127.0.0.1:8765 に開きます。Linux では、初回実行時にアプリケーションメニューに TGSherlock が追加されるため、クリックで起動できます。

初回実行時： my.telegram.org でアプリを作成し（API development tools）、API ID と API Hash を入力してから、Telegram で QR コードをスキャンします（設定 → デバイス → デスクトップデバイスをリンク）。電話番号でのログインも可能です。

機能

• ライブモニター：指定したユーザー、グループ、チャンネルからのメッセージをリアルタイムで表示。メディアのダウンロードも任意で可能。
• アラート：ユーザー、グループ、またはすべてのチャットを監視し、任意のメッセージ、キーワード、正規表現、メディア、インジケーターを検知。アプリ内、デスクトップ、メール（SMTP）、Webhook で通知。ダイジェストのスロットリングにも対応。
• ユーザープロフィール：プロフィール、ユーザー名、フラグ、共通グループ、グループごとの初回・最終確認日時、時間別アクティビティ、日付付きメッセージタイムライン。
• 検索：ユーザー、グループ、チャンネルをプロフィール写真付きで表示。
• グループ履歴 · キーワードスイープ · ユーザートラッカー：進捗表示と FloodWait の自動処理を備えたバックグラウンドジョブ。
• エンティティ：メールアドレス、電話番号、URL、IP、暗号資産ウォレット、招待リンク、ハッシュタグを自動抽出。
• アーカイブとエクスポート：収集したすべてのデータをフィルタリングし、CSV、JSON、または HTML レポートとしてエクスポート。
• 複数アカウント：サイドバーから追加、切り替え、サインアウトが可能。

アップデート：pipx upgrade tgsherlock

オプション：--port 8790、--no-browser、--install-desktop、--uninstall-desktop。 データはローカルに保存されます：~/.config/tgsherlock（設定、セッション）および ~/.local/share/tgsherlock（データベース、メディア）。

責任ある利用

防御的な OSINT と脅威インテリジェンスのために構築されています。TGSherlock は、あなた自身の Telegram アカウントが見ることのできる情報のみを扱います。現地の法律および Telegram の利用規約を遵守してください。

ライセンス

MIT