🕵️‍♂️ TeleStalker

🇺🇸 English README

📌 Описание

TeleStalker — это инструмент автоматического сбора данных из открытых источников (OSINT) в Telegram. Программа рекурсивно парсит указанный канал и его дочерние чаты (связанные группы/комментарии), чтобы:

• Находить пользователей;
• Искать комментарии заданных юзеров за всё время;
• Раскрывать (если возможно) конфиденциальную информацию, такую как номер телефона.

⚠️ Программа предназначена только для образовательных и исследовательских целей. Автор не несёт ответственности за её неправомерное использование.

---

🚀 Установка

🐧 Linux

git clone https://github.com/CacucoH/teleStalker.git
cd teleStalker
chmod +x install.sh
./install.sh

🪟 Windows

.exe версия в разработке, так что пока можно запускать из исходников:

git clone https://github.com/CacucoH/teleStalker.git
cd teleStalker
pip3 install -r requirements.txt

⚙️ Конфигурация

Перед запуском необходимо указать свои Telegram API-ключи:

1. Перейдите на https://my.telegram.org
2. Авторизуйтесь и создайте приложение
3. Скопируйте api_id и api_hash
4. Укажите их в файле example.env, который находится в папке ./config/:

API_ID=your_api_id
API_HASH=your_api_hash
name = your_app_name

5. Далее переименуйте example.env в .env

🚨 Без этого программа работать не будет.

🛠️ Использование

python3 main.py -c <канал> [опции]

Аргументы:

Аргумент	Описание
-c, --channel	Обязательный. Целевой канал (ID или username без @)
-u, --users	Имена или ID юзеров для поиска комментариев (через пробел)
-r, --recursion-depth	Глубина рекурсии поиска (по умолчанию: 1). Оптимально: 2-3 для обнаружения дочерних каналов
-e, --exclude	Исключить юзеров по username (через пробел, без @)

⛔ Ограничения Telegram API

Telegram API разрешает только 200 запросов в сутки.

• Программа оптимизирована для минимального количества запросов.
• Если вы увидите ошибку вида:

A wait of 82696 seconds is required (caused by ResolveUsernameRequest)

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

Important

⚠️ Попытки обойти это ограничение или запускать скрипт во время блокировки API могут привести к блокировке вашего аккаунта. Вы действуете на свой страх и риск.