Instapaper CLI（命令行工具）是一个专为开发者设计的自动化接口，用于高效管理和操作 Instapaper 书签服务。该工具通过 `ip` 命令提供对 Instapaper 账户的完全控制，支持认证、书签增删改查、文件夹管理、高亮标注以及文本内容提取等核心功能。其设计重点在于结构化输出与脚本友好性，特别适合集成到自动化工作流中。默认采用 NDJSON 流式输出格式，确保大规模数据导出时的稳定性和可解析性，同时支持 JSON 和纯文本格式以满足不同场景需求。此外，工具内置了完善的错误处理机制，可通过 stderr-json 捕获结构化错误信息，并结合退出码实现可靠的自动化故障排查。
核心功能特点
- 支持基于 OAuth 的认证流程，推荐使用 `–password-stdin` 安全输入密码
- 提供三种输出格式：NDJSON（默认，适合流式处理）、JSON（单对象/数组）和 Plain（稳定文本）
- 支持游标分页与时间范围查询，实现增量同步与确定性数据读取
- 具备批量操作能力，包括批量删除、导入导出及客户端过滤（`–select`）
- 集成调试模式（`–debug`）与结构化错误输出（`–stderr-json`），便于自动化监控
- 支持文章文本提取（`ip text`）、高亮管理与文件夹排序等高阶功能
适用场景
Instapaper CLI 特别适合需要定期同步或批量处理书签的开发者与运维人员。例如，在构建个人知识管理系统时，可利用 `export –since` 参数配合 cron 定时任务，自动将新增书签同步至本地数据库或笔记应用；若需清理过期收藏，则可通过 `–dry-run` 预览变更后再执行实际删除操作，避免误删风险。对于内容创作者而言，结合 `text` 命令可将保存的文章原始 HTML 转换为可读文本，便于后续摘要生成或归档分析。在企业级场景中，该工具还可用于审计用户书签行为——通过 `–cursor-dir` 遍历所有条目并导出为 NDJSON，再交由数据分析管道进行聚类统计。由于其对结构化输出的严格遵循，无论是集成 CI/CD 流水线还是开发自定义书签机器人，Instapaper CLI 都能提供一致且可靠的操作体验。