blog-to-kindle

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

🥥51总安装量 16评分人数 21
100% 的用户推荐

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

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码安全规范,无 eval/exec 动态执行风险,无系统破坏性命令或静默数据上传
  • ✅ 使用标准开源依赖(httpx、beautifulsoup4),无已知 CVE 漏洞,依赖版本可锁定
  • ⚠️ 通过 subprocess 调用外部系统工具(pandoc、osascript),需确保运行环境可信且无命令注入
  • ⚠️ 具有网络请求行为,将访问用户指定的第三方博客站点,存在外部网络依赖
  • ✅ 文件操作路径受控,具备路径遍历防护、文件名清理和 50MB 文件大小检查机制

使用说明

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 内容

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