Ever Connect
中文·EN·한국어登录申请接入

命令行工具Beta

把接口包成终端里能敲的命令:程序员试接口、脚本进管道、AI 编程助手不用配 MCP 就能用。它只是把命令翻译成对网关的调用,认证、授权、限流全在网关那一处v1.4.0

查看 Markdown
CLI 处于 Beta命令随能力目录变化,可能还会调整;用着不对劲告诉对接人。
写操作要加 `--confirm`下单一类命令不加 --confirm 只预览;发出去的也永远是草稿,由人在 ERP 确认。

安装

macOS / Linux:

curl -fsSL https://connect.everugg.net.au/cli/install.sh | sh

Windows(PowerShell):

irm https://connect.everugg.net.au/cli/install.ps1 | iex

单文件二进制,不需要 Node 或 Python。装完运行 ever --help。网关地址已写进本地配置,用 ever config base <url> 可改。

三步跑通

先用公共沙箱(演示数据,动不了真库存):

ever login --sandbox
ever whoami
ever stock changes AU --since 0

换成自己的渠道(口令只在换 token 时发出,默认保存在本机 0600 权限的配置文件里,`--no-save-secret` 可不存):

ever login --channel 100780
ever stock sku AU OB0021611
ever order create --file order.json --confirm
ever stock changes AU --since 51204 --json | jq '.data | length'

写操作(下单等)默认只预览,加 --confirm 才真发,且永远只建草稿,由人在 ERP 确认。--json 原样输出信封,方便 jq 与脚本。

给 AI 编程助手用

Claude Code、Cursor 这类助手本来就会用终端:装上 ever,它就能自己查库存、读文档。ever tools --json 列出能调的工具(按你的权限裁剪,和 MCP 同一套名字),ever docs <tool> 打印那条接口的 Markdown 文档。

ever tools --json
ever docs stock_changes
ever call stock_changes --warehouse_code AU --since 0 --json

命令清单

命令来自网关的能力目录/tools.json),启动时拉取、本地缓存 1 小时——目录一改,CLI 不用重发。ever call <tool> --参数 值;常用的有快捷写法:ever stock changes AU --since 0ever stock sku AU OB0021611ever order get <单号>

warehouse
ever call warehouse_list 仓库清单:仓码、名称、国家、所属公司、是否合计视图、能否发货、币种
stock
ever call stock_list 查某仓库存(含批发价 / 零售价 / 可用量)
ever call stock_changes 所选仓库存变更(增量):传 since=上次拿到的 version,只返回之后变了的行;has_more=true 就带新 version 再调;needs_full_sync=true 表示 since 太旧要重做一次全量
product
ever call product_list 某仓的产品列表(按款号去重,含价格;search 按款号 / 品名搜)
ever call product_get 按款号查产品详情:图片 / 描述 / 材质 / 价格,以及这一款的全部变体(skus)
sku
ever call sku_get 按 SKU 查单个变体详情(单对象)
dropship
ever call dropship_product_list 查代发系统在售产品列表(分页)
ever call dropship_order_cancel 写操作 作废代发明细(连同它占住的配货一起释放)
ever call dropship_order_allocation_preview 写操作 代发预配:一次交一批流水号,逐条告诉你能不能配齐、缺货的缺多少、要付多少
ever call dropship_order_submit 写操作 提交代发(提交后不能改)
ever call dropship_order_allocation_cancel 写操作 释放这条代发明细占住的预配库存(预配之后决定不提交时用)
ever call dropship_order_create 写操作 创建代发订单(一单一个 SKU)
ever call dropship_order_list 查本渠道代发订单:按仓 + 日期区间;或按 client_order_number / serial_number 直接找一张
ever call dropship_order_summary 代发订单汇总列表(分页)
ever call dropship_order_get 按单号查代发订单详情(仅本渠道)
price
ever call price_list 查本渠道的产品价格(分页)
shipping
ever call shipping_method_list 你这个账号可用的发货方式(自取 / 自送 / 快递…)
carrier
ever call carrier_list 你这个账号可选的物流公司
address
ever call address_list 你在 OMS 里存的收货地址簿
order
ever call order_create 写操作 创建批发订单
ever call order_list 按日期区间查本渠道批发订单
ever call order_get 按单号查批发订单详情(仅本渠道)
ever call order_cancel 写操作 作废批发订单(连同它占住的配货一起释放)
ever call order_allocation_preview 写操作 批发订单配货预览:逐行告诉你能配多少、缺多少(quantity_owed)、预售批次几时到货,以及应付金额和余额够不够
ever call order_submit 写操作 提交批发订单(提交后不能再改明细)
feed
ever call feed_products 取商品 feed(Google Merchant 规格,同时就是批量导出):一次产出 csv / xml / json 三份,并缓存,供定时抓取下载
ever call feed_status 看商品 feed 拼到哪了:在拼 / 好了 / 失败(**带失败原因**),以及最新一份的行数、拼于什么时候、会被平台挑什么毛病
shipment
ever call shipment_list 查本渠道发货单列表
ever call shipment_get 按单号查发货单详情(仅本渠道)
ever call shipment_tracking 物流轨迹(澳邮 Auexpress)
reservation
ever call reservation_list 查本渠道锁单 / 预留库存列表(默认含锁定中和已作废的;status=reserved 只看锁定中)
ever call reservation_get 按单号查锁单详情(仅本渠道)
balance
ever call balance_list 你的账户余额(澳洲 / 中国 / 新西兰,开了哪个给哪个)
transaction
ever call transaction_list 交易流水(充值 / 扣款 / 退款),每笔带之后的账户余额;amount_total 是这批的合计
bill
ever call bill_list 月度账单(按仓、按月,含是否已付)
refund
ever call refund_list 退款单(批发 / 代发,含审核状态与退款原因)
freight
ever call freight_bill_list 运费单(承运商、运单号、箱数、金额)
cart
ever call cart_get 查某账号购物车
ever call cart_put_items 写操作 添加 / 更新购物车条目(幂等)
ever call cart_delete_item 写操作 按 SKU 移除购物车条目
ever call cart_delete_product 写操作 按款号移除购物车里这一款的全部 SKU

任何端点都能 ever api <METHOD> <path> --query k=v --body <json> 原样调;ever whoami 看身份与权限;ever login --sandbox 切回沙箱。

手动下载

安装脚本下载的就是这些文件;也可以自己下载校验后放进 PATH。 · 2026-09-04

平台文件大小SHA-256
Linux x64ever-linux-x6479 MB0fbe0942cbd37472…
macOS Apple Siliconever-darwin-arm6461 MBa8e3596dd9f1eee4…
Linux arm64ever-linux-arm6479 MBf4f59ce530cc6ec9…
Windows x64ever-windows-x64.exe85 MB4d244913bfc90b04…
macOS Intelever-darwin-x6467 MB03c7ea836b5f48e1…

接口参考 · MCP · llms.txt