🎯 Telegram Parser групп со скрытыми участниками by TG Syndicate 🎯

Telegram Parser — удобное настольное приложение с GUI (Tkinter) для сбора авторов сообщений из Telegram-групп и каналов. Идеально подходит для исследований, аналитики, подготовки рассылок (с соблюдением законов и правил) и работы с аудиторией. Простой интерфейс, гибкие фильтры и экспорт в .txt. 🚀

✨ Основные возможности (функционал)

• 🚀 Авторизация через Telegram — поддержка кода подтверждения и 2FA (пароля).

• 🎯 Парсинг по двум режимам:

  • По периоду (последние N дней).

  • По количеству сообщений (диапазон сообщений).

• 🎛️ Набор фильтров:

  • Удаление дубликатов.

  • Исключение ботов.

  • Только с @username.

  • Только premium-пользователи.

  • Только с аватаром.

  • Исключить кириллицу в имени.

  • Фильтр по запрещённым словам (через список).

  • Фильтр по активности (1 день, 3 дня, неделя, 2 недели, месяц).

• 📁 Экспорт — файл GroupTitle_users_YYYYMMDD_HHMMSS.txt, опция сохранять с @.

• 🧾 Логирование — журнал действий в UI.

• 🖼️ Современный UI — тёмная тема, удобные карточки, интуитивные настройки.

• ♻️ Сохранение настроек — все поля сохраняются в parser_settings.json.

⚠️ Важное (ответственное использование)

• Используйте инструмент только в рамках закона и правил Telegram.

• Не собирайте или не используйте личные данные для спама, мошенничества или любых противозаконных действий.

• Авторы и продавец не несут ответственности за незаконное использование софта.

🛠️ Подробная инструкция по установке и запуску (Windows)

1) Скачивание и установка Python

1. Перейдите на официальный сайт: https://www.python.org/downloads/

2. Скачайте Python 3.10/3.11 для Windows (Windows installer — 64-bit).

3. ВАЖНО: при установке обязательно поставьте галочку Add Python to PATH.

4. Нажмите «Install Now» и дождитесь завершения установки.

2) Подготовка папки проекта

1. Создайте папку, например C:\Tools\telegram-parser и поместите туда весь код (файл main.py или telegram_parser.py).

2. pip install telethon

3) Получение API ID и API HASH (обязательно для работы)

1. Перейдите на https://my.telegram.org и авторизуйтесь под своим номером.

2. Перейдите в «API development tools» → создайте приложение → получите api_id и api_hash.

3. Введите их в GUI в разделе API Credentials.

4) Запуск приложения

(Если ваш файл называется иначе — замените main.py на имя файла.)

GUI откроется автоматически.

5) Первичная авторизация

1. Введите API ID, API HASH и Номер телефона (в международном формате, например +7925xxxxxxx).

2. Нажмите Авторизоваться.

3. Введите код подтверждения, который придёт в Telegram.

4. Если включена двухфакторная аутентификация — введите пароль 2FA.

После успешной авторизации кнопка Начать парсинг станет активна.

6) Пример использования парсера

• Вставьте ссылку на группу (например https://t.me/example_group или @example_group).

• Выберите метод: За период → укажите N дней; или По количеству → укажите диапазон сообщений.

• Настройте фильтры (удалять дубликаты, исключить ботов, только с @username и т.д.).

• Нажмите Начать парсинг.

• После завершения в папке появится файл GroupTitle_users_YYYYMMDD_HHMMSS.txt.

❓ FAQ — Частые вопросы

Q: Где взять api_id и api_hash?
A: На https://my.telegram.org → API development tools.

Q: Требуется ли платить за Telethon / Python?
A: Нет. Python и Telethon — бесплатны.

Q: Можно ли парсить приватные чаты?
A: Нет, только те группы/каналы, к которым у вашей учётной записи есть доступ. Не используйте аккаунты без согласия владельца.

Q: Что делать, если не открывается GUI?
A: Проверьте, правильно ли установлен Python, активировано ли виртуальное окружение и установлены зависимости. Запустите из консоли и посмотрите ошибки.

Q: Что такое файл сессии telegram_session.session?
A: Это локальный файл Telethon, содержащий авторизационные данные. Он позволяет не вводить код каждый раз. Храните его безопасно.

Q: Почему некоторые пользователи не отображаются?
A: Некоторые сообщения могут быть от ботов, либо данные недоступны (удалённые аккаунты, приватный профиль). Фильтры также могут исключать пользователей.

Q: Как отключить сохранение с @?
A: В настройке «Сохранять с @» снимите галочку — будет сохраняться только username без @.