Rssaurus OpenClaw Skill - ClawHub
Do you want your AI agent to automate Rssaurus workflows? This free skill from ClawHub helps with cli utilities tasks without building custom tools from scratch.
What this skill does
Use the RSSaurus command-line client (Go binary `rssaurus`) to interact with https://rssaurus.com from the terminal: authenticate (`rssaurus auth login/whoami`), list feeds/items, print item URLs for piping, open URLs, and perform triage actions (mark read/unread, bulk mark-read, save/unsave). Use when asked to automate RSSaurus tasks from CLI, debug token/config issues, or demonstrate command usage.
Install
npx clawhub@latest install rssaurusFull SKILL.md
Open original| name | description |
|---|---|
| rssaurus-cli | Use the RSSaurus command-line client (Go binary `rssaurus`) to interact with https://rssaurus.com from the terminal: authenticate (`rssaurus auth login/whoami`), list feeds/items, print item URLs for piping, open URLs, and perform triage actions (mark read/unread, bulk mark-read, save/unsave). Use when asked to automate RSSaurus tasks from CLI, debug token/config issues, or demonstrate command usage. |
RSSaurus CLI
Use the installed rssaurus binary on this machine to interact with RSSaurus.
Quick checks (when something fails)
- Confirm binary exists:
which rssaurus
rssaurus --version || true
- Confirm auth works:
rssaurus auth whoami
Privacy note
- Do not print (e.g.
cat) the RSSaurus CLI config file contents; it can contain API tokens. - If auth fails, prefer re-authenticating (
rssaurus auth login) or asking the user to paste only non-sensitive details (error output, host, etc.).
Common tasks
List feeds
rssaurus feeds
rssaurus feeds --json
List items
Unread by default:
rssaurus items --limit 20
Filter by feed:
rssaurus items --feed-id 3 --limit 20
Machine-friendly URL output (one per line):
rssaurus items --limit 20 --urls
Cursor paging:
rssaurus items --limit 50 --cursor <cursor>
Open a URL
rssaurus open https://example.com
Mark read/unread
These require item IDs (get them via --json).
rssaurus items --limit 5 --json
rssaurus read <item-id>
rssaurus unread <item-id>
Bulk mark read:
rssaurus mark-read --all
# or
rssaurus mark-read --ids 1,2,3
# optional
rssaurus mark-read --all --feed-id 3
Save / unsave
rssaurus save https://example.com --title "Optional title"
# unsave requires an id (obtain via --json output from the API response or future saved-items listing)
rssaurus unsave <saved-item-id>
Output conventions (privacy)
- Default human output avoids printing internal DB IDs.
- Use
--jsonoutput when IDs are required for scripting or write actions.
References
- CLI repo: https://github.com/RSSaurus/rssaurus-cli
- Homebrew tap: https://github.com/RSSaurus/tap
- Token creation: https://rssaurus.com/api_tokens/new