mvanhorn/cli-printing-press

开发工具

把 API、规范、HAR 或网站转成适合智能体反复调用的 Go CLI 和 MCP 服务。

4,861
531
Go
MIT
创建于 7 个月前

如果你经常手写 CLI 包装层以便智能体调用某个服务,这个项目值得一看;但先准备好 Go 环境和经过验证的智能体工作流。

解决什么问题

你想让智能体使用第三方 API。现在的通常做法是:先找规范,再挑出有用的接口,然后写参数解析、处理鉴权,最后还要面对智能体因为 CLI 没有说明成功和失败长什么样而乱试参数的问题。换一个服务,这套脚手架就要重来一遍。Printing Press 想缩短这个过程:在智能体会话里点名一个 API,它会根据规范、HAR 抓包或仅一个网址生成 Go CLI 和 MCP 服务,并对生成结果做一轮验证 项目说明。

有什么不同

它不是单纯把接口包一层。生成器会加一个本地数据层:对高频资源建领域相关的 SQLite 表,配 FTS5 全文搜索、带游标记录的增量 sync 和 sql 查询,让智能体可以缓存数据、离线检索,而不是每次都把整个 API 拉一遍。它还会生成复合命令,并提炼作者所说的 API“非显然洞察”,用一句话重新定义这个 API 的用途,再据此设计命令。输出也针对智能体调用做了细节处理:带类型的退出码、--compact 输出、管道时自动转 JSON。

整个流程被拆成命名阶段:从解析规范、盘点生态、生成,到一段验证,再到可选的只读在线冒烟测试。这也是主要的取舍。工具主推通过斜杠命令驱动,作者给出的时间表里,研究和设计阶段就占 5 到 20 分钟,而不是一条命令即时出结果。README 对评分的说法也很直接:高分只代表结构符合模板,不等于真正用一下午。生成代码应视为需要审阅的草稿,写入路径尤其如此,因为在线验证只做只读检查 限制说明。

谁值得试

适合反复为文档混乱或缺失的服务生成可被智能体调用 CLI 的开发者,并且愿意读生成的 Go 代码、动手改。离线 SQLite 和搜索层对智能体反复问相似问题的 API 最有用。不太适合只偶尔需要一个一次性包装层的人,或者不打算使用经过测试的 Claude Code 流程的人:二进制可以单独用,Codex 也有安装文档,但作者说精心设计的循环先在 Claude Code 上测试,Codex 的行为可能落后 安装说明。如果团队无法审阅生成代码,或不接受以违反服务条款的方式访问服务,请先读限制部分。

使用条件与边界

安装需要同时装 Go 二进制和 skills,缺一半都用不起来。这意味着要 Go 1.26.10 或更新版本、用 npx 所需 Node/npm,以及能加载 skills 的智能体 安装步骤。默认测试路径是 Claude Code。安装还涉及 PATH 和鉴权检查,这些问题可能静默失败,README 为此专门写了排障说明,而不是一条顺利的安装命令。

后续维护的约束更大。生成的 CLI 被描述为覆盖智能体重度用户的表面,而不是替代厂商官方 CLI。技术上能生成客户端,和法律上被允许使用是两件事,必须自行审查服务条款。浏览器抓包需要手动操作,遇到 websocket、gRPC 或严格反爬的站点可能拿不到有用接口,这时可以改用 HAR 导入。用于在重新生成时保留本地修改的 regen-merge 仅在 macOS 和 Linux 支持。目前也没有独立分发包,斜杠命令是受支持的入口。

HotRepo 点评

HotRepo 唯一有日期的观测是 2026-10-28:仓库 4,859 颗星,当天日榜增加 7 颗,在新项目榜排第 4 趋势快照。只有一个上榜日的记录,无法判断热度能否持续;这只是一个快照,不是势头。真正要判断的不是星数,而是生成出来的 CLI 在你实际会写入的路径上能否通过审阅。决定投入前,先生成一个,检查它的鉴权处理、写命令,以及同步和缓存行为是否符合你的使用场景。

本文由 AI 根据项目 README 生成,更新于 2026年10月28日,以项目官方文档为准。

Hacker News 讨论

CLI Printing Press – create go CLI tool from any API
▲ 7 · 0 条评论 · 2026年5月7日