zmyun-cli

智麦云 CLI，用于在本机终端和 AI Agent 中操作 ZMY Collection、Project、机会选品、找货采集与 Marketplace 数据工作流。

CLI 默认连接智麦云官方服务：https://dev.kjdzerp.com。

让 AI 助手安装

把下面这段提示词复制给你的 AI 助手（Claude Code、Codex、Cursor、Trae 等），它会按安装文档完成安装、登录和验证：

帮我安装智麦云 CLI：https://github.com/superjack2050/zmyun-cli/blob/main/installation-guide.md

手动安装

npm install -g zmyun-cli
zmy auth login
zmy auth status
zmy doctor

需要 Node.js 20 或更新版本。已经登录过的用户，如果新增了 Project、机会选品、找货采集或 Marketplace 数据权限，请重新执行 zmy auth login。

zmy 会以非阻塞方式缓存检查 npm 上的新版本。如果发现本机版本落后，会在命令输出结束后通过 stderr 提示：

Update available: zmyun-cli 0.1.8 -> 0.1.9
Run: npm install -g zmyun-cli

脚本环境如需关闭更新提示，可设置 ZMY_NO_UPDATE_CHECK=1。

常用命令

zmy collection list --only-mine --format table
zmy collection list --workflow ai-editing --size 10
zmy collection get <collection-id>
zmy collection variants sku patch <collection-id> --sku-id <sku-id> --master-image ./main.jpg
zmy collection variants sku affiliate-image replace <collection-id> --sku-id <sku-id> --old-url <old-url> --new-url <new-url> --dry-run
zmy collection variants sku affiliate-image replace <collection-id> --sku-id <sku-id> --old-url <old-url> --new-file ./fixed.jpg
zmy collection workflow list --format table
zmy collection ai-status list --format table
zmy collection origin list --format table
zmy collection sort list --format table
zmy formula list --platform amazon --site US --page-size 20 --format table
zmy formula channels <formula-id> --format table
zmy collection price-calc-settings set <collection-id> --formula <formula-id>
zmy collection price-calc-settings set <collection-id> --formula <formula-id> --channel <channel-group-id>
zmy collection price-calc-settings set <collection-id> --formula <formula-id> --smart-channel --if-match "2026-06-04 10:00:00"

zmy project list --status progressing --format table
zmy project get <project-id>
zmy project status list --format table
zmy project create --name "Project name" --remark "Remark"
zmy project update <project-id> --name "New name"
zmy project update <project-id> --remark ""
zmy project update <project-id> --owner "alice"
zmy project update <project-id> --keywords-file keywords.json

zmy marketplace 1688 search "phone stand" --page-size 10 --format table
zmy marketplace 1688 search "phone stand" --price-start 10 --price-end 30 --moq 5 --verified-supplier
zmy marketplace 1688 image-search https://example.com/image.jpg --page-size 10 --format table
zmy marketplace 1688 detail --offer-id <offer-id>
zmy marketplace 1688 detail --url <1688-url> --format table
zmy marketplace amazon search "drawer organizer" --zipcode 10001 --page 1 --format table
zmy marketplace amazon search "drawer organizer" --category-node-id <node-id>
zmy marketplace amazon detail --asin <asin> --zipcode 10001
zmy marketplace amazon detail --url <amazon-url> --format table

zmy opportunity task create --category-node-id <node-id> --min-price 10 --max-review-count 200
zmy opportunity task list --status OPPORTUNITY_RESEARCH_RUN_STATUS_SUCCEEDED --format table
zmy opportunity run get <run-id> --format table
zmy opportunity product list <run-id> --format table
zmy opportunity product list <run-id> --include-removed --format table
zmy opportunity niche list <run-id> --format table
zmy opportunity niche list <run-id> --include-removed --format table
zmy opportunity niche get <run-id> <niche-id> --format table
zmy opportunity niche get <run-id> <niche-id> --editable > niche.json
zmy opportunity niche update <run-id> <niche-id> --file niche.json
zmy opportunity niche update <run-id> <niche-id> --name-cn "木质抽屉床头柜" --core-phrase "wooden nightstand with drawers"
zmy opportunity niche products <run-id> <niche-id> --format table
zmy opportunity niche products <run-id> <niche-id> --include-removed --format table
zmy opportunity product remove <run-id> <opportunity-product-id> --reason "not a fit"
zmy opportunity niche restore <run-id> <niche-id>

zmy sourcing run create --opportunity-run-id <run-id> --niche-id <niche-id>
zmy sourcing run list --status running --format table
zmy sourcing run get <sourcing-run-id> --format table
zmy sourcing candidate list <sourcing-run-id> --format table

本地凭据

zmy 会把本地登录凭据保存到 ~/.zmy-cli，并使用私有文件权限写入。退出登录并删除本地凭据：

zmy auth logout

完整流程见 installation-guide.md。