شغّل اللوحة من سكربت.

التثبيت

ثبّت CLI عالمياً عبر npm، أو شغّله عند الطلب بـ npx وتخطّ التثبيت:

# install globally
npm i -g @socialgo/cli

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

بعد التثبيت، يعيش أمر socialgo على PATH. شغّل socialgo --help لسرد كل أمر وعلَم.

اقرأ الشيفرة المصدرية على GitHub

المصادقة

يقرأ CLI مفتاح API من متغيّر البيئة SOCIALGO_API_KEY. ولّد مفتاحاً في لوحة التحكم، ثم صدّره في shell أو أسرار CI:

# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"

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

عامل المفتاح كأنه كلمة مرور. أبقِه خارج التحكّم بالإصدارات. استخدم أسراراً لكل بيئة أو ملف .env لا تُودِعه أبداً.

الأوامر

ابحث في الكتالوج

اعثر على الخدمات بكلمة مفتاحية. استخدمه لالتقاط معرّف الخدمة id قبل وضع طلب. للقراءة فقط. لا ينفق أبداً:

socialgo services search "instagram followers"

اسرد الخدمات

اطبع الكتالوج الكامل للخدمات المتاحة:

socialgo services list

ضع طلباً

اطلب بمعرّف الخدمة id والرابط الهدف والكمية. هذا الأمر الوحيد الذي ينفق. يعمل فقط عندما تستدعيه:

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

تتبّع طلباً

ابحث عن الحالة الحالية لطلب بمعرّفه:

socialgo order status <id>

تحقّق من الرصيد

اعرض الرصيد المتاح في حسابك:

socialgo balance

المحفظة

افحص تفاصيل المحفظة والمعاملات الأخيرة:

socialgo wallet

المسؤول: مزامنة الكتالوج

لمشغّلي اللوحات: اسحب أحدث الخدمات والأسعار من مزوّدك المتصل إلى الكتالوج المحلي. يتطلّب مفتاح مسؤول:

socialgo admin sync-catalog

حلقة الأوامر الثلاثة

اعثر على خدمة، ضع الطلب، تتبّعه. الحلقة التي يشغّلها كل سكربت ووكيل:

# 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

اكتبه سكربتاً من البداية للنهاية

مرّر --json لأي أمر ووجّهه إلى jq. هنا يختار السكربت أرخص خدمة مطابقة، ثم يطلبها. بلا نقر:

# 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

أكواد الخروج وJSON

كل أمر يعيد 0 عند النجاح وكوداً غير صفري عند الفشل، فتسلسل الاستدعاءات في خطوط CI وسكربتات shell. مرّر --json لأي أمر لمخرجات مقروءة آلياً تُوجَّه إلى أدوات مثل jq: أو تُعاد مباشرة إلى وكيل.