CLI, her SocialGO eylemini borulayabileceğiniz, zamanlayabileceğiniz ve bir ajana teslim edebileceğiniz bir komuta dönüştürür. Kataloğu arayın, sipariş verin, takip edin ve bakiye kontrol edin; terminalinizden, bir CI hattından ya da bir bottan.
Üzerine ne inşa edersiniz
Tek komut yüzeyi. Betikler, hatlar ve ajanlar.
Panelin çalıştığı komutların aynısı. Kod için açığa çıkarıldı. Bunları bir kabuk betiğine, bir CI adımına ya da otonom bir ajana ekleyin. Her komut temiz bir çıkış kodu ve makine tarafından okunabilir JSON döndürür.
Betikler
Komutları bir kabuk betiğinde zincirleyin: bir hizmet bulun, siparişi verin, durumu yoklayın. --json geçirin ve çıktıyı jq ile ayrıştırın.
Hatlar
CLI'yi bir CI adımına ya da bir cron işine bırakın. Başarıda 0, başarısızlıkta sıfır olmayan kodla çıkar, böylece bir sipariş durduğunda hattınız da durur.
Ajanlar
Komutları bir yapay zeka ajanına teslim edin. Kataloğu okur, birim fiyatı ve miktarı onaylar, sonra siparişi verir; elle yazacağınız çağrıların aynısı.
Harcama açıktır. Arama ve listeleme salt okunurdur; bir sipariş yalnızca siz bir hizmet, bağlantı ve miktarla order create çalıştırdığınızda gerçekleşir, ister betikte ister elle. CLI asla kendi başına harcamaz.
Kur
CLI'yi npm ile genel olarak kurun ya da npx ile istediğinizde çalıştırıp kurulumu atlayın:
# install globally
npm i -g @socialgo/cli
# or run without installing
npx @socialgo/cli --help
Kurulduktan sonra socialgo komutu PATH'inizde yer alır. Her komutu ve bayrağı listelemek için socialgo --help çalıştırın.
CLI, API anahtarını SOCIALGO_API_KEY ortam değişkeninden okur. Panelinizde bir anahtar üretin, sonra kabuğunuzda ya da CI gizli değerlerinizde dışa aktarın:
# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"
# Windows (PowerShell)
$env:SOCIALGO_API_KEY="your_api_key_here"
Anahtara bir parola gibi davranın. Sürüm kontrolünden uzak tutun. Ortam başına gizli değerler ya da asla commit etmediğiniz bir .env dosyası kullanın.
Komutlar
Kataloğu ara
Hizmetleri anahtar kelimeyle bulun. Sipariş vermeden önce hizmet id'sini almak için kullanın. Salt okunur, asla harcamaz:
socialgo services search "instagram followers"
Hizmetleri listele
Kullanılabilir hizmetlerin tam kataloğunu yazdırın:
socialgo services list
Sipariş ver
Hizmet id'si, hedef bağlantı ve miktarla sipariş verin. Harcama yapan tek komut budur. Yalnızca siz çağırdığınızda çalışır:
Panel operatörleri için: bağlı sağlayıcınızdan en güncel hizmetleri ve fiyatlandırmayı yerel kataloğa çekin. Bir yönetici anahtarı gerektirir:
socialgo admin sync-catalog
Üç komutlu döngü
Bir hizmet bulun, siparişi verin, takip edin. Her betiğin ve ajanın çalıştırdığı döngü:
# 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
Baştan sona betikleyin
Herhangi bir komuta --json geçirin ve jq'ya borulayın. Burada betik, eşleşen en ucuz hizmeti seçer, sonra sipariş eder, tıklama yok:
# 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
Çıkış kodları ve JSON
Her komut başarıda 0, başarısızlıkta sıfır olmayan bir kod döndürür, böylece çağrıları CI hatlarında ve kabuk betiklerinde zincirleyebilirsiniz. Herhangi bir komuta --json geçirin; jq gibi araçlara borulanacak ya da doğrudan bir ajana geri beslenecek makine tarafından okunabilir çıktı alın.
