核心用法
Raindrop 技能提供完整的 Raindrop.io 书签管理 CLI 接口,覆盖读写全生命周期。核心场景包括:
- 检索与浏览:
search关键词搜索、list列出收藏夹、get获取详情、tags查看标签统计 - 组织整理:
create-collection创建收藏夹、move/bulk-move批量迁移、update修改标签/标题 - 批量操作:利用 Raindrop 原生批量 API,单次可处理 100 条书签,配合
--delay参数控制请求频率 - 数据导出:
--json模式输出原始数据,便于与jq等工具链式处理
显著优点
1. API 完整覆盖:读写操作齐全,包括 Pro 用户的 cache 永久存档功能
2. 批量效率:bulk-move 相比循环单条移动,API 调用量降低 99%+
3. Unix 哲学友好:纯文本输出、--json 模式、标准错误码,易于脚本化与自动化
4. 速率控制:内置 --delay 参数,避免触发 Raindrop API 限流
潜在局限
- 依赖外部服务:完全依赖 Raindrop.io 云端,断网或 API 变更即失效
- Token 管理:需手动配置
~/.config/raindrop.env,无 OAuth 流程,新手门槛略高 - 无本地缓存:除 Pro 用户的
cache命令外,无离线浏览能力 - 功能边界:高级功能如团队协作、公开收藏页管理未覆盖
适合人群
- 日均处理 50+ 书签的重度知识管理者
- 需要将书签工作流脚本化/自动化的开发者
- 跨平台使用 Raindrop,偏好终端效率的高级用户
常规风险
- Token 泄露:Bearer Token 存储于本地明文文件,多用户环境需设置文件权限 600
- 误操作不可逆:
delete、bulk-move无二次确认,建议操作前先用--json导出备份 - API 配额:免费用户可能受限于调用频率,大规模迁移需配合
--delay分批次执行