Die CLI verwandelt jede SocialGO-Aktion in einen Befehl, den du weiterleiten, planen und einem Agenten übergeben kannst. Durchsuche den Katalog, gib Bestellungen auf, verfolge sie und prüfe das Guthaben – aus deinem Terminal, einer CI-Pipeline oder einem Bot.
Worauf du damit aufbaust
Eine Befehlsoberfläche. Skripte, Pipelines und Agenten.
Dieselben Befehle, auf denen das Dashboard läuft. Für Code freigelegt. Verwebe sie zu einem Shell-Skript, einem CI-Schritt oder einem autonomen Agenten. Jeder Befehl gibt einen sauberen Exit-Code und maschinenlesbares JSON zurück.
Skripte
Verkette Befehle in einem Shell-Skript: finde einen Dienst, gib die Bestellung auf, frage den Status ab. Übergib --json und parse die Ausgabe mit jq.
Pipelines
Setze die CLI in einen CI-Schritt oder einen Cronjob ein. Sie endet bei Erfolg mit 0 und bei Fehlschlag ungleich null, sodass deine Pipeline stoppt, wenn eine Bestellung es tut.
Agenten
Übergib die Befehle einem KI-Agenten. Er liest den Katalog, bestätigt Rate und Menge und gibt dann die Bestellung auf – dieselben Aufrufe, die du von Hand tippen würdest.
Ausgaben sind explizit. Suchen und Auflisten sind nur lesend; eine Bestellung passiert nur, wenn du order create mit Dienst, Link und Menge ausführst, in einem Skript oder von Hand. Die CLI gibt nie eigenmächtig Geld aus.
Installieren
Installiere die CLI global mit npm oder führe sie bei Bedarf mit npx aus und überspringe die Installation:
# install globally
npm i -g @socialgo/cli
# or run without installing
npx @socialgo/cli --help
Nach der Installation liegt der Befehl socialgo in deinem PATH. Führe socialgo --help aus, um jeden Befehl und jedes Flag aufzulisten.
Die CLI liest einen API-Schlüssel aus der Umgebungsvariable SOCIALGO_API_KEY. Generiere einen Schlüssel in deinem Dashboard und exportiere ihn dann in deiner Shell oder in deinen CI-Secrets:
# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"
# Windows (PowerShell)
$env:SOCIALGO_API_KEY="your_api_key_here"
Behandle den Schlüssel wie ein Passwort. Halte ihn aus der Versionsverwaltung heraus. Verwende umgebungsspezifische Secrets oder eine .env-Datei, die du niemals commitest.
Befehle
Katalog durchsuchen
Finde Dienste per Stichwort. Nutze es, um die Dienst-id zu holen, bevor du eine Bestellung aufgibst. Nur lesend – es gibt niemals etwas aus:
socialgo services search "instagram followers"
Dienste auflisten
Gib den vollständigen Katalog verfügbarer Dienste aus:
socialgo services list
Bestellung aufgeben
Bestelle per Dienst-id, Ziel-Link und Menge. Das ist der eine Befehl, der Geld ausgibt. Er läuft nur, wenn du ihn aufrufst:
Schlage den aktuellen Status einer Bestellung anhand ihrer ID nach:
socialgo order status <id>
Guthaben prüfen
Zeige das auf deinem Konto verfügbare Guthaben:
socialgo balance
Wallet
Prüfe Wallet-Details und aktuelle Transaktionen:
socialgo wallet
Admin: Katalog synchronisieren
Für Panel-Betreiber: Hole die neuesten Dienste und Preise von deinem verbundenen Anbieter in den lokalen Katalog. Erfordert einen Admin-Schlüssel:
socialgo admin sync-catalog
Die Drei-Befehle-Schleife
Finde einen Dienst, gib die Bestellung auf, verfolge sie. Die Schleife, die jedes Skript und jeder Agent ausführt:
# 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
Skripte es von Anfang bis Ende
Übergib jedem Befehl --json und leite es in jq weiter. Hier wählt das Skript den günstigsten passenden Dienst und bestellt ihn dann – ohne Klicken:
# 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
Exit-Codes & JSON
Jeder Befehl gibt bei Erfolg 0 und bei Fehlschlag einen Code ungleich null zurück, sodass du Aufrufe in CI-Pipelines und Shell-Skripten verketten kannst. Übergib jedem Befehl --json für maschinenlesbare Ausgabe, die du in Tools wie jq weiterleitest oder direkt an einen Agenten zurückgibst.
