🕵️‍♂️ TeleStalker

🇺🇸 English README

📌 Описание

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

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

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

---

ВНИМАНИЕ

Для пользователей из России, для корректной работы программы может потребоваться VPN (Скажем спасибо нашему заботливому ... 😌😌)

P.S

Если что-то пошло не так с авторизацией, и код не приходит/qr перестал появляться, удалите содержимое папки session/. После этого запустите программу еще раз

Установка

Linux

git clone https://github.com/CacucoH/teleStalker.git
cd teleStalker
poetry install

Windows

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

git clone https://github.com/CacucoH/teleStalker.git
cd teleStalker
poetry install

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

Перед запуском необходимо указать свои 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

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

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

poetry run python3 src/telestalker/main.py -c <канал> [опции]

Аргументы:

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

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

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

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

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

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

Important

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