🤖Telegram keyword alert bot⏰

Telegram关键字提醒机器人，用于实时监测频道/群组中的关键字消息。

确保普通Telegram账户能够在不需要验证的情况下加入指定群组。

Warning: Demo bot使用过载，建议使用 Docker 镜像自部署

👉 Features：

• 关键字消息订阅：根据设定的关键字和频道实时推送消息提醒

• 支持正则表达式匹配语法

• 支持多频道订阅 & 多关键字订阅

• 支持订阅群组消息

• 支持私有频道ID/邀请链接的消息订阅

• 支持私有群组订阅

  1. https://t.me/+B8yv7lgd9FI0Y2M1
  2. https://t.me/joinchat/B8yv7lgd9FI0Y2M1

👉 Todo:

• 私有频道消息提醒完整内容预览
• 多账号支持
• 扫描退出无用频道/群组

🔍Demo

http://t.me/keyword_alert_bot

🚀Run

1. 配置文件

config.yml.example --> config.yml

将 config.yml.example 复制到本地并重命名为 config.yml，然后根据下面申请的 api 进行配置

Create Telelgram Account & API

建议使用新Telegram账户开通api 来使用

Create BOT

https://t.me/BotFather 创建机器人

2. 🐳Docker

$ docker run -it --name keyword_alert_bot -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/db/:/app/db/ yha8897/keyword_alert_bot

Please enter the code you received: 12345
Please enter your password: 
Signed in successfully as DEMO; remember to not break the ToS or you will risk an account ban!

#################################################################
##                                                             ##
##                          ● success                          ##
##   🤖️Telegram keyword alert bot (Version: 20240627.f6672cf)  ##
##                                                             ##
#################################################################

首次运行需要Telegram账户接收数字验证码，并输入密码（Telegram API触发），之后提示success即可

其他

# 重启
$ docker restart keyword_alert_bot

# 停止
$ docker stop keyword_alert_bot

# 数据库文件挂载路径: /app/db/.db
$ docker run -it --name keyword_alert_bot  -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/db/keyword_alert_bot.db:/app/db/.db yha8897/keyword_alert_bot

docker镜像更新

避免数据丢失，容器更新前记得把docker中数据备份。如果已经把数据库文件挂载进容器 可以不用

$ docker cp keyword_alert_bot:/app/db/.db ~/keyword_alert_bot.db
# 即可保存到: ~/keyword_alert_bot.db

持久化所有数据，避免权限问题 --user root 强制root权限执行

$ docker run -d --name keyword_alert_bot --user root  -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/db/:/app/db/ -v $(pwd)/.tmp/:/app/.tmp/ -v $(pwd)/logs/:/app/logs/  yha8897/keyword_alert_bot

💪Manual Build

运行环境 python3.7+

$ pipenv install

$ pipenv shell

$ python3 ./main.py

📘Usage

普通关键字匹配

/subscribe   免费     https://t.me/tianfutong
/subscribe   优惠券   https://t.me/tianfutong

正则表达式匹配

使用类似JavaScript正则语法规则，用/包裹正则语句，目前可以使用的匹配模式：i,g

# 订阅手机型号关键字：iphone x，排除XR，XS等型号，且忽略大小写
/subscribe   /(iphone\s*x)(?:[^sr]|$)/ig  com9ji,xiaobaiup
/subscribe   /(iphone\s*x)(?:[^sr]|$)/ig  https://t.me/com9ji,https://t.me/xiaobaiup

# xx券
/subscribe  /([\S]{2}券)/g  https://t.me/tianfutong

Q & A

Bug Feedback: https://github.com/Hootrix/keyword_alert_bot/issues

1. You have joined too many channels/supergroups (caused by JoinChannelRequest)

BOT中所有订阅频道的总数超过 500。原因是BOT使用的Telegram演示账户限制导致。建议你自行部署

2. sqlite3.OperationalError: unable to open database file

如果是docker镜像启动，由于内部使用nonroot账户 需要授权挂载文件权限 或者直接使用--user root参数

$ docker run -it --name keyword_alert_bot --user root  -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/db/:/app/db/ -v $(pwd)/.tmp/:/app/.tmp/ -v $(pwd)/logs/:/app/logs/  yha8897/keyword_alert_bot

3. 查看日志发现个别群组无法接收消息，而软件客户端正常接收

🤔尝试更新telethon到最新版本或者稳定的1.24.0版本

4. 订阅群组消息，机器人没任何反应

#20

5. 同时存在多关键字如何匹配

/(?=.*cc)(?=.*bb)(?=.*aa).*/

☕ Buy me a coffee

[USDT-TRC20]：TDELNhqYjMJvrChjcTBiBBieWYiDGiGm2r