✓ Verified 💻 Development ✓ Enhanced Data

Freshrss Reader

Query headlines and articles from a self-hosted FreshRSS.

Rating
4.2 (157 reviews)
Downloads
27,850 downloads
Version
1.0.0

Overview

Query headlines and articles from a self-hosted FreshRSS.

Complete Documentation

View Source →

FreshRSS

Query headlines from a self-hosted FreshRSS instance via the Google Reader compatible API.

Setup

Set these environment variables:

bash
export FRESHRSS_URL="https://your-freshrss-instance.com"
export FRESHRSS_USER="your-username"
export FRESHRSS_API_PASSWORD="your-api-password"

API password is set in FreshRSS → Settings → Profile → API Management.

Commands

Get latest headlines

bash
{baseDir}/scripts/freshrss.sh headlines --count 10

Get headlines from the last N hours

bash
{baseDir}/scripts/freshrss.sh headlines --hours 2

Get headlines from a specific category

bash
{baseDir}/scripts/freshrss.sh headlines --category "Technology" --count 15

Get only unread headlines

bash
{baseDir}/scripts/freshrss.sh headlines --unread --count 20

Combine filters

bash
{baseDir}/scripts/freshrss.sh headlines --category "News" --hours 4 --count 10 --unread

List categories

bash
{baseDir}/scripts/freshrss.sh categories

List feeds

bash
{baseDir}/scripts/freshrss.sh feeds

Output

Headlines are formatted as:

text
[date] [source] Title
  URL
  Categories: cat1, cat2

Notes

  • Default count is 20 headlines if not specified
  • Time filtering uses --hours for relative time (e.g., last 2 hours)
  • Category names are case-sensitive and must match your FreshRSS categories
  • Use categories command first to see available category names

Installation

Terminal bash 

openclaw install freshrss-reader
Copied!

💻Code Examples

export FRESHRSS_API_PASSWORD="your-api-password"

export-freshrssapipasswordyour-api-password.txt
API password is set in FreshRSS → Settings → Profile → API Management.

## Commands

### Get latest headlines

{baseDir}/scripts/freshrss.sh feeds

basedirscriptsfreshrsssh-feeds.txt
## Output

Headlines are formatted as:
example.sh
export FRESHRSS_URL="https://your-freshrss-instance.com"
export FRESHRSS_USER="your-username"
export FRESHRSS_API_PASSWORD="your-api-password"
example.txt
[date] [source] Title
  URL
  Categories: cat1, cat2

Tags

#self_hosted-and-automation

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author nickian
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install freshrss-reader

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0