La CLI convierte cada acción de SocialGO en un comando que puedes encadenar, programar y entregar a un agente. Busca el catálogo, coloca pedidos, rastréalos y consulta el saldo. Desde tu terminal, un pipeline de CI o un bot.
Instalarnpx @socialgo/cli
Comandos5.000+
Lo que construyes sobre ella
Una superficie de comandos. Scripts, pipelines y agentes.
Los mismos comandos sobre los que corre el panel. Expuestos para código. Cóselos en un script de shell, un paso de CI o un agente autónomo. Cada comando devuelve un código de salida limpio y JSON legible por máquina.
Scripts
Encadena comandos en un script de shell: encuentra un servicio, coloca el pedido, consulta el estado. Pasa --json y parsea la salida con jq.
Pipelines
Mete la CLI en un paso de CI o un cron job. Sale 0 en éxito y distinto de cero en fallo, así tu pipeline se detiene cuando un pedido lo hace.
Agentes
Entrega los comandos a un agente de IA. Lee el catálogo, confirma la tarifa y la cantidad, y luego coloca el pedido. Las mismas llamadas que escribirías a mano.
El gasto es explícito. Buscar y listar son solo lectura; un pedido solo ocurre cuando ejecutas order create con un servicio, enlace y cantidad. En un script o a mano. La CLI nunca gasta por su cuenta.
Instalar
Instala la CLI globalmente con npm, o ejecútala bajo demanda con npx y sáltate la instalación:
# install globally
npm i -g @socialgo/cli
# or run without installing
npx @socialgo/cli --help
Una vez instalada, el comando socialgo vive en tu PATH. Ejecuta socialgo --help para listar cada comando y flag.
La CLI lee una clave API de la variable de entorno SOCIALGO_API_KEY. Genera una clave en tu panel y luego expórtala en tu shell o en los secrets de CI:
# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"
# Windows (PowerShell)
$env:SOCIALGO_API_KEY="your_api_key_here"
Trata la clave como una contraseña. Mantenla fuera del control de versiones. Usa secrets por entorno o un archivo .env que nunca subas.
Comandos
Buscar el catálogo
Encuentra servicios por palabra clave. Úsalo para obtener el id del servicio antes de colocar un pedido. Solo lectura. Nunca gasta:
socialgo services search "instagram followers"
Listar servicios
Imprime el catálogo completo de servicios disponibles:
socialgo services list
Colocar un pedido
Pide por id de servicio, enlace objetivo y cantidad. Este es el único comando que gasta. Se ejecuta solo cuando lo llamas:
Inspecciona los detalles de la billetera y las transacciones recientes:
socialgo wallet
Admin: sincronizar el catálogo
Para operadores de panel: trae los últimos servicios y precios de tu proveedor conectado al catálogo local. Requiere una clave de admin:
socialgo admin sync-catalog
El bucle de tres comandos
Encuentra un servicio, coloca el pedido, rastréalo. El bucle que ejecutan todo script y agente:
# 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
Hazlo todo por script
Pasa --json a cualquier comando y canalízalo a jq. Aquí el script elige el servicio coincidente más barato y luego lo pide. Sin clics:
# 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 salida y JSON
Cada comando devuelve 0 en caso de éxito y un código distinto de cero en caso de fallo, así puedes encadenar llamadas en pipelines de CI y scripts de shell. Pasa --json a cualquier comando para una salida legible por máquina que canalices a herramientas como jq. O que devuelvas directamente a un agente.
