MoonWork CLI

MoonWork 是面向跨境电商内容生成和浏览器环境管理的命令行工具。

核心能力

• 生成商品文案、商品图片和商品视频。
• 为不同店铺或业务场景创建相互隔离的浏览器 Profile。
• 使用指定代理和浏览器身份配置启动 Chrome 兼容浏览器。
• 在本机重启浏览器后继续复用 Profile、登录态和浏览器环境。
• 为脚本、CI 和 Agent 提供稳定的 JSON 输出。

MoonWork 负责准备浏览器环境，再交给用户或 Agent 操作页面。它不是 Playwright、Puppeteer 等页面自动化框架的替代品。

浏览器相关命令不需要登录 MoonWork；内容生成、任务管理和结果获取需要先登录。

安装

npm install -g @moonwork-labs/cli

验证安装：

moonwork version
moonwork --help

需要 Node.js 18 或更高版本。

快速开始

启动可复用浏览器环境——无需登录

moonwork browser launch store-1-device-1 \
  --display-name "美国店铺 A" \
  --browser-config ./browser-config.json \
  --proxy-config ./proxy-config.json \
  --start-page https://example.com \
  --json

同一个本地浏览器环境应持续使用同一个 Profile ID。--display-name 只是展示名称，不会替代稳定的 Profile ID。

生成商品内容——需要登录

先完成登录：

moonwork login --email [email protected] --password-stdin
moonwork whoami

在 CI 或 Agent 环境中可以使用 Access Token：

moonwork login --token-stdin

moonwork generate-copy \
  --product-name "保温旅行杯" \
  --product-image ./product.png \
  --platform AMZ \
  --language English

命令入口

| 能力 | 主要命令 | | --- | --- | | 内容生成认证 | moonwork login、whoami、logout | | 内容生成——需要登录 | generate-copy、generate-image、generate-video | | 任务与结果——需要登录 | jobs、job、results、cancel | | 代理资源——无需登录 | proxy list、show、check、soak | | 浏览器 Profile——无需登录 | browser profile ... | | 浏览器会话——无需登录 | browser launch、browser session ... | | 浏览器环境诊断——无需登录 | browser doctor、runtime health |

执行 moonwork --help 可以查看当前版本的命令摘要。

JSON 输出

脚本和集成程序建议统一使用 --json。命令返回固定结构：

{
  "ok": true,
  "data": {},
  "error": null,
  "meta": null
}

执行失败时退出码为 1，详细错误位于 error。

查看帮助

通过内置帮助查看当前安装版本支持的命令：

moonwork --help

能力边界

浏览器 Profile 以同一台本地设备上的稳定复用为目标。仅把配置文件复制到另一台电脑，不保证获得完全相同的浏览器身份或登录状态。

MoonWork 可以减少环境混用和配置错误，但不承诺第三方平台一定不会审核、关联、限制或封禁账号。