SuperAPI AI 工具集

raindrop

办公与效率

查看项目

更新于 10-15 21:53

技能介绍

用途:通过 Raindrop.io REST API 管理书签、收藏夹、标签与高亮,适合在用户提到 raindrop、书签、保存链接、整理 URL 时使用。

前置条件:需设置 RAINDROP_TOKEN 环境变量。未配置时,需在 https://app.raindrop.io/settings/integrations 创建应用、生成测试令牌,并将 export RAINDROP_TOKEN="..." 加入 ~/.zshrc.local。

认证与地址:所有请求需带 Authorization: Bearer $RAINDROP_TOKEN,基础 URL 为 https://api.raindrop.io/rest/v1/。

辅助脚本:使用 scripts/raindrop.sh 调用 API,例如: ./scripts/raindrop.sh GET /collections ./scripts/raindrop.sh POST /raindrop '{"link":"https://example.com","pleaseParse":{}}' ./scripts/raindrop.sh PUT /raindrop/123 '{"tags":["new-tag"]}' ./scripts/raindrop.sh DELETE /raindrop/123

主要能力:收藏夹支持列出根级、子级、获取单个、创建、更新、删除;书签支持列出、获取、创建、更新、删除与搜索;标签支持列出全部、按收藏夹列出、重命名、删除;高亮支持列出全部、按收藏夹列出,以及通过更新书签增删改。特殊收藏夹 ID:0 表示全部,-1 表示未分类,-99 表示回收站。高亮颜色包括 blue、brown、cyan、gray、green、indigo、orange、pink、purple、red、teal、yellow。

常用操作:创建书签可带自动解析;搜索支持 #tag、type:article、domain:example.com、created:>2024-01-01、important:true 等操作符;可创建收藏夹、为书签添加高亮、批量打标签;导出收藏夹支持 csv、html、zip 格式。

限制:速率限制为每分钟 120 次请求,可通过 X-RateLimit-Limit、RateLimit-Remaining、X-RateLimit-Reset 响应头查看。完整端点文档见 references/API-REFERENCE.md。