用途:这是一个面向 Raindrop.io 的 Go 命令行工具(二进制名 raindrop-pp-cli),用于完成书签管理相关的 REST API 操作,并附带同名 MCP 服务,把同一套命令树暴露给智能体。
安装:npx -y @mvanhorn/printing-press-library install raindrop --cli-only;验证 raindrop-pp-cli --version。若 npx 安装失败,可用 Go 1.26.6 以上执行 go install github.com/mvanhorn/printing-press-library/library/productivity/raindrop/cmd/raindrop-pp-cli@latest。需确保安装目录在 PATH 中。
主要能力:bookmark_transfer 负责导出、导入与从 URL 导入书签;collection / collections 管理集合的创建、更新、删除、排序与清空回收站;raindrop / raindrops 提供书签的创建、更新、软删除、批量更新删除、批量打标签、跨集合移动与搜索;tags 支持标签列举、重命名合并与批量删除;highlights 管理高亮增删改查;file 管理上传文件;user 获取资料与统计;filters 返回可用筛选条件。此外提供 SQLite 本地同步(sync)、快照间字段级变更(changes)、收件箱可续审阅(inbox review)、标签健康检查(tag health)、重复书签规划(duplicates plan)、历史回访(revisit)、离线关联查找(related)与高亮摘要(highlights digest)等能力。
使用方式:通过 RAINDROP_TOKEN、raindrop auth set-token 或 .raindrop-token 提供令牌,令牌仅以 Authorization: Bearer 发往 api.raindrop.io。任意命令可加 --agent,等价于 --json --compact --no-input --no-color --yes;可用 --select 裁剪字段,--dry-run 预览请求。输出包裹在 meta/results 信封中,从 .results 取数据、.meta.source 判断来源是实时还是本地。路径可用 --home 或 RAINDROP_HOME 等环境变量重定位。
限制:需先安装并验证 CLI 才可调用;MCP 不继承命令行参数,需在宿主配置中通过环境变量传递;涉及创建、删除的幂等与忽略缺失行为需显式指定标志;部分高级能力依赖本地 SQLite 存储是否可用;令牌与路径的具体默认值随平台不同。