Instapaper书签管理

技能简介

该技能用于通过 ip 命令行工具操作 Instapaper 书签服务，支持认证、列表查询、批量导入导出、文件夹与高亮管理，以及结构化输出格式的自动化处理。

能做什么

• 完成 OAuth 认证并管理登录状态
• 列出、导出、导入书签，支持增量同步与游标分页
• 批量移动、删除、归档书签，支持幂等操作与试运行模式
• 管理文件夹（创建、删除、排序）与高亮标注
• 获取文章原始 HTML 文本内容
• 输出 NDJSON/JSON/纯文本格式，配合结构化错误流实现自动化流水线

使用说明

1. 安装 CLI 工具
   Go 安装：go install github.com/vburojevic/instapaper-cli/cmd/ip@latest
   Homebrew 安装：brew tap vburojevic/tap && brew install instapaper-cli
   源码编译：go build ./cmd/ip（运行时使用 ./ip）
2. 配置环境变量
   设置 INSTAPAPER_CONSUMER_KEY 和 INSTAPAPER_CONSUMER_SECRET，或使用命令行参数传入
3. 执行登录
   推荐使用 --password-stdin 避免密码回显：echo '密码' | ip login --username xxx --password-stdin
4. 验证环境
   运行 ip doctor --json 或 ip auth status 确认配置正确
5. 选择输出格式
   默认 --ndjson 适合流式处理；--json 输出单对象；--plain 为行导向文本；追加 --stderr-json 获取结构化错误
6. 读取数据
   使用 ip list --cursor 或 --since/--until 限定范围；--updated-since 实现增量同步；--select 进行客户端过滤
7. 安全变更
   批量操作前加 --dry-run 预览效果；使用 --idempotent 避免重复执行；删除操作需显式确认标志
8. 故障排查
   加 --debug 查看请求耗时与状态码；结合 --stderr-json 和退出码映射实现自动重试逻辑

输入与输出

见下方输入与输出表格。

风险提示

• 避免使用 --format table 进行程序解析，该格式仅面向人工阅读
• 大规模导出时指定 --output 或 --output-dir，防止标准输出缓冲区压力
• Windows 环境下务必使用 --password-stdin，防止密码在终端回显
• 删除操作不可逆，生产环境建议先导出备份
• API 速率限制可能导致长时间任务中断，需配合游标与重试机制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/vburojevic/instapaper/SKILL.md
来源类型：开源社区技能文档