La CLI trasforma ogni azione di SocialGO in un comando che puoi mettere in pipe, schedulare e affidare a un agente. Cerca nel catalogo, piazza ordini, tracciali e controlla il saldo, dal terminale, da una pipeline CI o da un bot.
Installazionenpx @socialgo/cli
Comandi5.000+
Cosa ci costruisci sopra
Una sola superficie di comando. Script, pipeline e agenti.
Gli stessi comandi su cui gira la dashboard. Esposti per il codice. Cucili in uno script di shell, uno step CI o un agente autonomo. Ogni comando restituisce un codice di uscita pulito e JSON leggibile dalle macchine.
Script
Concatena comandi in uno script di shell: trova un servizio, piazza l'ordine, fai polling dello stato. Passa --json e analizza l'output con jq.
Pipeline
Inserisci la CLI in uno step CI o in un cron job. Esce con 0 in caso di successo e diverso da zero in caso di errore, così la pipeline si ferma quando si ferma un ordine.
Agenti
Affida i comandi a un agente AI. Legge il catalogo, conferma tariffa e quantità, poi piazza l'ordine, le stesse chiamate che digiteresti a mano.
La spesa è esplicita. Search e list sono in sola lettura; un ordine avviene solo quando esegui order create con servizio, link e quantità, in uno script o a mano. La CLI non spende mai per conto suo.
Installazione
Installa la CLI globalmente con npm, oppure eseguila al volo con npx e salta l'installazione:
# install globally
npm i -g @socialgo/cli
# or run without installing
npx @socialgo/cli --help
Una volta installata, il comando socialgo vive nel tuo PATH. Esegui socialgo --help per elencare ogni comando e flag.
La CLI legge una chiave API dalla variabile d'ambiente SOCIALGO_API_KEY. Genera una chiave nella dashboard, poi esportala nella shell o nei secret della CI:
# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"
# Windows (PowerShell)
$env:SOCIALGO_API_KEY="your_api_key_here"
Tratta la chiave come una password. Tienila fuori dal version control. Usa secret per ambiente o un file .env che non committi mai.
Comandi
Cerca nel catalogo
Trova servizi per parola chiave. Usalo per prendere l<code>id</code> del servizio prima di piazzare un ordine. Sola lettura. Non spende mai:
socialgo services search "instagram followers"
Elenca i servizi
Stampa l'intero catalogo dei servizi disponibili:
socialgo services list
Piazza un ordine
Ordina per id del servizio, link di destinazione e quantità. È l'unico comando che spende. Gira solo quando lo chiami tu:
Consulta lo stato attuale di un ordine dal suo id:
socialgo order status <id>
Controlla il saldo
Mostra il saldo disponibile sul tuo account:
socialgo balance
Portafoglio
Ispeziona i dettagli del portafoglio e le transazioni recenti:
socialgo wallet
Admin: sincronizza il catalogo
Per gli operatori di pannello: importa gli ultimi servizi e prezzi dal tuo provider collegato nel catalogo locale. Richiede una chiave admin:
socialgo admin sync-catalog
Il ciclo a tre comandi
Trova un servizio, piazza l'ordine, traccialo, il ciclo che ogni script e agente esegue:
# 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
Mettilo in script dall'inizio alla fine
Passa --json a qualsiasi comando e mettilo in pipe verso jq. Qui lo script sceglie il servizio corrispondente più economico, poi lo ordina, senza clic:
# 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
Codici di uscita e JSON
Ogni comando restituisce 0 in caso di successo e un codice diverso da zero in caso di errore, così puoi concatenare le chiamate in pipeline CI e script di shell. Passa --json a qualsiasi comando per un output leggibile dalle macchine da mettere in pipe verso strumenti come jq, o da rimandare direttamente a un agente.
