介绍
# FreshRSS
通过 Google Reader 兼容 API 从自托管的 FreshRSS 实例查询新闻标题。
## 设置
设置以下环境变量：
```bash export FRESHRSS_URL="https://your-freshrss-instance.com" export FRESHRSS_USER="your-username" export FRESHRSS_API_PASSWORD="your-api-password" ```
API 密码在 FreshRSS → 设置 → 个人资料 → API 管理中设置。
## 命令
### 获取最新标题
```bash {baseDir}/scripts/freshrss.sh headlines --count 10 ```
### 获取过去 N 小时内的标题
```bash {baseDir}/scripts/freshrss.sh headlines --hours 2 ```
### 获取特定类别的标题
```bash {baseDir}/scripts/freshrss.sh headlines --category "Technology" --count 15 ```
### 仅获取未读标题
```bash {baseDir}/scripts/freshrss.sh headlines --unread --count 20 ```
### 组合过滤器
```bash {baseDir}/scripts/freshrss.sh headlines --category "News" --hours 4 --count 10 --unread ```
### 列出类别
```bash {baseDir}/scripts/freshrss.sh categories ```
### 列出订阅源
```bash {baseDir}/scripts/freshrss.sh feeds ```
## 输出
标题格式如下： ``` [date] [source] Title URL Categories: cat1, cat2 ```
## 注意事项
- 如果未指定，默认计数为 20 个标题 - 时间过滤使用 `--hours` 表示相对时间（例如，过去 2 小时） - 类别名称区分大小写，必须与您的 FreshRSS 类别匹配 - 请先使用 `categories` 命令查看可用的类别名称