Blog to Kindle

📚 博客抓取·EPUB 编译·Kindle 推送

将博客内容抓取并编译为 Kindle 友好的 EPUB 电子书,支持 AI 生成封面,支持 Paul Graham、Wait But Why 等知名博客站点。

收藏
11.5k
安装
2.8k
版本
1.0.0
CLS 安全性认证2026-07-04
点击查看完整报告 >

使用说明

核心用法

Blog to Kindle 是一套完整的博客内容抓取与 Kindle 电子书生成工具链。用户通过命令行脚本完成四步工作流:首先使用 fetch_blog.py 从支持的站点(如 Paul Graham、Kevin Kelly、Derek Sivers、Wait But Why、Astral Codex Ten 等)或自定义 URL 抓取文章;其次调用 Nano Banana Pro 生成专业风格的书籍封面;然后使用 compile_epub.py 将内容与封面合成为标准 EPUB 格式;最后通过 send_to_kindle.py 经由 AppleScript 调用 Mail.app 发送至 Kindle 邮箱。

显著优点

  • 自动化程度高:从抓取到送达全流程脚本化,支持增量更新(通过 ~/.clawdbot/state/ 状态文件追踪已发送文章)
  • 知名站点预设:内置对顶级科技/思想博客的支持,减少配置成本
  • AI 封面生成:集成 Nano Banana Pro 生成专业文学风格封面,提升阅读体验
  • 格式兼容性:输出标准 EPUB,经 Kindle 原生支持,含目录结构

潜在缺点与局限性

  • 平台依赖:邮件发送功能深度绑定 macOS Mail.app 与 AppleScript,跨平台迁移困难
  • 网络抓取风险:依赖目标站点的 HTML 结构稳定性,站点改版可能导致解析失败
  • 版权灰色地带:批量下载受版权保护的文章用于个人阅读,法律边界因司法管辖区而异
  • 单点故障:工作流中任一步骤失败(如封面生成服务不可用)将阻断完整交付
  • 邮箱白名单限制:需预先配置 Kindle 认可的发件人地址

适合人群

重度博客读者、离线阅读偏好者、希望将分散的在线文章归档为个人电子图书馆的用户,特别是 macOS 生态的深度使用者。

常规风险

  • 内容合规:抓取内容可能包含受版权保护材料,用户需自行确保符合当地法律及网站 ToS
  • 服务稳定性:依赖外部 AI 图像生成服务(Nano Banana Pro)的可用性与计费状态
  • 数据持久化:状态文件存储于本地路径,跨设备同步需手动处理
  • 邮件安全:AppleScript 自动化可能触发邮件客户端的安全提示或权限变更

安全解读

核心用法

Blog to Kindle 是一套完整的博客内容归档工作流工具,支持从 Paul Graham、Kevin Kelly、Derek Sivers、Wait But Why、Astral Codex Ten 等知名博客站点批量抓取文章,自动编译为 Kindle 原生支持的 EPUB 格式电子书,并集成 AI 封面生成与邮件推送功能。

完整工作流分为四步:抓取(Fetch) → 生成封面(Cover) → 编译 EPUB(Compile) → 推送 Kindle(Send)。其中封面生成依赖 Nano Banana Pro 技能,用户需严格遵循此顺序,禁止跳过封面步骤直接发送。

支持增量更新机制,通过 ~/.clawdbot/state/blog-kindle/ 目录下的状态文件记录上次抓取时间与已发送文章 ID,避免重复下载。对于未列出的自定义站点,可通过 --site custom --url <archive-url> 模式扩展支持。

显著优点

  • 预置权威源:内置五大顶级博客站点(Paul Graham 的创业思想、Kevin Kelly 的技术哲学、Derek Sivers 的独立创作者经验等),内容质量有保障
  • 端到端自动化:从网络抓取到 Kindle 收件,全流程脚本化,无需手动操作 pandoc 或邮件客户端
  • AI 封面集成:通过 Nano Banana Pro 生成专业级书籍封面,提升电子书质感
  • 状态追踪与增量更新:智能识别新文章,适合长期追踪博主更新
  • 格式规范输出:使用 pandoc 生成标准 EPUB,带目录导航,Kindle 兼容性优秀

潜在缺点与局限性

  • 依赖外部工具链:需预装 pandoc、Mail.app(macOS)及 Python 环境,跨平台部署受限
  • 网络抓取脆弱性:目标站点改版可能导致解析失效,维护成本随支持站点增加而上升
  • 邮件发送限制:依赖 AppleScript 调用 Mail.app,Windows/Linux 用户无法使用原生发送功能
  • 默认邮箱隐患:内置作者个人 Kindle 邮箱作为默认值,存在误发送风险
  • 自定义站点无验证:--site custom 模式缺乏 URL 格式校验,可能引发无效请求

适合人群

  • 深度阅读者:希望离线阅读高质量长文,减少屏幕干扰
  • 内容策展人:需要批量归档特定作者全集,建立个人数字图书馆
  • Kindle 生态用户:偏好 EPUB 格式,追求推送至设备的无缝体验
  • 技术爱好者:具备基础 Python/命令行操作能力,能接受脚本化工作流

常规风险

  • 版权与使用条款:自动抓取可能违反部分网站的 ToS,用户需自行评估合法性
  • 目标站点压力:默认 0.5 秒延迟虽为礼貌间隔,但大量抓取仍可能对小型博客造成负担
  • 邮件送达失败:Kindle 个人文档服务对文件大小(<50MB)和格式有严格要求,超大 EPUB 可能被拒收
  • 隐私泄露风险:发送至他人 Kindle 邮箱(尤其是默认地址)将导致个人阅读记录暴露
  • AI 封面版权:Nano Banana Pro 生成的封面图像需关注其许可协议,避免商业使用纠纷

Blog to Kindle 内容

references文件夹
scripts文件夹
手动下载zip · 8.2 kB
manual-workflow.mdtext/markdown
请选择文件