rss-watcher

star 459

Monitor RSS/Atom feeds for new articles. Poll on schedule, summarize updates, deliver via any channel.

fuyuxiang By fuyuxiang schedule Updated 6/13/2026

name: rss-watcher description: "Monitor RSS/Atom feeds for new articles. Poll on schedule, summarize updates, deliver via any channel." version: 1.0.0 metadata: echo: tags: [RSS, Atom, Feed, Monitor, News, Research]


RSS Watcher

Monitor RSS/Atom feeds and get notified of new articles.

Configuration

Create ~/.echo-agent/feeds.yaml:

feeds:
  - url: https://hnrss.org/frontpage
    category: tech
    label: Hacker News
  - url: https://arxiv.org/rss/cs.AI
    category: ai
    label: arXiv AI
  - url: https://feeds.feedburner.com/ruanyifeng
    category: blog
    label: 阮一峰
poll_interval: "*/30 * * * *"  # every 30 minutes
max_items: 10

Usage

pip install feedparser

python3 scripts/feed_monitor.py check        # check all feeds for new items
python3 scripts/feed_monitor.py list         # list configured feeds
python3 scripts/feed_monitor.py add "https://example.com/feed.xml" --category tech
python3 scripts/feed_monitor.py import feeds.opml  # import OPML

How It Works

  1. Reads feed URLs from feeds.yaml
  2. Parses via feedparser library
  3. Tracks seen entries in SQLite (~/.echo-agent/feeds.db) by entry ID/link
  4. Returns only new (unseen) entries
  5. Delivers updates through active channel

Output Format

📰 New Articles:

[tech] Hacker News
  • Title of Article 1
    https://link-to-article.com
  • Title of Article 2
    https://link-to-article.com

[ai] arXiv AI
  • New Paper Title
    https://arxiv.org/abs/2406.xxxxx

Integration

Combine with Echo Agent's cron channel for automatic polling. Set poll_interval in feeds.yaml to control check frequency.

Install via CLI
npx skills add https://github.com/fuyuxiang/echo-agent --skill rss-watcher
Repository Details
star Stars 459
call_split Forks 18
navigation Branch main
article Path SKILL.md
More from Creator