RSSaurus CLI 是 RSSaurus 的命令行客户端,使用 Go 二进制程序 rssaurus,用于在终端中与 RSSaurus 服务交互。默认生产主机为 https://rssaurus.com。
用途 该工具面向需要在终端或脚本中管理 RSS 订阅源与条目的用户,提供认证、读取、标记和保存等操作。
主要能力
- 认证与身份检查:使用 rssaurus auth whoami 验证令牌是否有效。
- 列出订阅源:rssaurus feeds,或使用 rssaurus feeds --json 获取机器可读输出。
- 列出条目:默认列出未读条目,例如 rssaurus items --limit 20;可按订阅源筛选,例如 rssaurus items --feed-id 3 --limit 20;可输出 URL 列表,每行一个,例如 rssaurus items --limit 20 --urls;支持游标分页,例如 rssaurus items --limit 50 --cursor <cursor>。
- 打开链接:rssaurus open https://example.com。
- 标记已读/未读:需要条目 ID,可通过 --json 获取,例如 rssaurus items --limit 5 --json,然后执行 rssaurus read <item-id> 或 rssaurus unread <item-id>。
- 批量标记已读:rssaurus mark-read --all,或 rssaurus mark-read --ids 1,2,3,也可附加 --feed-id 3 限定订阅源。
- 保存/取消保存:rssaurus save https://example.com --title "Optional title";取消保存需要 ID,例如 rssaurus unsave <saved-item-id>,该 ID 可通过 API 响应的 --json 输出或未来的已保存条目列表获取。
使用方式 确认二进制存在:which rssaurus;rssaurus --version || true。 确认认证与主机:配置文件位于 ~/.config/rssaurus/config.json(或 $XDG_CONFIG_HOME),可查看该文件;使用 rssaurus auth whoami 验证令牌。 临时覆盖主机或令牌:RSSAURUS_HOST=https://rssaurus.com RSSAURUS_TOKEN=... rssaurus auth whoami。
输出约定与隐私 默认人类可读输出避免打印内部数据库 ID。当脚本处理或写操作需要 ID 时,使用 --json 输出。
适用场景 适合在终端中快速浏览未读条目、按订阅源筛选、批量标记已读、保存链接,以及通过 --json 和 --urls 输出集成到脚本或自动化流程中。
限制 取消保存操作需要已保存条目的 ID,而该 ID 的获取方式在现有资料中仅提到可通过 API 响应的 --json 输出或未来的已保存条目列表,暂未提供更具体的获取步骤。其他功能限制暂未提供。
参考 CLI 仓库:https://github.com/RSSaurus/rssaurus-cli Homebrew tap:https://github.com/RSSaurus/tap 令牌创建:https://rssaurus.com/api_tokens/new