La CLI transforme chaque action SocialGO en une commande que vous pouvez piper, planifier et confier à un agent. Cherchez le catalogue, passez des commandes, suivez-les et vérifiez votre solde, depuis votre terminal, un pipeline CI ou un bot.
Installationnpx @socialgo/cli
Commandes5.000+
Ce que vous construisez dessus
Une seule interface de commandes. Scripts, pipelines et agents.
Les mêmes commandes sur lesquelles tourne le tableau de bord, exposées pour le code. Cousez-les dans un script shell, une étape CI ou un agent autonome. Chaque commande renvoie un code de sortie propre et du JSON exploitable par machine.
Scripts
Enchaînez les commandes dans un script shell : trouvez un service, passez la commande, interrogez le statut. Passez --json et analysez la sortie avec jq.
Pipelines
Glissez la CLI dans une étape CI ou une tâche cron. Elle sort en 0 en cas de succès et non-nul en cas d'échec, pour que votre pipeline s'arrête quand une commande s'arrête.
Agents
Confiez les commandes à un agent IA. Il lit le catalogue, confirme le tarif et la quantité, puis passe la commande, les mêmes appels que vous saisiriez à la main.
La dépense est explicite. La recherche et la liste sont en lecture seule ; une commande ne se produit que lorsque vous exécutez order create avec un service, un lien et une quantité. Dans un script ou à la main. La CLI ne dépense jamais d'elle-même.
Installation
Installez la CLI globalement avec npm, ou exécutez-la à la demande avec npx et sautez l'installation :
# install globally
npm i -g @socialgo/cli
# or run without installing
npx @socialgo/cli --help
Une fois installée, la commande socialgo vit dans votre PATH. Exécutez socialgo --help pour lister toutes les commandes et options.
La CLI lit une clé API depuis la variable d'environnement SOCIALGO_API_KEY. Générez une clé dans votre tableau de bord, puis exportez-la dans votre shell ou vos secrets CI :
# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"
# Windows (PowerShell)
$env:SOCIALGO_API_KEY="your_api_key_here"
Traitez la clé comme un mot de passe. Gardez-la hors du contrôle de version. Utilisez des secrets par environnement ou un fichier .env que vous ne committez jamais.
Commandes
Rechercher dans le catalogue
Trouvez des services par mot-clé. Utilisez-le pour récupérer l<code>id</code> du service avant de passer une commande. En lecture seule, il ne dépense jamais :
socialgo services search "instagram followers"
Lister les services
Affichez le catalogue complet des services disponibles :
socialgo services list
Passer une commande
Commandez par id de service, lien cible et quantité. C'est la seule commande qui dépense, elle ne s'exécute que lorsque vous l'appelez :
Consultez le statut actuel d'une commande à partir de son id :
socialgo order status <id>
Vérifier votre solde
Affichez le solde disponible sur votre compte :
socialgo balance
Portefeuille
Inspectez les détails du portefeuille et les transactions récentes :
socialgo wallet
Admin : synchroniser le catalogue
Pour les opérateurs de panel : importez les derniers services et tarifs depuis votre fournisseur connecté vers le catalogue local. Nécessite une clé admin :
socialgo admin sync-catalog
La boucle en trois commandes
Trouvez un service, passez la commande, suivez-la, la boucle que tout script et agent exécute :
# 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
Scriptez-le de bout en bout
Passez --json à n'importe quelle commande et pipez-la dans jq. Ici, le script choisit le service correspondant le moins cher, puis le commande, sans aucun 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
Codes de sortie et JSON
Chaque commande renvoie 0 en cas de succès et un code non nul en cas d'échec, ce qui vous permet d'enchaîner les appels dans des pipelines CI et des scripts shell. Passez --json à n'importe quelle commande pour une sortie exploitable par machine à piper dans des outils comme jq : ou à renvoyer directement à un agent.
