RSS Feed Management with agent-rss

Overview

agent-rss is a CLI tool for fetching and filtering RSS/Atom feeds. It outputs structured JSON for easy processing.

Installation Check

First, check if agent-rss is installed:

which agent-rss || echo "not installed"

If not installed:

npm install -g @atopos31/agent-rss

Core Commands

Managing Subscriptions

# Add a feed
agent-rss add <name> <url>

# List all feeds
agent-rss list

# Get a specific feed
agent-rss get <name>

# Update a feed
agent-rss update <name> --src <new-url>

# Remove a feed
agent-rss remove <name>

Fetching RSS

# Fetch specific feed
agent-rss fetch --name <name>

# Fetch all feeds
agent-rss fetch --all

# Output as JSON array (default is NDJSON)
agent-rss fetch --all --format json

Time Filtering

# Relative time (recommended for agents)
agent-rss fetch --all --since 1h      # past 1 hour
agent-rss fetch --all --since 2d      # past 2 days
agent-rss fetch --all --since 30m     # past 30 minutes

# Absolute time
agent-rss fetch --all --since 2026-03-12
agent-rss fetch --all --since 2026-03-12T08:00:00+08:00

Keyword Filtering

# Filter by title
agent-rss fetch --all --title "AI" --title "ML"

# Filter by content
agent-rss fetch --all --content "machine learning"

# Combine filters
agent-rss fetch --all --since 1d --title "AI"

Best Practice: Output to File

IMPORTANT: CLI output may be truncated due to size limits. Always write output to a file, then read it:

# Step 1: Write to file
agent-rss fetch --all --since 1d > /tmp/rss-output.json

# Step 2: Use Read tool to access full content
# Read /tmp/rss-output.json

This ensures no data is lost due to output truncation.

Output Format

Each item contains:

{
  "name": "feed-name",
  "src": "https://example.com/rss",
  "time": "2026-03-12T15:30:00+08:00",
  "title": "Article Title",
  "content": "Article content or summary",
  "link": "https://example.com/article",
  "id": "unique-id"
}

Common Workflows

Check for Recent News

agent-rss fetch --all --since 1h > /tmp/recent.json
# Then read /tmp/recent.json

Search for Specific Topics

agent-rss fetch --all --since 1d --title "AI" --title "LLM" > /tmp/ai-news.json
# Then read /tmp/ai-news.json

Daily News Summary

agent-rss fetch --all --since 24h --format json > /tmp/daily.json
# Then read /tmp/daily.json and summarize

Finding RSS Feeds

For curated RSS feeds, see: https://github.com/JackyST0/awesome-rsshub-routes

Troubleshooting

• If a feed times out, try fetching it individually with

  --name

• Use

  --format json

  for JSON array output
• Times are displayed in local timezone