freshrss

TotalClaw 作者 totalclaw

从自托管的 FreshRSS 实例查询标题和文章。当用户请求 RSS 新闻、最新头条新闻、提要更新或想要从 FreshRSS 阅读器浏览文章时使用。支持按类别、时间范围、数量进行过滤。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~nickian-freshrss-reader

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~nickian-freshrss-reader/file -o nickian-freshrss-reader.md

## 概述（中文）

从自托管的 FreshRSS 实例查询标题和文章。当用户请求 RSS 新闻、最新头条新闻、提要更新或想要从 FreshRSS 阅读器浏览文章时使用。支持按类别、时间范围、数量进行过滤。

## 原文

# 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