CLI RSS tool for AI agents. Subscribe to feeds, fetch RSS/Atom content, and filter by time or keywords.
npm install -g @atopos31/agent-rss
go install github.com/atopos31/agent-rss/cmd/agent-rss@latest
git clone https://github.com/atopos31/agent-rss.git
cd agent-rss
go build -o agent-rss ./cmd/agent-rssInstall as a skill for AI agents that support skills:
npx skills add atopos31/agent-rss
# Add a feed agent-rss add hn https://news.ycombinator.com/rss # List all feeds agent-rss list # Get a specific feed agent-rss get hn # Update a feed agent-rss update hn --src https://news.ycombinator.com/rss # Remove a feed agent-rss remove hn
# Fetch a specific feed agent-rss fetch --name hn # Fetch all feeds agent-rss fetch --all # Output as JSON array (default is NDJSON) agent-rss fetch --all --format json
# Filter by relative time (past hours/days/minutes) 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 # Filter by absolute time agent-rss fetch --all --since 2026年03月12日 agent-rss fetch --all --since 2026年03月12日T08:00:00+08:00 --until 2026年03月12日T18:00:00+08:00 # Filter by title keyword agent-rss fetch --all --title "AI" # Filter by content keyword agent-rss fetch --all --content "machine learning" # Combine filters agent-rss fetch --all --since 1d --title "Go" --title "Rust"
# Use a custom feeds file
agent-rss --file /path/to/feeds.txt listMany AI agent environments (like Claude Code, OpenClaw, etc.) have output size limits for bash commands. When fetching RSS feeds with lots of content, the output may be truncated.
Recommended approach: Write output to a file, then use the agent's file reading capability to access the full content.
# Write RSS output to a temporary file agent-rss fetch --all --since 2026年03月12日 > /tmp/rss-output.json # Then use the agent's Read tool to access the complete content # The agent can read /tmp/rss-output.json without size limitations
This pattern ensures:
- No truncation of RSS content
- Full access to all fetched items
- Better handling of large feeds
Feeds are stored in ~/.config/agent-rss/feeds.txt:
# Comments start with #
hn https://news.ycombinator.com/rss
golang https://blog.golang.org/feed.atom
{"name":"hn","src":"https://...","time":"2026年03月12日T15:30:00+08:00","title":"...","content":"...","link":"...","id":"..."}
{"name":"hn","src":"https://...","time":"2026年03月12日T14:20:00+08:00","title":"...","content":"...","link":"...","id":"..."}[
{"name":"hn","src":"https://...","time":"2026年03月12日T15:30:00+08:00","title":"...","content":"...","link":"...","id":"..."},
{"name":"hn","src":"https://...","time":"2026年03月12日T14:20:00+08:00","title":"...","content":"...","link":"...","id":"..."}
]Looking for RSS feeds to subscribe? Check out awesome-rsshub-routes for a curated list of RSS feeds across various categories.
MIT