LaunchKit · 2026
Back to Skills

freshrss-reader

Query headlines and articles from a self-hosted FreshRSS.

3
2.1k downloads
by @nickian

Setup & Installation

openclaw skills install @nickian/freshrss-reader

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install freshrss-reader

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

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Show me unread headlines from the Technology category in the last 4 hours

AGENT
  1. 1Run categories command to confirm exact category name casing
  2. 2Call headlines with --category Technology --hours 4 --unread flags
  3. 3Parse the formatted output of date, source, title, URL, and categories
  4. 4Return the filtered list to the user
OUTPUT

A list of unread Technology articles published in the last 4 hours, each with date, source, title, and URL

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

FRESHRSS_URL environment variableFRESHRSS_USER environment variableFRESHRSS_API_PASSWORD environment variableSelf-hosted FreshRSS instance with API access enabled