blog-to-kindle

📚 博客收藏一键转 Kindle 电子书

基于 Python 工具链将 Paul Graham 等优质博客编译成带 AI 封面的 Kindle 电子书,实现离线深度阅读与便携管理。

收藏
3.1k
安装
977
版本
v1.0.0
CLS 安全性认证2026-07-08
点击查看完整报告 >

使用说明

Blog to Kindle 是一款专注于将优质博客内容转换为 Kindle 电子书格式的自动化工具。该技能通过结构化的四步工作流(获取→封面→编译→发送),支持从 Paul Graham、Kevin Kelly、Derek Sivers、Wait But Why 等知名博客站点抓取文章,生成带有 AI 艺术封面的 EPUB 文件,并通过邮件推送至 Kindle 设备。

核心用法方面,用户通过命令行界面执行 Python 脚本,首先使用 fetch_blog.py 抓取目标网站的完整文章列表,随后调用 Nano Banana Pro 技能生成符合文学审美的极简风格封面(必须步骤),接着利用 compile_epub.py 调用 pandoc 将 Markdown 格式文章与封面整合为标准 EPUB 电子书,最后通过 send_to_kindle.py 借助 AppleScript 驱动 Mail.app 将文件发送至指定 Kindle 邮箱。整个过程支持增量更新,通过本地状态文件记录已下载文章,避免重复抓取。

显著优点在于其精准定位了深度阅读场景,将分散的网络长文转化为可离线阅读的电子书格式,特别适合收藏经典博客文章。AI 生成封面功能提升了电子书的专业质感,而内置的 50MB 文件大小检查和格式验证确保了与 Kindle 生态的兼容性。支持自定义网站扩展也提供了灵活性,且代码使用标准开源库(httpx、beautifulsoup4),依赖关系透明可靠。

潜在局限性主要包括平台依赖性——该工具深度依赖 macOS 生态系统(Mail.app 和 AppleScript),且需要预先安装 pandoc 文档转换工具,Windows 和 Linux 用户无法直接使用。50MB 的文件大小限制可能无法容纳超大型博客归档。此外,作为 T3 来源的社区项目,其长期维护稳定性不如商业软件,且封面生成依赖另一个 AI 技能(Nano Banana Pro)。

适合的目标群体为习惯 Kindle 深度阅读的博客爱好者、需要离线访问技术文章或随笔的知识工作者,以及希望建立个人电子书库的内容策展者。特别适合想要系统阅读 Paul Graham 等名家完整文章 archive 的用户。

使用风险方面,尽管代码本身无恶意行为,但工具通过 subprocess 调用外部系统命令(pandoc 和 osascript)存在潜在的命令注入风险(尽管当前实现已做输入验证)。网络请求行为会访问用户指定的第三方博客站点,需确保目标网站的可信度。邮件发送功能依赖本地 Mail.app 配置,用户需确保发件邮箱已在 Amazon Kindle 白名单中,且文件传输受限于 50MB 大小限制。

安全解读

核心用法

blog-to-kindle 是一套完整的博客电子书化工作流,将分散的网络长文转化为沉浸式阅读体验。四步闭环设计:抓取(Fetch)→封面(Cover)→编译(Compile)→投递(Send)。

支持的权威信源:Paul Graham(创业散文)、Kevin Kelly(科技哲学)、Derek Sivers(独立开发者)、Wait But Why(深度科普)、Astral Codex Ten(理性主义)。同时支持自定义站点扩展。

技术亮点:

  • 智能增量更新:通过 ~/.clawdbot/state/ 状态文件追踪已抓取文章,避免重复下载
  • AI封面生成:联动 nano-banana-pro 生成专业级文学封面(2K分辨率、极简设计)
  • 原生Kindle集成:通过 AppleScript 调用 Mail.app 直接发送至Kindle邮箱

显著优点:
1. 信源质量高:预设站点均为行业公认的深度内容生产者,信息密度远超普通资讯

2. 阅读体验完整:EPUB支持目录导航、字体调整、进度同步,远胜浏览器阅读

3. 自动化程度高:单次配置后可实现"新文自动抓取→增量更新→推送"的全自动归档

潜在局限:

  • 平台依赖:深度集成macOS生态(AppleScript、Mail.app),Windows/Linux需手动适配
  • 封面依赖:强制要求AI生成封面环节,若未配置 nano-banana-pro 则工作流中断
  • 邮箱硬编码:默认Kindle地址 simonpilkington74_8oVjpj@kindle.com 为个人邮箱,需用户手动覆盖
  • 自定义URL风险:--site custom 模式缺乏域名白名单,存在被诱导访问恶意站点的可能

适合人群:

  • 深度阅读者:希望离线归档特定作者的完整作品集
  • 数字极简主义者:减少屏幕碎片化,回归长文专注阅读
  • 研究者/写作者:建立个人化的权威资料库

常规风险:

  • 网络抓取需遵守目标站点的 robots.txt 及使用条款
  • 自定义URL输入需警惕钓鱼诱导(报告建议加强验证)
  • 中间文件(Markdown、临时图片)不会自动清理,需手动管理存储

blog-to-kindle 内容

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