使用 SereneReader API 构建自动化工作流
为什么要自动化阅读?
RSS 已经解决了最难的部分:将来自数百个来源的内容汇聚到一处。SereneReader API 让您能够以编程方式将这些内容引入脚本、定时任务和其他工具中。
无需配置 Webhook,无需繁琐的 OAuth 流程。生成一个 API 密钥,发起 HTTP 请求,获取 JSON 响应。
快速开始
API 访问包含在每月 $5 的 Pro 计划中——无需企业级套餐。大多数竞争对手的 RSS 阅读器将 API 访问锁定在更高价位或顶级计划之后。
创建 API 密钥
前往 SereneReader 的设置页面,滚动到 API 部分。创建一个新密钥,为其起一个便于识别的名称,并将其妥善保存。密钥仅显示一次。
身份认证
每个请求都需要在 Authorization 请求头中携带 Bearer 令牌。仅此而已。无需客户端 ID,无需刷新令牌,无需权限范围。您的 API 设置页面提供了基础 URL、接口文档和示例请求。
频率限制
API 每个账户每分钟允许 30 次请求。对于按计划运行的脚本来说已经绰绰有余。如果触达限制,请稍等片刻后重试。
能做什么
API 提供对您的文章和订阅的读取权限。可按订阅源、文件夹或发布日期筛选文章,并列出带有未读计数的订阅列表。所有响应均为 JSON 格式,包含标题、URL、发布日期、摘要和订阅源元数据。
完整的接口列表、参数说明和响应结构请参阅设置页面中的 API 文档部分。
使用场景
每日摘要邮件
编写一个每天早上 7 点运行的脚本,抓取前一天的文章并发送摘要邮件。按日期筛选,通过 jq 提取标题和 URL,再将结果发送到您偏好的任何通知系统。
数据以整洁的格式呈现,可以按您的需求自由加工。
订阅源健康监控
订阅源会出问题。域名过期、路径变更、服务器宕机。一个每周运行的脚本可以列出您的订阅,并检查哪些已经很久没有更新。
当某个订阅源悄然停更,您会在疑惑"那个博客为什么不出现了"之前就得到通知。
导出到其他工具
将文章拉取到本地数据库、Notion 页面、Obsidian 笔记库或电子表格中。API 提供结构化数据,因此转换步骤通常只需几行 jq 或一小段 Python 脚本。
与 AI 代理结合
API 与能够发起 HTTP 请求的 AI 工具配合良好。如果您使用的是 OpenClaw 之类的代理框架,可以将其指向 SereneReader,让它自动处理您的订阅源。我们为此单独写了一篇文章:如何将 RSS 订阅源连接到 AI 代理。
保持简单
最好的自动化是只做一件事的短小脚本。每天运行一次的定时任务。显示未读数量的 Shell 别名。将文章转发到 Slack 频道的 Webhook 中转。
这些都不需要框架。curl 和 jq 足以应对大多数场景。如果需要更结构化的方案,任何支持 HTTP 客户端的语言都能胜任。
API 密钥和接口文档位于您的 SereneReader 设置页面中。