cbs-4px-merchant-cli

跨境物流商家命令行工具（4PX 站点），支持物流轨迹查询、面单获取、普通下单与订单管理、产品推荐、理赔查询、平台拉单、商家入驻。

安装

npm install -g cbs-4px-merchant-cli

安装后命令名为 fmc。

快速开始

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

# 2. 配置认证
fmc auth login --api-key sk-xxxxx

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

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

# 5. 创建订单草稿（JSON 字段见 skill/reference/order.md）
fmc order create --file ./order.json --draft -y

# 6. 用户确认后提交预报
fmc order forecast --orderNo ORD-20260907-001 -y

# 7. 产品推荐
fmc product recommend --country US

# 8. 查询理赔
fmc service claim list --biz-no 4PX3000002316090CN

命令列表

| 命令 | 说明 | |------|------| | fmc auth login --api-key <key> | 配置 API Key | | fmc auth status | 查看当前认证状态 | | fmc config set <key> <value> | 设置配置项 | | fmc config list | 查看当前配置 | | fmc track get <orderNo> | 查询物流轨迹 | | fmc label get <orderNo> | 获取面单打印信息（PDF 链接） | | fmc order get <orderNo> | 获取订单详情 | | fmc order create --file <json> --draft -y | 创建物流订单草稿（写操作） | | fmc order edit --orderNo <单号> --file <json> --draft -y | 编辑草稿/已取消订单（写操作） | | fmc order forecast --orderNo <单号> -y | 草稿提交预报（写操作） | | fmc order cancel --orderNo <单号> --reason <text> -y | 取消订单（写操作） | | fmc order intercept --orderNo <单号> -y | 申请拦截订单（写操作） | | fmc product recommend --country <code> | 产品推荐（按目的国查询） | | fmc problem list | 查询异常件 / 问题件列表 | | fmc service claim list | 查询理赔列表 | | fmc service repair list | 查询售后工单列表 | | fmc finance balance | 查询账户余额 | | fmc finance bill list | 查询账单列表 | | fmc pickup material list | 查询物料申请单列表 | | fmc notice list | 查询系统公告列表 | | fmc customs commodity list | 查询商品备案列表 | | fmc customs hscode search | 查询海关编码 | | fmc platform account list | 查询已授权的卖家账号 | | fmc platform order list | 查询平台订单列表 | | fmc platform sync | 从卖家账号拉取平台订单（写操作） | | fmc platform order push | 推送平台订单履约（写操作） | | fmc onboarding progress | 查询入驻进度 | | fmc onboarding auth indiv | 发起个人实名认证（写操作） | | fmc onboarding brand open | 开通物流品牌并申请合同（写操作） | | fmc onboarding contract list | 查询合同列表 | | fmc update | 更新到最新版本 | | fmc update --check | 检查是否有新版本 |

完整命令清单见 fmc --help 或 skill 中的 reference/index.md。

写操作

order create/edit/forecast/cancel/intercept、platform sync、platform order push、onboarding auth *、onboarding brand open 会真实改变数据，默认在终端二次确认；非交互环境（管道、CI、AI Agent）必须显式加 -y，否则会拒绝执行。先用 --dry-run 可查看将发送的请求。普通下单默认先用 order create --draft 保存草稿，用户核对后再 order forecast。

全局选项

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

认证

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

# 方式二：通过环境变量
export BPORTAL_API_KEY=sk-xxxxx

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

AI Agent 集成

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

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

fmc track get FPX12345678 --output json

环境要求

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

License

MIT