核心用法
Raindrop 技能是一套基于 Bash 的 CLI 工具，封装了 Raindrop.io 的 REST API，让用户无需打开浏览器即可管理书签库。核心功能覆盖三大场景：
检索与浏览：search 全文搜索、list 按收藏夹浏览、tags 查看标签分布、list-untagged 发现未整理的书签。支持分页 (--page, --limit) 和 JSON 输出便于脚本化。
组织与归档：create-collection 新建收藏夹、move/bulk-move 批量迁移、update 修改标签和标题。bulk-move 利用 Raindrop 批量 API（单次最多 100 条），效率远高于单条循环。
智能辅助：suggest 调用 AI 生成标签和标题建议，降低整理成本。Pro 用户还可使用 cache 获取永久存档副本。
配置简单，仅需在 ~/.config/raindrop.env 写入 API Token 即可使用。
显著优点
- 原生批量能力：
bulk-move直接对接 Raindrop 批量接口，避免脚本级循环，显著减少 API 调用次数 - Unix 哲学友好：所有输出可通过
--json管道化（jq/xargs），适合自动化工作流 - 速率控制内置：
--delay参数主动规避 API 限流，对大型库迁移至关重要 - 零依赖膨胀：仅依赖 bash/curl/jq/bc，无语言运行时负担
潜在局限
- 功能边界依赖上游：Raindrop 免费版有收藏夹数量、批量操作频率限制；Pro 功能（永久缓存）需付费
- 错误处理偏手动：Bash 脚本对 API 异常（5xx、限流）的自动重试机制未明确展示
- 无本地缓存：每次查询均直连 API，大量操作可能触发限流
适合人群
- 书签重度用户（>500 条）需定期整理归档
- 开发者构建自动化知识库工作流（如自动分类剪藏内容）
- 偏好终端效率、拒绝浏览器 tab 过载的极简主义者
常规风险
- Token 泄露：明文存储于
~/.config/raindrop.env，需确保目录权限 600 - 误操作不可逆：
delete和bulk-move无确认提示，脚本自动化前建议--json预览 - API 变更：Raindrop 非开源服务，接口变动可能导致脚本失效