AgentSkillsCN

freshrss

从自托管的 FreshRSS 实例中查询头条与文章。当用户请求 RSS 新闻、最新头条、订阅源更新，或希望在 FreshRSS 阅读器中浏览文章时，可使用此功能。支持按类别、时间范围与条目数量进行筛选。

SKILL.md
--- frontmatter
name: freshrss
description: 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.

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:

code
[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