Readwise & Reader

核心用法

Readwise Skill 提供两大功能模块：

Readwise Highlights（高亮笔记）

• 列出所有书籍/来源
• 按书籍获取高亮内容
• 全文搜索高亮笔记
• 批量导出（支持时间过滤）

Reader（稍后读）

• 列出文档（支持位置筛选：new/later/archive/feed）
• 按类型过滤（article/book/podcast 等）
• 获取单篇文档详情
• 保存 URL 到 Reader
• 搜索已存文档

所有命令输出 JSON 格式，便于脚本集成和自动化处理。

显著优点

• 官方 API 支持：基于 Readwise 官方 API，数据获取稳定可靠
• 功能完整：覆盖高亮管理和稍后读两大核心场景
• 结构化输出：JSON 格式方便与其他工具链集成
• 灵活筛选：支持时间、位置、类型等多维度过滤

潜在局限

• 速率限制：Readwise 限制 20 请求/分钟，大批量导出需分页处理
• Token 依赖：需手动获取并配置 API Token
• Node 环境依赖：要求本地安装 Node.js 运行时
• 无实时同步：非双向同步，仅支持读取和单方向保存

适合人群

• Readwise/Reader 付费订阅用户
• 需要自动化处理笔记的 PKM（个人知识管理）用户
• 希望将高亮数据导入 Obsidian/Notion 等工具的内容创作者

常规风险

• Token 安全：API Token 需妥善保管，避免泄露
• 速率超限：频繁调用可能触发限流，建议添加请求间隔
• 数据隐私：笔记内容通过 API 传输，需确认网络环境安全

核心用法

Readwise Skill 是官方 API 的轻量级 Node.js 客户端，整合 Readwise 高亮管理 与 Reader 稍后阅读 两大功能：

| 场景 | 命令示例 |

|------|---------|

| 浏览书籍 | `readwise.mjs books --limit 20` |

| 获取高亮 | `readwise.mjs highlights --book-id 123` |

| 搜索笔记 | `readwise.mjs search "关键词"` |

| 导出全部 | `readwise.mjs export --updated-after 2024-01-01` |

| Reader 列表 | `reader.mjs list --location later` |

| 保存文章 | `reader.mjs save "https://..." --location later` |

| Reader 搜索 | `reader.mjs search "关键词"` |

仅需配置 READWISE_TOKEN 环境变量即可使用，所有命令输出 JSON 便于自动化处理。

显著优点

• 零依赖攻击面：纯 Node.js 内置 fetch，无 npm 供应链风险
• T1 官方来源：readwise.io 为知名阅读服务，API 文档完善
• 隐私安全：Token 仅通过环境变量读取，无硬编码泄露风险
• TLS 全加密：所有通信强制 HTTPS，符合 GDPR/CCPA 合规要求
• 功能双向：既支持回顾历史高亮，也支持收藏新文章

潜在局限

• 速率限制：Readwise API 限流 20 次/分钟，批量导出需分页处理
• 仅官方功能：无法绕过 Readwise 付费墙，依赖官方服务可用性
• 无本地缓存：每次查询实时请求 API，离线不可用
• Node 环境依赖：需预装 Node.js，非纯 shell 方案

适合人群

• 深度阅读者：需要回顾 Kindle/Instapaper/Apple Books 等跨平台高亮
• 知识管理用户：将 Readwise 作为第二大脑，需自动化导出笔记
• 稍后阅读重度用户：Reader 替代 Pocket/Instapaper 的场景
• 自动化爱好者：通过 JSON 输出对接 Obsidian、Notion 等工具链

常规风险与建议

1. Token 保管：READWISE_TOKEN 具有完整 API 权限，勿提交至代码仓库
2. 速率意识：批量操作时建议添加 3 秒间隔，避免触发 429 限流
3. 数据边界：Reader save 操作会写入云端，确认 URL 合规性
4. 服务依赖：Readwise 为商业服务，需持续关注订阅状态与 API 变更