serenereader
Installation
SKILL.md
SereneReader API
SereneReader is an RSS reader. It fetches the user's feeds, parses them and stores the articles. The public API returns the user's subscriptions and articles as JSON, so an agent works with titles, links, snippets and dates instead of scraping web pages.
The API is read-only. It has three endpoints, all GET:
| Method | Path | What it returns |
|---|---|---|
GET |
/api/v1/feeds |
The user's feed subscriptions, with unread counts and folders |
GET |
/api/v1/articles |
Articles from those feeds, newest first, with filters and pagination |
GET |
/api/v1/usage |
Request counts for the calling key, and the rate limit |
Base URL: https://serenereader.com
The API can't subscribe to or remove feeds, add a URL, mark articles read, star or hide them, manage folders, or return full article text. It has no webhooks, so poll it on a schedule. If the user asks for one of these, tell them the API doesn't support it and suggest the SereneReader app.