Raindrop.io Bookmarks
2026-04-01
新闻来源：网淘吧
围观:15
电脑广告
手机广告
Raindrop.io 书签管理
通过 Raindrop.io API 管理书签。
设置
# Get token from: https://app.raindrop.io/settings/integrations → "Create test token"
echo 'RAINDROP_TOKEN="your-token"' > ~/.config/raindrop.env
# Or pass token at runtime (recommended for ephemeral use)
{baseDir}/scripts/raindrop.sh --token "your-token" whoami
快速开始
# Search bookmarks
{baseDir}/scripts/raindrop.sh search "AI tools"
# List unsorted bookmarks
{baseDir}/scripts/raindrop.sh list -1 --limit 50
# Count unsorted
{baseDir}/scripts/raindrop.sh count -1
# Create collection and move bookmarks
{baseDir}/scripts/raindrop.sh create-collection "AI Coding"
{baseDir}/scripts/raindrop.sh move 12345 66016720
# Bulk move (efficient!)
{baseDir}/scripts/raindrop.sh bulk-move "123,456,789" 66016720
命令
查阅
| 命令 | 描述 |
|---|---|
whoami | 显示已认证用户 |
collections | 列出所有收藏夹及其ID |
list [ID] | 列出书签（默认：0 = 全部） |
count [ID] | 统计收藏夹中的书签数量 |
search QUERY [ID] | 搜索书签 |
get ID | 获取书签详情 |
tags | 列出所有标签及其数量 |
list-untagged [ID] | 查找无标签的书签 |
cache ID | 获取永久副本（仅限专业版） |
编写
| 命令 | 描述 |
|---|---|
添加 URL [ID] | 添加书签（默认值：-1 = 未分类） |
删除 ID | 删除书签 |
创建集合 名称 | 创建新集合 |
移动 ID 集合 | 将书签移动到集合 |
更新 ID [选项] | 更新标签/标题/集合 |
批量移动 IDS 目标 [来源] | 移动多个书签（来源默认为 -1/未分类） |
建议 URL | 获取 AI 建议的标签/标题 |
选项
| 标志 | 描述 |
|---|---|
--json | 原始 JSON 输出 |
--limit N | 最大结果数（默认：25） |
--页面 N | 分页（从0开始索引） |
--延迟 毫秒 | API调用之间的延迟（速率限制） |
--令牌 TOKEN | 覆盖API令牌 |
更新选项
对于更新命令：
| 标志 | 描述 |
|---|---|
--标签 TAG1,TAG2 | 设置标签（逗号分隔） |
--标题 TITLE | 设置标题 |
--收藏夹 ID | 移动到收藏夹 |
收藏夹ID
0= 所有书签-1= 未分类-99= 回收站N= 特定收藏夹 (从收藏夹获取ID
)
# List unsorted with pagination
{baseDir}/scripts/raindrop.sh list -1 --limit 50 --page 0
{baseDir}/scripts/raindrop.sh list -1 --limit 50 --page 1
# Create collection
{baseDir}/scripts/raindrop.sh create-collection "AI Coding"
# Output: Created: AI Coding / ID: 66016720
# Move single bookmark
{baseDir}/scripts/raindrop.sh move 1234567 66016720
# Update bookmark with tags and move
{baseDir}/scripts/raindrop.sh update 1234567 --tags "claude-code,workflow,tips" --collection 66016720
# Bulk move with rate limiting (100ms between calls)
{baseDir}/scripts/raindrop.sh bulk-move "123,456,789,101112" 66016720 --delay 100
# Find untagged bookmarks in unsorted
{baseDir}/scripts/raindrop.sh list-untagged -1 --limit 100
# Get JSON for scripting
{baseDir}/scripts/raindrop.sh list -1 --json --limit 50 | jq '.items[]._id'
# Count unsorted bookmarks
{baseDir}/scripts/raindrop.sh count -1
示例
批量操作对于大型批量操作，请使用bulk-move
# Get IDs from unsorted
ids=$({baseDir}/scripts/raindrop.sh list -1 --json --limit 100 | jq -r '[.items[]._id] | join(",")')
# Move all to collection
{baseDir}/scripts/raindrop.sh bulk-move "$ids" 66016720
它使用Raindrop批量API（每个请求最多100个项目）：
速率限制
- Raindrop API有速率限制。对于批量操作：
使用--delay 100 - （调用间隔100毫秒）
使用bulk-move而不是单独的move - 调用
以50-100个为一组进行处理
直接API
source ~/.config/raindrop.env
# Update tags
curl -X PUT "https://api.raindrop.io/rest/v1/raindrop/ID" \
-H "Authorization: Bearer $RAINDROP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tags": ["tag1", "tag2"]}'
# Bulk update (up to 100 IDs)
curl -X PUT "https://api.raindrop.io/rest/v1/raindrops" \
-H "Authorization: Bearer $RAINDROP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"ids": [123, 456, 789], "collectionId": 12345}'
对于未涵盖的操作：API文档：
微信扫一扫，打赏作者吧～文章底部电脑广告
手机广告位-内容正文底部
