Telegram Channel Parser: channels, chats, contacts → Excel — Python source code

Telegram Channel Parser: channels, chats, contacts → Excel — Python source code

Telegram channel parser: channels, chats, contacts → Excel — a ready-made Python tool for SMM specialists, media buyers and ad sellers. Finds channels by keywords, collects descriptions, subscribers, recent posts, computes engagement (ER) and extracts contact details: e-mail, phone, @username, social links. Output is a ready database in Excel/CSV for outreach.

Per-channel fields: @username and link, title, description, language, subscribers, post count and activity period, average views and forwards, ER %, contacts (e-mails, phones, social links), hashtags and keywords.

Features: keyword search across Telegram, parsing a channel list (inline or from file), database filters (with-contacts only, min/max subscribers, min ER %, language, topic — all combinable), Excel export with autofilter plus a summary sheet, CSV export (utf-8-sig), a --demo mode that runs without Telegram or an API key on a built-in 5-channel database, and socks5 proxy support.

Delivery (zip): tg_core.py (parsing/logic core), tg_cli.py (CLI + Telethon network layer), test_tg_core.py (all passing), demo fixtures, GUIDE.pdf (step-by-step: API key setup, running, filters, export), requirements.txt, README, LICENSE.

Requirements: Python 3.10+, a free Telegram API key (my.telegram.org/apps — 2 minutes, instructions in GUIDE.pdf). License: personal use. Instant zip delivery.

SEE ALSO:
• Telegram bot shop with auto-delivery of digital goods — plati.market/itm/6199050
• Wildberries + Ozon competitor parser: prices and stock in Excel — plati.market/itm/6155438
• WordPress sites database parser: e-mails and contacts for outreach — plati.market/itm/6190848