核心用法
Instapaper CLI（ip）是一款面向 Instapaper 书签服务的命令行工具，提供完整的 CRUD 操作、批量处理及自动化支持。核心功能涵盖：
- 认证管理：通过
INSTAPAPER_CONSUMER_KEY和INSTAPAPER_CONSUMER_SECRET环境变量或命令行参数完成 OAuth 认证，推荐--password-stdin避免密码泄露 - 数据读取：
list/export支持--cursor游标分页、--since/--until时间边界、--updated-since增量同步，配合--select实现客户端过滤 - 数据变更：
import/add/delete/move等操作支持--dry-run预演、--idempotent幂等执行、--batch批量处理及--stdin管道输入 - 富内容获取：
text抓取文章正文 HTML，highlights管理标注，folders管理文件夹结构 - 输出格式：默认
--ndjson流式输出，可选--json紧凑数组、--plain纯文本；--stderr-json与--progress-json支持结构化日志与进度追踪
显著优点
1. 自动化友好：完整的退出码体系（见 references/errors.md）、结构化错误输出、游标分页机制，便于集成 CI/CD 与定时任务
2. 数据可移植：支持 JSON/NDJSON/Plain 多格式导出，配合 --output-dir 实现大规模归档
3. 增量同步：--updated-since 配合本地状态文件，可高效实现增量备份
4. 安全性设计：--password-stdin 避免命令历史泄露，环境变量隔离敏感凭证
潜在局限
- 依赖外部服务：Instapaper API 稳定性直接影响工具可用性，2018 年后官方维护力度减弱
- 功能边界：无法导出完整原始网页，仅提供 Instapaper 解析后的文本/HTML
- 速率限制：未明确文档化，大规模批量操作可能触发限流
- 平台依赖：需手动安装
ip二进制并维护 PATH，无包管理器官方分发
适合人群
- 需要构建个人阅读归档系统的开发者与高级用户
- 寻求替代官方网页/APP 自动化方案的 Instapaper 重度用户
- 希望将书签数据集成至 Notion/Obsidian 等知识库的工具链整合者
- 具备基础命令行与 API 概念的技术用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | 密码硬编码或命令历史残留 | 始终使用 `--password-stdin` 与环境变量 |
| 数据丢失 | 误删操作无回收站机制 | 导出前执行 `--dry-run`，保留本地备份 |
| 同步冲突 | 多客户端同时修改书签状态 | 采用游标同步策略，避免并发写入 |
| 服务中断 | Instapaper API 变更或下线 | 定期全量导出，保持数据本地副本 |