用途：让智能体通过 Raindrop.io REST API 管理书签服务，使用 curl 和 jq 进行直接 REST 调用。官方文档位于 https://developer.raindrop.io/。
主要能力：书签（raindrops）的单条与批量增删改查、导出（csv/html/zip）；集合的创建、更新、删除、合并、清理与分享协作；标签的获取、重命名、合并与删除；高亮管理；筛选统计；用户信息读取与更新；导入解析与 URL 存在性检查；备份列表、生成与下载。
认证：按顺序解析令牌，先检查环境变量 RAINDROP_TOKEN，再检查对话上下文中用户提供的令牌，若都没有则用 AskUserQuestion 请求。验证命令： [ -n "$RAINDROP_TOKEN" ] && echo "Token available" || echo "Token not set"。个人开发可用测试令牌，在 https://app.raindrop.io/settings/integrations 生成，测试令牌不过期。请求需携带 Authorization: Bearer $RAINDROP_TOKEN 头。面向其他用户数据的应用需走 OAuth2 流程，访问令牌两周后过期，需用 refresh_token 刷新。
用法要点：基础地址 https://api.raindrop.io/rest/v1/，数据格式 JSON，时间戳为 ISO 8601，限流每分钟 120 次。collectionId 中 0 表示全部，-1 表示未分类，-99 表示回收站，正整数表示具体集合。分页为 page（从 0 开始）与 perpage（最大 50），返回数量少于 perpage 即末页。可用 jq 解析响应。
限制与注意事项：执行删除、批量更新、移动至回收站等破坏性操作前，必须用 AskUserQuestion 获得用户确认；只读 GET 请求无需确认。删除书签会先进入回收站（集合 ID -99），从回收站删除才永久清除。系统集合 -1 与 -99 不可移除。错误码包括 401 认证失败、403 权限不足、404 未找到、429 超限等，需按 HTTP 状态处理。更多细节可参考 search-operators.md、collections-sharing.md、highlights.md。