核心用法
raindrop-cli 是一款面向 Raindrop.io 的命令行书签管理工具，通过封装 Raindrop REST API 实现收藏夹、搜索、存在性检查、添加、更新和删除等全生命周期操作。
功能矩阵
| 命令 | 作用 | 典型场景 |
|------|------|---------|
| `collections` | 列出所有收藏夹 | 初始化时查看结构 |
| `search` | 全文检索书签 | 快速定位历史收藏 |
| `exists` | 检查 URL 是否已存在 | 去重前置校验 |
| `add` | 添加新书签 | 自动化采集管道 |
| `update` | 修改标题/元数据 | 批量整理归档 |
| `remove` | 删除指定 ID | 清理失效链接 |
显著优点
1. 去重机制健全：内置 exists 检查，重复 URL 自动拦截，避免收藏夹臃肿
2. 安全默认值友好：未指定收藏夹时自动落入「Unsorted」，降低误操作风险
3. API 原生封装：直接调用官方 REST 端点，无中间代理，数据主权清晰
4. 标签与收藏夹双维度：支持 --tags 和 --collection 组合，灵活适配多层分类体系
5. Token 隔离存储：建议存放于 ~/.config/openclaw/gateway.env，权限可控（chmod 600）
潜在局限
- 依赖网络连通性：纯 API 驱动，离线场景不可用
- 无本地缓存层：高频查询可能触发速率限制（Raindrop Pro 用户限额较高）
- ID 操作门槛：
update/remove依赖数字 ID，需先通过search获取，交互链略长 - Token 泄露风险：环境变量文件若权限配置不当，存在凭证暴露隐患
适合人群
- 使用 Raindrop.io 作为主要书签中枢的开发者、研究员、知识工作者
- 需将浏览器外内容（RSS、爬虫、脚本输出）自动化入库的技术用户
- 偏好 CLI 工作流、追求「采集-整理-检索」全链路自动化的效率极客
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 误删 | `remove` 操作不可逆 | 执行前先用 `search` 确认目标 |
| Token 泄露 | 环境文件权限过宽 | 严格设置 `chmod 600`，避免提交至版本控制 |
| 收藏夹污染 | 自动化脚本标签策略混乱 | 约定标签命名规范，定期人工审计 |
| API 限流 | 高频批量操作触发 429 | 添加请求间隔或降级至官方 Web 界面 |
> 兼容性提示：Raindrop.io API 偶有字段变更，建议锁定脚本版本并关注官方 Changelog。