跳到主要内容

无头与 CI

在自动化环境——CI 流水线、定时任务或后台智能体——中运行 Toolkit,无需交互式浏览器登录。

用 User Access Token 认证​

交互式 OAuth 需要浏览器。无头运行改用 User Access Token(UAT):

shell
shoplazza auth login --uat <your-token> --store-domain my-store.myshoplazza.com

或通过环境变量传入,避免落盘:

shell
export SHOPLAZZA_UAT=your-token
export SHOPLAZZA_STORE=my-store.myshoplazza.com
shoplazza products +search --keyword "shirt"

在 Shoplazza 合作伙伴后台生成 UAT,并作为加密密钥存入 CI 系统——绝不写进指令、提交的文件或智能体上下文。

在 CI 中安装​

shell
npm install -g shoplazza-cli
npx skills add Shoplazza/shoplazza-cli -g

若智能体只跑 API/快捷命令,独立二进制无需 Node.js——见安装 Shoplazza CLI。

面向流水线的结构化输出​

每条命令默认返回 JSON,无头智能体可解析并链式处理。用 --jq 裁剪:

shell
shoplazza orders +count --jq '.data.count'

在自动化中保证写操作安全​

无人值守时没有人来确认写操作。缩小影响面:

  • 任务只需读时授予只读 scope:--scope read_order,read_product。
  • 对想在日志中先审查的写步骤,保留 --dry-run,确认无误再放开。
  • 让自动化先指向开发店。

完整模型见安全与权限。

参见​

在此页面