用脚本运行面板。

安装

用 npm 全局安装 CLI,或用 npx 按需运行、跳过安装:

# install globally
npm i -g @socialgo/cli

# or run without installing
npx @socialgo/cli --help

安装后,socialgo 命令就在你的 PATH 上。运行 socialgo --help 列出所有命令和标志。

在 GitHub 上查看源码

身份验证

CLI 从 SOCIALGO_API_KEY 环境变量读取 API 密钥。在仪表板生成密钥,然后在 shell 或 CI 密钥中导出它:

# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"

# Windows (PowerShell)
$env:SOCIALGO_API_KEY="your_api_key_here"

请像对待密码一样对待密钥。别放进版本控制，用按环境隔离的密钥,或一个绝不提交的 .env 文件。

命令

搜索目录

按关键词查找服务。用它在下单前拿到服务 id。只读，绝不花钱:

socialgo services search "instagram followers"

列出服务

打印可用服务的完整目录:

socialgo services list

下单

按服务 id、目标链接和数量下单。这是唯一会花钱的命令，只在你调用时才运行:

socialgo order create \
  --service <id> \
  --link <url> \
  --quantity 1000

跟踪订单

按 id 查询某个订单的当前状态:

socialgo order status <id>

查询余额

显示你账户上的可用余额:

socialgo balance

钱包

查看钱包详情和近期交易:

socialgo wallet

管理员:同步目录

面向面板运营者:把最新服务和定价从你连接的供应商拉取到本地目录。需要管理员密钥:

socialgo admin sync-catalog

三条命令的循环

找服务、下单、跟踪，每个脚本和智能体都跑的循环:

# 1. find the service id
socialgo services search "instagram followers"

# 2. place the order
socialgo order create --service 1423 --link https://instagram.com/yourhandle --quantity 1000

# 3. track it
socialgo order status 90871

端到端脚本化

给任意命令加 --json,管道进 jq。这里脚本挑出最便宜的匹配服务,然后下单，无需点击:

# pick the cheapest matching service, then order — with jq
id=$(socialgo services search "instagram followers" --json \
  | jq -r 'sort_by(.rate) | .[0].id')

socialgo order create --service "$id" \
  --link https://instagram.com/yourhandle --quantity 1000 --json

退出码与 JSON

每条命令成功返回 0,失败返回非零码,你可以在 CI 流水线和 shell 脚本里串联调用。给任意命令加 --json,即可获得机器可读输出,管道进 jq 之类的工具，或直接喂回给智能体。