LazyLibrarian + Server酱:抓到电子书时微信收到通知

效果:LazyLibrarian 成功抓取你想要的电子书或有声书后,微信立即收到推送通知。

前置条件

  • 一个 Server酱 SendKey(SCT 开头),获取方式见 30 秒获取 SendKey
  • 已安装并运行的 LazyLibrarian 实例。
  • 如需推送到企业微信/钉钉/飞书群,另见 通道配置

配置步骤

LazyLibrarian 内置 Apprise 通知库,支持 Server酱的 schan:// 专用协议,无需额外脚本。

1. 在 LazyLibrarian 中填入 Apprise 地址

进入 LazyLibrarian 的 Config → Notifications → Apprise,在 Apprise URL 字段中填入:

schan://你的SENDKEY

你的SENDKEY 替换为你的实际 SendKey(SCT 开头)。保存配置。

2. 发送测试通知

在同一 Notifications 页面找到测试通知功能(具体入口以应用内实际显示为准),触发测试发送。若配置正确,微信会收到一条来自 Server酱的测试消息。

3. 命令行自测(可选)

如果想在配置 LazyLibrarian 之前先验证 SendKey 是否可用,可以用 Apprise 命令行工具自测:

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

收到微信推送说明 SendKey 有效,可以继续配置 LazyLibrarian。

完整示例

以下是一条典型的 LazyLibrarian 抓书成功通知,通过 Server酱推送到微信。底层调用等价于:

curl -X POST "https://sctapi.ftqq.com/你的SENDKEY.send" \
  --data-urlencode "title=【成功】LazyLibrarian 已下载:三体" \
  --data-urlencode "desp=作者:刘慈欣

文件格式:EPUB

保存路径:/books/三体.epub"

LazyLibrarian 通过 Apprise 发送时,schan:// 协议会自动将通知标题和正文映射到 Server酱 API 的 titledesp 参数,底层请求即发往 https://sctapi.ftqq.com/你的SENDKEY.send

常见问题

免费额度够用吗?

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

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

先确认 SendKey 以 SCT 开头且完整复制(无多余空格)。用上面的命令行方式自测,排除 LazyLibrarian 自身配置问题。更多排查步骤见 常见问题与排查

Server酱³(sctp 开头 SendKey)能用吗?

schan:// 协议目前对接 Server酱Turbo(SCT 开头 SendKey)。Server酱³(sctp 开头)暂无专用 Apprise 插件,可用通用 json:// 插件直连 push.ft07.com API,通用接法详见 Apprise 接入 Server酱

通知频率有限制吗?

每分钟上限 50 条,会员每日 API 请求上限 1000 条。LazyLibrarian 批量下载时如触发大量通知,建议在 LazyLibrarian 通知设置中控制发送频率。

相关集成

懒人方案:把这段话复制给你的 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 条结果摘要即可,批量任务合并成一条,不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。