用途：用于评估、监控和报告通过 ShipsGo 跟踪的货运，覆盖海运（ocean）与空运（air）的创建、查询、更新、删除、关注人与标签管理等全量 API 操作，并在本地提供 API 之外的能力。不适用于向承运人订舱（应使用 TMS）或包裹/末端配送（应使用 Shippo 或 ShipEngine）。
主要能力：RFQ 工作流（rfq new 建立询价工作区、rfq compare 按承运人汇总实际运输天数与准时率、digest 生成货运状态表、followers-broadcast 批量增减关注人）；分析（lane stats 航线 p50/p90 运输天数与分承运人明细、eta-drift 列出 ETA 偏移超过阈值的运单、reliability 承运人准时率与偏差中位数）；本地状态（book 统一查看海空运、webhook tail 追溯里程碑历史）；额度控制（credit-budget 依据速率限制头与本地去重状态拒绝超额 POST、dupe-check 检查箱号或运单号是否已跟踪）。免费额度为 3 credits，速率限制为每分钟 100 次。
使用方式：需先安装并验证 CLI。安装命令为 npx -y @mvanhorn/printing-press-library install shipsgo --cli-only，验证命令为 shipsgo-pp-cli --version，并确保 $GOPATH/bin 或 $HOME/go/bin 在 $PATH 中；若安装失败可用 go install github.com/mvanhorn/printing-press-library/library/commerce/shipsgo/cmd/shipsgo-pp-cli@latest（需 Go 1.26.6 或更新）。认证通过设置环境变量 SHIPSGO_USER_TOKEN（令牌在 shipsgo.com/dashboard/air/integrations/api-tokens 创建），每次请求以 X-Shipsgo-User-Token 头发送，无需 OAuth；可用 shipsgo-pp-cli doctor 验证。任意命令可加 --agent（等价于 --json --compact --no-input --no-color --yes），支持 --select 字段裁剪、--dry-run 预览、--deliver 输出到 file: 或 webhook: 等。也可安装 MCP：claude mcp add shipsgo-pp-mcp -- shipsgo-pp-mcp。
限制：依赖 ShipsGo 账号与 API 令牌，受免费额度与速率限制约束；本地功能依赖本地 SQLite/去重状态；未提供自建服务器、离线同步冲突处理或价格方案等资料。