Skip to content

Latest commit

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

🛰️ TeleScanBot

TeleScanBot is a Telegram monitoring bot that scans all your group chats (using your user account) for specific keywords and sends real-time alerts to you through a personal bot.

Perfect for tracking job offers, promotions, sales, or any topic you're interested in — across all the groups you're part of.


🚀 Features

✅ Uses Telethon to read messages from all your Telegram groups
✅ Uses Bot API to send alerts and accept your commands
✅ In-memory deduplication — no duplicate alerts per session
✅ Bot commands to manage keywords and scan intervals
✅ Lightweight, fast, no database needed
✅ Customizable with ease


🛠️ Requirements

📦 Install dependencies:

pip install telethon python-telegram-bot --upgrade
python watcher.py

✅ Commands

CommandWhat it does
/startConfirms bot is running
/add <keyword>Adds a keyword to monitor
/remove <keyword>Removes a keyword
/listShows all active keywords
/interval <seconds>Sets scan interval (default: 3600 sec)

About

**TeleScanBot** is a Telegram monitoring bot that scans all your group chats

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages