How do I install the Freshrss skill?

Run npx skillmds@latest add modbender/freshrss in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Freshrss safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Freshrss?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Freshrss free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Freshrss?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Freshrss by modbender — Agent Skill

Name: Freshrss
Rating: 4.2 (5 reviews)
Author: modbender

Freshrss

Query headlines and articles from a self-hosted FreshRSS instance. Use when the user asks for RSS news, latest headlines, feed updates, or wants to browse articles from their FreshRSS reader. Supports filtering by category, time range, and count.

modbender Updated Sep 9, 2026 12 repo stars

File contents

FreshRSS

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

Setup

Set these environment variables:

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

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

Get headlines from the last N hours

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

Get headlines from a specific category

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

Get only unread headlines

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

Combine filters

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

List categories

{baseDir}/scripts/freshrss.sh categories

List feeds

{baseDir}/scripts/freshrss.sh feeds

Output

Headlines are formatted as:

[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

Frequently asked questions