正式版 · v1.0.1

Avola Agent 命令行工具

面向 AI Agent、服务器自动化和分销系统的零依赖命令行工具。它使用你自己账户生成的 Avola API 密钥，并为每条命令返回稳定、可解析的 JSON。

Avola 自有 API 密钥JSON 输出幂等下单需要 Node.js 18 或更高版本

1. 安装

curl -fsSL https://avola.uk/agent/avola-agent.mjs \
  -o avola-agent.mjs
node avola-agent.mjs version

CLI 不依赖第三方包，也不会修改你的系统环境。

# PowerShell
$env:AVOLA_API_KEY="avola_live_你的密钥"
node .\avola-agent.mjs doctor

请妥善保管密钥。应放入环境变量或密钥管理器，不要写入提示词、浏览器代码或公开仓库。

命令	用途
`services --search youtube`	读取并筛选当前服务目录。
`balance`	读取密钥关联的 Avola 账户余额。
`order --service ID --link URL --request-id ID`	提交订单；使用唯一请求编号防止重复下单。
`status ORDER_ID [ORDER_ID ...]`	一次查询最多 100 个订单状态。
`doctor`	检查密钥、API 连接、服务目录和余额读取是否正常。

成功结果以 JSON 输出到 stdout；错误以 JSON 输出到 stderr，并返回非零退出码，方便 Agent 判断重试或停止。

node avola-agent.mjs services --category "YouTube"
node avola-agent.mjs status AVO20260714ABCD

每个密钥只能访问它关联的 Avola 余额和订单。返回内容不会包含供应商身份、供应商服务编号、供应商价格、内部成本、凭证或管理备注。