用途:netlify-pp-cli 是驱动 Netlify API 的命令行工具,在官方 netlify-cli 的无状态、按站点操作之外,把账号下的站点、部署、DNS、环境变量和表单提交同步到本地 SQLite 镜像,从而支持整账号范围的查询与审计。
主要能力:overview 用一个命令查看所有站点的构建状态、最近部署时间和表单数量;env-drift 比较各站点/上下文中环境变量的差异,找出某些站点缺失或取值不同的变量;dns-audit 汇总所有区域的 DNS 记录并标记指向已删除站点的记录和即将过期的 SNI 证书;submissions search 对所有表单提交做离线全文搜索;since 显示某时间窗口内所有站点的部署与构建;deploy-diff 在本地镜像中并排比较同一站点的两次部署;此外还有 accounts、billing、builds、deploy-keys、deploys、dns-zones、forms、hooks、oauth、services、sites、user 等命令。
使用方式:先安装并验证二进制。安装命令:npx -y @mvanhorn/printing-press-library install netlify --cli-only;验证:netlify-pp-cli --version。安装失败时可回退:go install github.com/mvanhorn/printing-press-library/library/cloud/netlify/cmd/netlify-pp-cli@latest。认证:netlify-pp-cli auth setup,然后 netlify-pp-cli auth set-token YOUR_TOKEN_HERE,或设置 NETLIFY_AUTH_TOKEN,并用 netlify-pp-cli doctor 验证。任何命令加 --agent 等价于 --json --compact --no-input --no-color --yes;可用 --select 裁剪字段、--dry-run 预览、--deliver 输出到 file 或 webhook。读取类命令返回含 meta.source(live/local)与 results 的信封结构。不知用哪个命令时可执行 netlify-pp-cli which "<自然语言描述>"。也可安装 MCP 服务:go install github.com/mvanhorn/printing-press-library/library/cloud/netlify/cmd/netlify-pp-mcp@latest,再执行 claude mcp add netlify-pp-mcp -- netlify-pp-mcp。
适用场景:管理多个 Netlify 站点、发布前排查环境变量、跨表单查找线索、事故后回顾部署、清理站点后审计 DNS,以及需要结构化 JSON 输出的智能体调用。
限制:不用于运行本地开发服务器或 netlify dev(请用官方 netlify-cli),也不用于构建或打包站点资源;它通过 API 管理账号,不编译站点。需先安装并验证 CLI,且安装目录必须在 PATH 中。路径可用 --home 或 NETLIFY_HOME 及各 kind 环境变量调整;凭据默认存放在数据目录的 credentials.toml。反馈默认仅保存在本地 feedback.jsonl,除非设置 NETLIFY_FEEDBACK_ENDPOINT 并显式发送。其余细节暂未提供。