Blog to Kindle

抓取博客/随笔网站内容，编译为带封面的 EPUB 格式，并发送至 Kindle。

快速开始

# 1. 从支持的站点获取文章
uv run scripts/fetch_blog.py --site paulgraham --output ./pg-essays

# 2. 生成封面（使用 Nano Banana Pro）
# 详见 nano-banana-pro 技能的封面生成说明

# 3. 编译为 EPUB 并嵌入封面
uv run scripts/compile_epub.py --input ./pg-essays --cover ./cover.png --output essays.epub

# 4. 发送到 Kindle
uv run scripts/send_to_kindle.py --file essays.epub --kindle-email user@kindle.com

工作流程（必须按此顺序执行）

1. 抓取 - 从博客下载所有文章/帖子
2. 生成封面 - 通过 Nano Banana Pro 技能创建封面（严禁跳过）
3. 编译 - 将内容与封面合并为 EPUB 文件
4. 发送 - 通过邮件发送至 Kindle 地址

⚠️ 始终在发送前生成并包含封面。 不得在无封面的情况下发送。

支持的站点

对于未列出的站点，请使用 --site custom --url <archive-url>。

封面生成

使用 nano-banana-pro 技能生成封面。提示模板如下：

[作者名]: [副标题] 的书籍封面。
极简设计，优雅排版。
[品牌色] 作为点缀色。
干净的白色或米色背景。
与 [主题] 相关的简单几何或抽象图案。
具有专业文学质感。
禁止使用照片、人物形象。
纵向布局，符合书籍封面尺寸。

建议以 2K 分辨率生成，保证质量的同时文件大小适中。

Kindle 送达

默认 Kindle 地址（Simon）：simonpilkington74_8oVjpj@kindle.com

通过 AppleScript 调用 Mail.app 发送邮件。请确保：

• 发件邮箱已在 Kindle 授权列表中
• 文件大小不超过 50MB（EPUB 压缩效果良好）

状态追踪

状态文件存储在 ~/.clawdbot/state/blog-kindle/ 目录下：

• {site}-last-fetch.json - 上次抓取时间戳及文章数量
• {site}-sent.json - 已发送的文章 ID 列表

用于增量更新（仅抓取新文章）。

手动操作流程（无脚本时）

若无法使用脚本，可遵循以下步骤：

1. 抓取：使用 curl 获取归档页面 → 解析文章链接 → 逐个下载 → 转换为 Markdown
2. 合并：将 Markdown 内容拼接，添加 YAML frontmatter（包括标题、作者等信息）
3. 封面：通过 Nano Banana Pro 生成封面
4. 转换：运行 pandoc combined.md -o output.epub --epub-cover-image=cover.png --toc
5. 发送：使用 AppleScript 通过 Mail.app 发送附件

详细步骤请参见 references/manual-workflow.md。