🕷️ TGSpyder

TGSpyderは、Darksight AnalyticsによるオープンソースのTelegram OSINT CLIツールです。

特徴

• 公開グループと非公開グループの両方からメンバーリストをCSVにスクレイピング
• 公開グループと非公開グループの両方からチャットメッセージをCSVにスクレイピング
• チャット履歴からt.me招待リンクを抽出（公開・非公開グループ）
• ユーザー名または（限定的な）数値IDでTelegramユーザーを検索
• ステッカーパックの作成者IDを特定（ステッカーセットIDから推測） クレジット: https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
• プロキシサポート:
  • プロキシを保存 (--set-proxy)
  • プロキシを削除 (--remove-proxy)
  • 一回限りのプロキシ上書き (--proxy)

必要条件

• Python 3.10+

インストール

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder
pip install -r requirements.txt
pip install -e .

🕷️ はじめに

Telegram OSINT CLIツール 調査者、アナリスト、ジャーナリスト、研究者向けに作られています。

TGSpyderは、Telegramデータの構造化された収集と分析のためのコマンドラインOSINTツールです。 公開・非公開のTelegramグループやチャンネルからメンバー、メッセージ、招待リンク、ユーザー、メタデータをスクレイピングし、すべてを調査者に優しいCSVファイルにエクスポートします。

特徴

• 📋 メンバーリストをスクレイピング（Telegramが許可する場合）
• 💬 チャットメッセージをクロール
• 🔗 Telegram招待リンクを抽出し重複排除
• 🧍 IDまたはユーザー名でユーザーを検索
• 🎭 ステッカーパック作成者を特定
• 🌐 SOCKSプロキシサポート（Tor / VPN）
• 📁 OSINTワークフロー向けのクリーンなCSV出力
• 📦 出力構造

すべての収集データは単一のランタイムフォルダに保存されます：

TGSpyder Output/
├── members/
│   └── members_<target>_<timestamp>.csv
├── chats/
│   └── messages_<target>_<timestamp>.csv
└── crawled_links/
    └── crawled_links_<target>_<timestamp>.csv

🚀 クイックスタート

1️⃣ リポジトリをクローン

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder

2️⃣ 仮想環境を作成して有効化

python3 -m venv venv
source venv/bin/activate

3️⃣ 依存関係をインストール

pip install -r requirements.txt

4️⃣ TGSpyderをCLIとしてインストール

pip install -e .

インストールの確認:

tgspyder --help

🔑 Telegram API認証情報

• **https://my.telegram.org**にアクセスし、Telegramアカウントでログインします。
• API開発ツールに移動し、TGSpyderをTelegramで認証するために必要なAPI IDとAPI Hashを生成します。

🧭 基本的な使い方

メンバーとチャットをスクレイピング

tgspyder https://t.me/examplegroup --members --chats

招待リンクのみを抽出

tgspyder https://t.me/examplegroup --crawl-invites

ユーザー検索

tgspyder --user 123456789
tgspyder --user @username

ステッカーパック作成者検索

tgspyder --sticker-pack https://t.me/addstickers/packname

🌐 プロキシサポート

TGSpyderはSOCKSプロキシをサポートします（Tor / VPN対応）。

一回限りのプロキシ

tgspyder --proxy socks5://127.0.0.1:9050 <target> --chats

プロキシを将来の実行のために保存

tgspyder --set-proxy socks5://127.0.0.1:9050

保存されたプロキシを削除

tgspyder --remove-proxy

🔐 認証と設定

初回実行時に、TGSpyderが次の入力を求めます：

• Telegram API ID
• Telegram API Hash
• ユーザーアカウントまたはボットトークン

認証情報はローカルに保存されます： ~/.tgspyder.conf

セッションファイルは自動的に再利用されます。

⚠️ 制限事項

• 一部のグループはメンバーリストを公開していない
• 非公開グループには有効な招待リンクが必要
• ステッカー作成者の帰属は常に保証されるわけではない
• Telegram APIの制限に従う

🧪 倫理的使用とOSINT免責事項

TGSpyderは以下の目的で使用されます：

• OSINT調査
• 学術研究
• ジャーナリズム
• 脅威・ネットワーク分析

ユーザーは以下の遵守に責任があります：

• 現地の法律
• プラットフォームの利用規約
• 倫理的な研究基準

📄 ライセンス

MITライセンス 詳細はLICENSEを参照してください。

🚀 デモ

👤 作者

• Valdemar Balle
• Darksight Analytics創業者

⚖️ 免責事項

TGSpyderはオープンソースインテリジェンス（OSINT）、研究、調査、教育目的のみで提供されます。

ユーザーは、このツールの使用が以下を遵守することを保証する単独の責任を負います：

• 適用される法律と規制
• プラットフォームの利用規約
• 倫理的な研究および調査基準

作者および貢献者は、このツールの誤用またはその使用から生じるいかなる結果に対しても責任を負いません。