RSS Monitor#

Monitor RSS feeds and deliver notifications when new articles are published.

Features#

• Monitor multiple RSS feeds
• Detect new articles automatically
• Send notifications to Feishu/Lark
• Schedule checks via cron
• Support for RSS, Atom, and JSON feeds

Quick Start#

Add a feed to monitor#

bash

scripts/rss_monitor.py add <feed_url> [--name <friendly_name>]

Check all feeds for updates#

bash

scripts/rss_monitor.py check-all

List monitored feeds#

bash

scripts/rss_monitor.py list

Setup#

Feishu Webhook (Optional)#

To receive Feishu notifications:

1. Create a Feishu group

2. Add a webhook bot

3. Copy the webhook URL

4. Set environment variable: bash

   export FEISHU_WEBHOOK="https://open.feishu.cn/open-apis/bot/v2/hook/..."
   
   

Cron Schedule#

Add to crontab for automatic monitoring:

bash

# Check every 30 minutes
*/30 * * * * cd /path/to/workspace && python scripts/rss_monitor.py check-all

Or use OpenClaw cron:

bash

openclaw cron add --name "rss-monitor" --schedule "*/30 * * * *" --command "python scripts/rss_monitor.py check-all"

Commands#

CommandDescriptionadd <url>Add RSS feed to watchlistremove <name>Remove feed from watchlistlistShow all monitored feedscheck-allCheck all feeds for updatescheck <name>Check specific feedhistoryShow recently detected articles

Data Storage#

• Watchlist: ~/.rss_monitor/feeds.json
• Article history: ~/.rss_monitor/history.json

Dependencies#

• Python 3.6+
• requests
• feedparser

Install: pip install requests feedparser