核心用法
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 传输,需确认网络环境安全