高效整理云端书签库

基于 Raindrop.io 官方 API 的书签管理 CLI 工具，支持搜索、分类、批量操作，帮助用户高效整理云端书签库。

基本信息

• 技能名称?raindrop
• 中文名称?高效整理云端书签库
• 作者?velvet-shark
• 分类?效率
• 版本?v1.0.4
• 标签?productivity, content-media, api, automation, docs

使用方法

使用说明
核心用法
Raindrop Skill 是一个命令行书签管理工具，通过封装 Raindrop.io 官方 REST API，让用户无需打开网页即可完成书签的全生命周期管理。核心工作流包括：配置 API Token 后，使用 search 快速检索、、 list 浏览收藏夹、、 add 添加新链接、、 move / / bulk-move 批量整理分类，以及 update` 编辑标签和标题。支持 JSON 输出便于脚本化，内置分页和速率限制参数适配大规模操作。
显著优点

1. 效率提升 ：批量移动（bulk-move）支持单次处理 100 条书签，配合 --delay 参数智能规避 API 限流，相比网页操作效率提升数十倍。
2. 脚本友好 ： --json 输出与 jq 无缝集成，可嵌入自动化工作流，如定时清理其他书签、自动生成周报等。
3. 功能完整 ：覆盖读（搜索、统计、标签分析）写（增删改、批量操作）全场景，甚至支持 AI 标签建议（suggest 命令）。
4. 零学习成本 ：命令设计直观，参数命名符合 CLI 惯例，文档示例丰富，5 分钟即可上手。
   潜在缺点与局限性
5. 依赖外部服务 ：完全依赖 Raindrop.io 服务可用性，若官方 API 变更或限流策略调整，可能导致功能异常。
6. 本地环境依赖 ：需要预装 curl 、 、 jq 、 、 bc 等工具，Windows 用户需额外配置 WSL 或 Git Bash。
7. Token 管理负担 ：API Token 需用户手动从官网获取并配置，无 OAuth 流程，对非技术用户不够友好。
8. 功能边界 ：不支持离线访问、书签内容全文检索（仅标题/标签/URL 搜索）、团队协作权限管理等高级功能。
   适合的目标群体
   开发者/工程师 ：习惯终端工作流，需要将书签管理集成到日常脚本或自动化流程中。
   知识管理重度用户 ：收藏夹数千条、依赖标签体系组织信息，需要批量整理工具解决"收藏即遗忘"痛点。
   Raindrop.io 付费用户 ：Pro 功能的缓存（cache）命令需订阅支持，付费用户可解锁完整能力。
   使用风险
9. API 限流风险 ：Raindrop.io 对免费账户有请求频率限制，大规模批量操作可能触发限流，需合理设置 --delay 。
10. Token 泄露风险 ：Token 以明文存储于本地文件，若设备共享或配置不当，可能导致书签数据被他人访问。
11. 误操作风险 ： delete 和 bulk-move 无二次确认，脚本执行前建议先用 --json 预览目标数据。
12. 网络稳定性 ：批量操作中断后无断点续传机制，需自行记录处理进度。