Atoship
文档
帮助中心GitHub

CLI

在终端里就能发货。一条命令搞定比价、购买面单、追踪包裹——无需打开浏览器。

@atoship/cli
v1.0.1
6 条命令

以前

打开承运商网站 → 输入地址 → 在多个标签页之间比价 → 下载面单 → 复制粘贴追踪单号

现在

ship rate --from 90001 --to 10001 --weight 2oz --cheapest

安装

全局安装——安装后 ship 命令即可在系统任意位置使用。

npm install -g @atoship/cli

初始配置——保存你的 API 密钥

在 Dashboard → Settings → API Keys 中获取密钥。生产环境使用 ak_live_， 开发环境使用 ak_test_（测试面单免费）。

# 保存你的 API 密钥（存储在 ~/.config/atoship/config.json）
ship config set-key ak_live_your_key_here

# 或使用环境变量
export ATOSHIP_API_KEY=ak_live_your_key_here

命令

6 条命令覆盖完整的发货流程。

ship rate

实时比价 USPS、FedEx、UPS 三家运费

ship rate --from "LA, CA 90001" --to "NY, NY 10001" --weight 2oz --cheapest
ship buy

购买运输面单并获取追踪单号

ship buy --rate rate_abc123 --from "John|123 Main St|LA|CA|90001" --to "Jane|456 Oak Ave|NY|NY|10001"
ship track

追踪包裹，查看完整物流轨迹

ship track 9400111899223456789012 --watch
ship labels

列出并筛选你的运输面单

ship labels --status shipped --carrier FEDEX
ship balance

查看钱包余额与账户信息

ship balance
ship config

管理 API 密钥与 CLI 配置

ship config set-key ak_live_your_key_here

比较 USPS、FedEx、UPS 的运费。支持城市/州、邮编或完整地址输入。

# 比较所有承运商
ship rate --from "Los Angeles, CA 90001" --to "New York, NY 10001" --weight 2oz

# 仅显示每家承运商的最低价
ship rate --from-zip 90001 --to-zip 10001 --weight 1lb --cheapest

# 按承运商筛选
ship rate --from "LA, CA" --to "NY, NY" --weight 16oz --carrier USPS,FEDEX

# 附带尺寸
ship rate --from "LA, CA" --to "NY, NY" --weight 2oz --length 12 --width 8 --height 6

为什么用 CLI？

快

从订单到面单，一条命令搞定。无需浏览器，无需点击，也不用等页面加载。

可脚本化

把 --json 输出接入 jq、脚本或 webhook。在 CI/CD 流水线中自动购买面单。

监控模式

ship track --watch 每 5 分钟轮询一次，包裹送达时立即提醒你。

配置

变量说明
ATOSHIP_API_KEY你的 atoship API 密钥——会覆盖已保存的配置
ATOSHIP_BASE_URL自定义 API 基础地址（默认：https://atoship.com）

使用 ship config set-key 时，配置文件保存在 ~/.config/atoship/config.json。

需要帮助？发邮件至 [email protected]——我们会在一个工作日内回复。

atoship © 2026