Skip to content

root-cppdev/Telegram-Group-Tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Telegram Group Tool

Универсальный инструмент для анализа Telegram-групп на Python (Telethon).

Возможности

  • Выгрузка участников группы
  • Поиск общих участников между двумя группами
  • Проверка списка пользователей на наличие в целевой группе
  • Экспорт в TXT, CSV, Excel (xlsx)
  • Фильтрация по username, вывод только id
  • Лимит на количество участников

Быстрый старт

  1. Скопируйте .env.example в .env и укажите свои API_ID и API_HASH:

    API_ID=your_api_id
    API_HASH=your_api_hash
    
  2. Установите зависимости:

    pip install -r requirements.txt
    
  3. Запустите скрипт с нужными параметрами:

    Выгрузить участников группы:

    python tg_group_tool.py --mode parse --group "НазваниеГруппы"
    

    Найти общих участников между двумя группами:

    python tg_group_tool.py --mode common --group1 "Группа1" --group2 "Группа2"
    

    Проверить список id на наличие в группе:

    python tg_group_tool.py --mode check --group "НазваниеГруппы" --users users.txt
    

Аргументы командной строки

  • --mode (parse, common, check) — режим работы
  • --group, --group1, --group2 — названия групп
  • --users — файл со списком user_id (по одному на строку)
  • --out — форматы вывода (txt, csv, xlsx), по умолчанию все
  • --limit — ограничить количество участников
  • --only-username — только пользователи с username
  • --only-id — выводить только id
  • --delay — задержка между запросами (сек)
  • --concurrent — параллельных запросов (для поиска общих)

Примеры

  • Только id в Excel:
    python tg_group_tool.py --mode parse --group "НазваниеГруппы" --out xlsx --only-id
    
  • Общие участники, только с username, максимум 100, экспорт в csv:
    python tg_group_tool.py --mode common --group1 "Группа1" --group2 "Группа2" --only-username --limit 100 --out csv
    

Безопасность

  • Никогда не публикуйте свой .env и .session файлы!
  • Для публикации используйте .env.example.

Лицензия

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages