Skip to content
TakoAPI
Back to skills

freshrss-reader

by nickian

Self-Hosted & Automation
2.1kDownloads reported by clawskills.sh
3Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

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

AGENT
  1. 1

    Run categories command to confirm exact category name casing

  2. 2

    Call headlines with --category Technology --hours 4 --unread flags

  3. 3

    Parse the formatted output of date, source, title, URL, and categories

  4. 4

    Return 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

  • 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-reader

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links