Rss Monitor

---
name: rss-monitor
description: Monitor RSS feeds and send notifications when new content is published. Use when user needs to track blog updates, news feeds, or any RSS source. Supports Feishu/Lark notifications and scheduled monitoring via cron.
---

# 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

| Command | Description |
|---------|-------------|
| `add <url>` | Add RSS feed to watchlist |
| `remove <name>` | Remove feed from watchlist |
| `list` | Show all monitored feeds |
| `check-all` | Check all feeds for updates |
| `check <name>` | Check specific feed |
| `history` | Show 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`