cbs-cainiao-merchant-cli

跨境物流商家命令行工具（菜鸟站点），支持物流轨迹查询、面单获取、订单详情查询、产品推荐、理赔查询。

安装

npm install -g cbs-cainiao-merchant-cli

安装后命令名为 cmc。

快速开始

# 1. 获取 API Key
#    https://cainiao.4px.com/site/ak-manage

# 2. 配置认证
cmc auth login --api-key SK_xxxxx

# 3. 查询物流轨迹
cmc track get 4PX3000002316090CN

# 4. 查看订单详情
cmc order get 4PX3000002316090CN

# 5. 产品推荐
cmc product recommend --country US

# 6. 查询理赔
cmc claim list --biz-no 4PX3000002316090CN

命令列表

| 命令 | 说明 | |------|------| | cmc auth login --api-key <key> | 配置 API Key | | cmc auth status | 查看当前认证状态 | | cmc config set <key> <value> | 设置配置项 | | cmc config list | 查看当前配置 | | cmc track get <orderNo> | 查询物流轨迹 | | cmc label get <orderNo> | 获取面单打印信息（PDF 链接） | | cmc order get <orderNo> | 获取订单详情 | | cmc product recommend --country <code> | 产品推荐（按目的国查询） | | cmc claim list | 查询理赔列表 | | cmc update | 更新到最新版本 | | cmc update --check | 检查是否有新版本 |

全局选项

| 选项 | 说明 | |------|------| | --output <format> | 输出格式：text（默认）/ json | | --verbose | 打印请求详情 | | --dry-run | 仅打印请求信息，不实际发送 | | --version | 打印版本号 | | --help | 查看帮助 |

认证

# 方式一：通过命令配置（持久化到 ~/.bportal/config.json）
cmc auth login --api-key SK_xxxxx

# 方式二：通过环境变量
export BPORTAL_API_KEY=SK_xxxxx

获取 API Key：https://cainiao.4px.com/site/ak-manage

AI Agent 集成

安装后会自动注册 Skill 到本地 AI 编程工具（Claude Code / Cursor / Qoder 等），Agent 可直接调用 cmc 命令完成物流查询任务。

支持 JSON 输出模式，方便程序化调用：

cmc track get FPX12345678 --output json

环境要求

• Node.js >= 18.0.0
• npm >= 8

License

MIT