名称： blog-to-kindle
描述： 抓取博客/文章网站，编译为适合 Kindle 的 EPUB 格式，并生成 AI 封面。可用于下载博客到 Kindle、将文章合集制作成电子书，或将博客存档发送至 Kindle。支持 Paul Graham、Kevin Kelly、Derek Sivers、Wait But Why、Astral Codex Ten 及自定义网站。

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 前言（标题、作者）合并
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。