---
name: sundial-org/freshrss
source: https://app.decimal.ai/s/sundial-org-freshrss@1/SKILL.md
source_sha256: b18a139840e8
---

# 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:
```
[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