freshrss-reader
by nickian
Self-Hosted & AutomationBrief
Query headlines and articles from a self-hosted FreshRSS.
Description
What This Skill Does
Connects to a self-hosted FreshRSS instance to fetch and filter RSS headlines and articles. Supports filtering by category, time range, read status, and count. Uses the Google Reader compatible API.
Lets you query your own FreshRSS instance directly from an agent instead of opening a browser or building custom API calls.
When to Use It
- Check unread tech news from the last 2 hours
- Browse headlines from a specific category like Politics
- Pull the 20 most recent articles across all feeds
- List all configured feeds and categories
- Get a quick morning news digest filtered by time
Example Workflow
User asks: Show me unread headlines from the Technology category in the last 4 hours
- 1
Run categories command to confirm exact category name casing
- 2
Call headlines with --category Technology --hours 4 --unread flags
- 3
Parse the formatted output of date, source, title, URL, and categories
- 4
Return the filtered list to the user
A list of unread Technology articles published in the last 4 hours, each with date, source, title, and URL
Requirements
- FRESHRSS_URL environment variable
- FRESHRSS_USER environment variable
- FRESHRSS_API_PASSWORD environment variable
- Self-hosted FreshRSS instance with API access enabled
Installation
clawhub install nickian/freshrss-readerRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.