📦 Raindrop.io 书签管理器

Raindrop.io Bookmark Manager 通过本地 CLI 使用官方 Raindrop.io API，CLI 从 skill 文件夹外的本地 .env 文件读取密钥。

本地密钥存储 将真实凭据存放在 skill 文件夹之外。 推荐做法：

• 设置 RAINDROP_ENV_FILE 指向本地 env 文件，或
• 直接在 shell 导出 RAINDROP_CLIENT_ID、RAINDROP_CLIENT_SECRET、RAINDROP_ACCESS_TOKEN，可选 RAINDROP_REFRESH_TOKEN

skill 发布时无需在文件夹内嵌入密钥。 env 文件示例见：references/env-example.md

快速开始 验证身份： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py whoami

启动 OAuth（不自动打开浏览器）： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py auth-start --no-browser

用返回的 code 完成 OAuth： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py auth-finish --code "PASTE_CODE_HERE"

刷新 OAuth token： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py refresh-token

列出顶级收藏夹： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py collections

列出嵌套收藏夹： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py collections --children

列出收藏夹内书签（每页 20 条）： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py bookmarks 0 --perpage 20

在收藏夹内搜索书签： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py bookmarks 0 --search "etsy" --perpage 20

创建收藏夹： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py create-collection --title "Research" --view list

保存单个书签： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py add-bookmark --collection-id 123456 --link "https://example.com" --title "Example"

导出书签链接： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py export-bookmarks 123456 --format csv --output "C:\path\to\raindrop-export.csv"

从 txt 列表导入书签： python .\skills\raindrop-io-bookmark-manager\scripts\raindrop_manager.py import-bookmarks --input "C:\path\to\urls.txt" --collection-id 123456 --output "C:\path\to\results.json"

工作流

• 将 Raindrop 凭据放入环境变量或本地 env 文件。
• 使用测试 token 或内置 OAuth 流程。
• 新配置先运行 whoami 验证。
• 用 collections 获取目标收藏夹 id。
• 用 bookmarks 加 --search 查看已存链接。
• 用 create-collection、update-collection、delete-collection 管理收藏夹。
• 用 add-bookmark、update-bookmark、delete-bookmark 管理单条书签。
• 用 import-bookmarks、export-bookmarks 批量操作。

命令 whoami — 验证身份并查看账户信息 auth-start [--no-browser] — 生成 OAuth 授权 URL auth-finish --code CODE — 用 OAuth code 换 token 并本地保存 refresh-token — 刷新 OAuth token 并本地保存 collections [--children] — 列出根或嵌套收藏夹 collection-get — 查看单个收藏夹 create-collection --title NAME — 创建收藏夹 update-collection ... — 更新收藏夹 delete-collection — 删除收藏夹 bookmarks [--search TEXT] — 列出/搜索收藏夹内书签 bookmark-get — 查看单个书签 add-bookmark --collection-id ID --link URL — 保存书签 update-bookmark ... — 编辑书签 delete-bookmark — 删除书签 export-bookmarks --format json|txt|csv --output file — 导出书签 import-bookmarks --input file --collection-id ID — 从 txt 或 json 导入书签 env-template — 打印或写入本地 env 模板

列表/导出命令支持额外过滤： --tag、--domain、--contains 多数命令支持 --csv 输出更扁平的 stdout。

OAuth / 回调说明 本地桌面场景请用： http://127.0.0.1:8765/callback 也可加： http://localhost:8765/callback

仅本地自动化时，Raindrop 测试 token 通常比交互式 OAuth 更简单。

资源 scripts/ raindrop_manager.py — 本地 Raindrop.io CLI，支持 auth、收藏夹、书签、导入、导出

references/ api-notes.md — 端点说明与字段提示 env-example.md — 本地 env 文件非密钥示例