Readarr + Server酱:电子书抓取入库微信通知

效果:Readarr 抓到想读的书、导入完成或失败时,微信收到通知。

前置条件

  • Server酱 SendKey(SCT 开头):登录 sct.ftqq.com,在「SendKey」页面复制——30 秒获取教程
  • 一个运行中的 Readarr 实例
  • 一个 apprise-api 容器:Readarr 的 Apprise Connect 属于 B 类接法,需自建 caronc/apprise-api 容器做中转,部署方法见 /integrations/apprise/

如需推送到企业微信、钉钉或飞书群,参见通道说明

配置步骤

1. 在 Readarr 中添加 Apprise 连接

进入 Settings → Connect → 点击加号 → 选择 Apprise,填写以下两个字段:

  • Base Url:你的 apprise-api 容器地址,例如 http://localhost:8000
  • Stateless URLsschan://你的SENDKEY

schan:// 是 Apprise 中 Server酱的专用协议,底层调用 https://sctapi.ftqq.com/你的SENDKEY.send,SCT 开头的 SendKey 直接可用。

2. 选择触发事件

在同一个 Apprise 配置页面中,勾选你需要的通知触发事件(具体选项以应用内实际显示为准)。

3. 命令行自测(可选)

配置 Readarr 前后,都可以用命令行验证 SendKey 和 schan:// 协议是否正常:

pip install apprise
apprise -t "测试" -b "正文" "schan://你的SENDKEY"

收到微信通知说明 SendKey 和协议都没问题。

常见问题

免费额度够用吗?

Server酱免费版每天 5 条,每分钟上限 50 条。Readarr 的通知频率通常不高,日常使用足够。订阅会员目前特价最低 3 元/月,一天最多可发 1000 条(价格详情)。

配置后没收到消息怎么办?

先检查 apprise-api 容器是否正常运行、Base Url 是否正确,再用命令行 apprise -vv 自测。如自测能收到但 Readarr 不行,检查 Readarr Connect 中对应事件是否勾选。更多排查见常见问题与排查

Server酱³(sctp 开头 SendKey)怎么接?

schan:// 协议仅对接 Server酱Turbo(SCT 开头)。Server酱³(sctp 开头)Apprise 暂无专用插件,可用通用 json:// 插件直连 push.ft07.com API,具体接法见 /integrations/apprise/

消息频率有限制吗?

每分钟上限 50 条,会员每日 API 请求上限 1000 条。Readarr 批量导入时可能短时间触发多条通知,注意不要超过频率限制。

相关集成

懒人方案:把这段话复制给你的 AI 助手

把下面这段文字原样粘贴给 Claude Code、Cursor 或任何 AI 编程助手,它就会替你完成 Server酱 的接入:

请帮我把 Server酱 微信通知接入到我当前的项目/工具中:
1. API:POST https://sctapi.ftqq.com/{SendKey}.send,参数 title(必填,不能含换行)、desp(正文,支持 Markdown,可选);成功时返回 JSON 的 code 为 0。
2. 如果我的 SendKey 以 sctp 开头,则改用 https://{uid}.push.ft07.com/send/{SendKey}.send,uid 是 SendKey 中 sctp 与 t 之间的数字。
3. SendKey 从环境变量 SERVERCHAN_SENDKEY 读取;如果没有,提醒我到 https://sct.ftqq.com 免费获取(每天 5 条额度)。
4. 安全要求:不要把 SendKey 硬编码进代码、不要打印到日志、不要提交到 git。
5. 频率约定:任务结束发 1 条结果摘要即可,批量任务合并成一条,不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。