名称： freshrss
描述： 从自托管的 FreshRSS 实例查询头条新闻和文章。当用户询问 RSS 新闻、最新头条、订阅源更新，或想浏览其 FreshRSS 阅读器中的文章时使用。支持按分类、时间范围和数量进行筛选。

FreshRSS

通过兼容 Google Reader 的 API，从自托管的 FreshRSS 实例查询头条新闻。

配置

设置以下环境变量：

export FRESHRSS_URL="https://your-freshrss-instance.com"
export FRESHRSS_USER="your-username"
export FRESHRSS_API_PASSWORD="your-api-password"

API 密码在 FreshRSS 的 设置 → 个人资料 → API 管理 中设置。

命令

获取最新头条

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

获取最近 N 小时内的头条

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

获取特定分类下的头条

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

仅获取未读头条

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

组合筛选条件

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

列出所有分类

{baseDir}/scripts/freshrss.sh categories

列出所有订阅源

{baseDir}/scripts/freshrss.sh feeds

输出格式

头条新闻的格式如下：

[日期] [来源] 标题
  URL
  分类: 分类1, 分类2

注意事项

• 如果未指定数量，默认显示 20 条头条。
• 时间筛选使用 --hours 参数指定相对时间（例如最近 2 小时）。
• 分类名称区分大小写，必须与 FreshRSS 中的分类完全匹配。
• 建议先使用 categories 命令查看可用的分类名称。