核心功能
raindrop 是一个基于 Raindrop.io API 的 CLI 工具,让用户无需离开终端即可完整管理书签库。支持完整的 CRUD 操作:搜索书签、浏览收藏夹、创建新收藏、添加/删除书签、批量移动、标签管理等。特别适合需要将书签管理集成到自动化脚本或日常命令行工作流的技术用户。
显著优点
1. 效率极高:批量移动(bulk-move)支持一次处理最多 100 个书签,配合 jq 可实现复杂的数据管道操作
2. 灵活配置:支持配置文件 (~/.config/raindrop.env) 和运行时参数 (--token) 两种认证方式,兼顾持久化与临时使用
3. 完整 API 覆盖:不仅封装了常用操作,还保留直接调用 REST API 的能力,可应对官方 API 支持但脚本未封装的高级需求
4. 开发友好:--json 输出模式便于与其他 CLI 工具链集成,配合 jq 可实现精准的数据提取和二次处理
潜在局限
- 依赖外部服务:完全依赖 Raindrop.io 官方 API 可用性,服务中断时功能受限
- 速率限制:API 存在调用频率限制,大规模批量操作需要手动设置
--delay参数 - 学习曲线:需要熟悉 Raindrop 的 collection ID 体系(如
-1= Unsorted,-99= Trash) - 仅支持 Pro 功能提示:
cache命令需要 Raindrop Pro 订阅
适合人群
- 重度 Raindrop.io 用户,书签数量庞大需要批量整理
- 开发者/技术写作者,习惯用终端和脚本自动化重复任务
- 需要将书签数据导入其他工具或进行自定义分析的用户
风险提示
- API Token 安全:
RAINDROP_TOKEN需要妥善保管,建议写入配置文件时设置 600 权限 - 批量操作不可逆:
bulk-move和delete操作前建议先--json导出备份 - 网络依赖:所有操作需联网,无离线缓存能力