Feita para máquinas

Rode o painel a partir de um script.

A CLI transforma cada ação do SocialGO em um comando que você canaliza, agenda e entrega a um agente. Busque o catálogo, crie pedidos, acompanhe-os e consulte o saldo. Do terminal, de um pipeline de CI ou de um bot.

Instalarnpx @socialgo/cli

Comandos5.000+

O que você constrói em cima

Uma superfície de comandos. Scripts, pipelines e agentes.

Os mesmos comandos que o painel usa. Expostos para código. Encaixe num script de shell, num passo de CI ou num agente autônomo. Todo comando retorna um código de saída limpo e JSON legível por máquina.

Scripts

Encadeie comandos num script de shell: ache o serviço, crie o pedido, consulte o status. Passe --json e parseie a saída com jq.

Pipelines

Coloque a CLI num passo de CI ou num cron. Ela retorna 0 em caso de sucesso e diferente de zero em caso de falha. Seu pipeline para quando um pedido para.

Agentes

Entregue os comandos a um agente de IA. Ele lê o catálogo, confirma preço e quantidade e cria o pedido. As mesmas chamadas que você digitaria à mão.

Gastar é explícito. Buscar e listar são só leitura; o pedido só acontece quando você roda order create com serviço, link e quantidade. Num script ou à mão. A CLI nunca gasta sozinha.

Instalar

Instale a CLI globalmente com o npm, ou rode-a sob demanda com npx e pule a instalação:

# install globally
npm i -g @socialgo/cli

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

Uma vez instalada, o comando socialgo fica no seu PATH. Rode socialgo --help para listar todos os comandos e flags.

Veja o código no GitHub

Autenticar

A CLI lê uma chave de API da variável de ambiente SOCIALGO_API_KEY. Gere uma chave no seu dashboard e exporte-a no shell ou nos secrets do CI:

# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"

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

Trate a chave como uma senha. Mantenha-a fora do controle de versão. Use secrets por ambiente ou um arquivo .env que você nunca commita.

Comandos

Buscar no catálogo

Encontre serviços por palavra-chave. Use para pegar o id do serviço antes de criar um pedido. Só leitura, nunca gasta:

socialgo services search "instagram followers"

Listar serviços

Imprima o catálogo completo de serviços disponíveis:

socialgo services list

Criar um pedido

Crie um pedido pelo id do serviço, link de destino e quantidade. É o único comando que gasta. Ele só roda quando você o chama:

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

Acompanhar um pedido

Consulte o status atual de um pedido pelo seu id:

socialgo order status <id>

Consultar saldo

Exiba o saldo disponível na sua conta:

socialgo balance

Carteira

Inspecione os detalhes da carteira e as transações recentes:

socialgo wallet

Admin: sincronizar o catálogo

Para operadores de painel: puxe os serviços e preços mais recentes do seu provedor conectado para o catálogo local. Requer uma chave de admin:

socialgo admin sync-catalog

O loop de três comandos

Ache um serviço, crie o pedido, acompanhe. O loop que todo script e agente roda:

# 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

Faça o script de ponta a ponta

Passe --json a qualquer comando e canalize para o jq. Aqui o script pega o serviço compatível mais barato e cria o pedido, sem cliques:

# 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

Códigos de saída e JSON

Todo comando retorna 0 em caso de sucesso e um código diferente de zero em caso de falha, então você encadeia chamadas em pipelines de CI e scripts de shell. Passe --json a qualquer comando para uma saída legível por máquina, pronta para canalizar em ferramentas como o jq. Ou para devolver direto a um agente.

Explorar serviços Conectar via MCP Precisa de ajuda? Fale com a gente