🕷️ TGSpyder

TGSpyder — это CLI-инструмент OSINT для Telegram с открытым исходным кодом от Darksight Analytics.

Возможности

• Сбор списка участников из публичных и приватных групп в CSV
• Сбор сообщений чата из публичных и приватных групп в CSV
• Извлечение invite-ссылок t.me из истории чата (публичные и приватные группы)
• Поиск пользователя Telegram по имени пользователя или (ограниченному) числовому ID
• Определение ID создателя стикерпака (выводится через ID набора стикеров) Благодарность: https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonimize-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 .

🕷️ Введение

CLI-инструмент OSINT для Telegram Создан для следователей, аналитиков, журналистов и исследователей.

TGSpyder — это командный OSINT-инструмент для структурированного сбора и анализа данных Telegram. Он позволяет собирать участников, сообщения, invite-ссылки, пользователей и метаданные из публичных и приватных групп и каналов Telegram — экспортируя всё в удобные для исследователя CSV-файлы.

Возможности

• 📋 Сбор списков участников (где Telegram это позволяет)
• 💬 Обход сообщений чата
• 🔗 Извлечение и дедупликация invite-ссылок Telegram
• 🧍 Поиск пользователей по ID или имени пользователя
• 🎭 Определение создателей стикерпаков
• 🌐 Поддержка SOCKS-прокси (Tor / VPN)
• 📁 Чистый CSV-вывод для OSINT-процессов
• 📦 Структура вывода

Все собранные данные сохраняются в единой рабочей папке:

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 development tools, чтобы получить API ID и API Hash, необходимые для аутентификации TGSpyder в Telegram.

🧭 Базовое использование

Сбор участников и чатов

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

Извлечение только invite-ссылок

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

Файлы сессий переиспользуются автоматически.

⚠️ Ограничения

• Некоторые группы не раскрывают списки участников
• Приватные группы требуют действительных invite-ссылок
• Атрибуция создателя стикеров не всегда гарантирована
• Действуют лимиты Telegram API

🧪 Этичное использование и отказ от ответственности OSINT

TGSpyder предназначен для:

• OSINT-расследований
• Академических исследований
• Журналистики
• Анализа угроз и сетей

Пользователи несут ответственность за соблюдение:

• Местных законов
• Условий использования платформы
• Этических стандартов исследований

📄 Лицензия

Лицензия MIT Подробности см. в LICENSE.

🚀 Демо

👤 Автор

• Valdemar Balle
• Основатель Darksight Analytics

⚖️ Отказ от ответственности

TGSpyder предоставляется исключительно для целей OSINT (разведка по открытым источникам), исследований, расследований и образования.

Пользователи несут единоличную ответственность за то, чтобы их использование этого инструмента соответствовало:

• Применимым законам и нормативным актам
• Условиям использования платформы
• Этическим стандартам исследований и расследований

Автор и участники не несут ответственности за неправомерное использование этого инструмента или любые последствия, возникающие в результате его использования.