SocialGO

Dibangun untuk mesin

Jalankan panel dari sebuah skrip.

CLI mengubah setiap aksi SocialGO menjadi perintah yang bisa Anda pipe, jadwalkan, dan serahkan ke agen. Cari katalog, buat pesanan, lacak, dan cek saldo. Dari terminal Anda, pipeline CI, atau bot.

Yang Anda bangun di atasnya

Satu antarmuka perintah. Skrip, pipeline, dan agen.

Perintah yang sama yang menjalankan dasbor. Diekspos untuk kode. Rangkai ke skrip shell, langkah CI, atau agen otonom. Setiap perintah mengembalikan kode keluar yang bersih dan JSON yang dapat dibaca mesin.

Skrip

Rangkai perintah dalam skrip shell: temukan layanan, buat pesanan, polling statusnya. Tambahkan --json dan parsing output-nya dengan jq.

Pipeline

Tempatkan CLI ke langkah CI atau cron job. Ia keluar 0 saat berhasil dan bukan-nol saat gagal, jadi pipeline Anda berhenti saat pesanan berhenti.

Agen

Serahkan perintahnya ke agen AI. Ia membaca katalog, mengonfirmasi tarif dan kuantitas, lalu membuat pesanan. Panggilan yang sama yang akan Anda ketik dengan tangan.

Pengeluaran bersifat eksplisit. Search dan list hanya-baca; pesanan hanya terjadi saat Anda menjalankan order create dengan layanan, tautan, dan kuantitas. Dalam skrip atau dengan tangan. CLI tidak pernah belanja sendiri.

Pemasangan

Pasang CLI secara global dengan npm, atau jalankan sesuai kebutuhan dengan npx dan lewati pemasangan:

# install globally
npm i -g @socialgo/cli

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

Setelah terpasang, perintah socialgo tersedia di PATH Anda. Jalankan socialgo --help untuk menampilkan setiap perintah dan flag.

Baca kode sumbernya di GitHub

Autentikasi

CLI membaca API key dari variabel lingkungan SOCIALGO_API_KEY. Buat key di dasbor Anda, lalu ekspor di shell atau secret CI Anda:

# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"

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

Perlakukan key seperti kata sandi. Jangan masukkan ke kontrol versi. Gunakan secret per-lingkungan atau berkas .env yang tidak pernah Anda commit.

Perintah

Cari katalog

Temukan layanan berdasarkan kata kunci. Gunakan untuk mendapatkan id layanan sebelum membuat pesanan. Hanya-baca. Tidak pernah belanja:

socialgo services search "instagram followers"

Daftar layanan

Cetak katalog lengkap layanan yang tersedia:

socialgo services list

Buat pesanan

Pesan berdasarkan id layanan, tautan target, dan kuantitas. Ini satu-satunya perintah yang belanja. Ia berjalan hanya saat Anda memanggilnya:

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

Lacak pesanan

Cari status terkini dari sebuah pesanan berdasarkan id-nya:

socialgo order status <id>

Cek saldo

Tampilkan saldo yang tersedia di akun Anda:

socialgo balance

Dompet

Periksa detail dompet dan transaksi terbaru:

socialgo wallet

Admin: sinkronkan katalog

Untuk operator panel: tarik layanan dan harga terbaru dari penyedia yang terhubung ke katalog lokal Anda. Memerlukan admin key:

socialgo admin sync-catalog

Loop tiga perintah

Temukan layanan, buat pesanan, lacak. Loop yang dijalankan setiap skrip dan agen:

# 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

Skrip dari awal hingga akhir

Tambahkan --json ke perintah apa pun dan pipe ke jq. Di sini skrip memilih layanan termurah yang cocok, lalu memesannya. Tanpa klik:

# 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

Kode keluar & JSON

Setiap perintah mengembalikan 0 saat berhasil dan kode bukan-nol saat gagal, sehingga Anda dapat merangkai panggilan dalam pipeline CI dan skrip shell. Tambahkan --json ke perintah apa pun untuk output yang dapat dibaca mesin guna disalurkan ke alat seperti jq. Atau diumpankan langsung kembali ke agen.