Telegram Phone Number Checker: автоматизируем поиск аккаунтов в Telegram

Представьте ситуацию: у вас есть список телефонных номеров и нужно быстро проверить, какие из них зарегистрированы в Telegram. Вручную это делать долго и неэффективно. Именно для таких задач команда Bellingcat (известная своими расследованиями с открытыми источниками) создала удобный Python-инструмент.

Что умеет этот инструмент?

Telegram Phone Number Checker — это консольная утилита, которая по номеру телефона определяет:

Зарегистрирован ли он в Telegram
Какие данные профиля доступны (имя, username, ID)
Можно ли скачать аватарку пользователя

Интересно, что инструмент работает через официальное Telegram API, а значит дает актуальные данные в отличие от различных парсеров.

Кому это пригодится?

Журналистам-расследователям — для верификации контактов
Командам безопасности — при анализе потенциальных угроз
Разработчикам — как основа для своих сервисов проверки
Исследователям — при работе с открытыми источниками

Проект на GitHub собрал уже более 1400 звезд, что говорит о его востребованности.

Как это работает технически?

Под капотом используются:

Python 3.8+
Библиотека Telethon для работы с Telegram API
Система конфигурации через .env файл

Для работы потребуются:

Аккаунт Telegram с номером телефона
API_ID и API_HASH (получаются на my.telegram.org)

Основные возможности

1. Проверка одного или нескольких номеров

telegram-phone-number-checker --phone-numbers +1234567890

Или сразу несколько:

telegram-phone-number-checker --phone-numbers +1234567890,+9876543210

2. Скачивание аватарок

Добавьте флаг --download-profile-photos и аватарки сохранятся локально.

3. Разные форматы вывода

Результаты выводятся в консоль и сохраняются в JSON-файл (по умолчанию results.json). Файл можно переименовать через параметр --output.

4. Гибкие настройки

API-ключи можно передавать:

Через .env файл
Параметрами командной строки
В интерактивном режиме

Какие ответы можно получить?

Полные данные (username, имя, ID) — если пользователь не скрывает номер
"no username detected" — есть аккаунт, но без username
Ошибка — если номера нет в Telegram или доступ ограничен

Практические кейсы использования

Верификация списка контактов — быстро отфильтровать активные Telegram-аккаунты
Исследование цифровых следов — связь между номером и профилем
Автоматизация процессов — интеграция в свои скрипты

Как установить?

Через pip:

pip install telegram-phone-number-checker

Или из исходников:

git clone https://github.com/bellingcat/telegram-phone-number-checker
cd telegram-phone-number-checker
pip install -r requirements.txt

Меры предосторожности

Разработчики предупреждают:

Не используйте личный аккаунт для автоматизации — Telegram может его заблокировать
Лучше создать новый аккаунт
Избегайте известных VPN-IP (используйте резидентные IP)

Вывод: стоит ли пробовать?

Если вам нужно:

Автоматизировать проверку номеров в Telegram
Интегрировать такую проверку в свои проекты
Проводить исследования на основе открытых данных

— то этот инструмент будет отличным решением. Он прост в установке, имеет понятный интерфейс и действительно экономит время.

Для разработчиков проект интересен еще и тем, что его можно использовать как основу для более сложных решений, модифицируя под свои задачи.

Перейти к проекту на GitHub