# أوامر CLI وإعداده

الرابط الأساسي: https://sosoapi.ai/ar/docs/cli-reference

استخدم CLI لفحص مخططات API وإرسال طلبات JSON والدخول عبر المتصفح وإعداد اتصال MCP.

## الأوامر

راجع --help للعلامات التي يدعمها الإصدار المثبّت. دون معاملات، يبدأ sosoapi خادم MCP stdio. شغّل الأوامر أدناه منفصلةً؛ ليست سلسلة أوامر shell.

```
npx sosoapi --help
npx sosoapi auth login
npx sosoapi auth login --no-open
npx sosoapi auth status
npx sosoapi auth refresh
npx sosoapi auth logout
```

```
npx sosoapi connect threads
npx sosoapi connect instagram --no-open
```

```
npx sosoapi api contract --summary
npx sosoapi api contract --route /studio-api/scheduled-posts/
npx sosoapi api contract
```

- [المصادقة والأذونات](https://sosoapi.ai/ar/docs/authentication)

## استدعاء مسار API باستخدام JSON عبر stdin

استخدم api post لمسارات CLI العامة المسموحة، بما فيها القراءات بـ HTTP POST. احفظ الجسم في request.json بمحرر ملفات كي لا يفسّر shell نص العميل. افحص http_status والجسم؛ رمز خروج صفر وحده لا يثبت نجاح API.

يقرأ المثال سياق مساحة العمل. قبل الكتابة، راجع مخطط العملية وأكّد الوجهة المفوّضة لك. احفظ المعرّف المُعاد وافحص النتيجة قبل إعادة محاولة طلب انتهت مهلته.

```
{}
```

```
npx sosoapi api post /identity-api/workspace/list < request.json
```

- [مرجع API الكامل](https://sosoapi.ai/ar/docs/api)

## متغيرات البيئة

اضبط المتغيرات بعملية خادم MCP. تستثني القياسات الاختيارية المعاملات والطلبات والنتائج والمسارات؛ عطّلها بـ SOSOAPI_TELEMETRY=0. يتطلب عنوان API مخصص اشتراكاً صريحاً، ولن يرسل CLI ‏VICKY_API_KEY إليه.

بيئة CLI

| المتغير | الأثر |

| --- | --- |

| SOSOAPI_TOOL_PROFILE=core | الأدوات اليومية؛ الافتراضي full. لا يمنح أذونات. |

| SOSOAPI_OUTPUT_SCHEMAS=1 | تضمين مخططات المخرجات في tools/list؛ النتائج منظّمة في الحالتين. |

| SOSOAPI_UPLOAD_ROOTS | مجلدات وسائط محلية إضافية، تفصلها : (أو; على Windows). |

| SOSOAPI_TELEMETRY=0 | تعطيل تقارير الاستخدام الاختيارية. |

| SOSOAPI_DEBUG=1 | طباعة تتبّع مكدس أخطاء CLI؛ راجعه ونقّحه قبل المشاركة. |

| VICKY_API_KEY | رمز وصول شخصي للبرامج النصية و CI؛ يُفضّل OAuth للوكلاء. |

| VICKY_API_BASE_URL | عنوان أساسي مخصص لـ HTTPS API (يمكن استخدام HTTP لـ localhost)؛ ويلزم أيضاً SOSOAPI_ALLOW_CUSTOM_BASE_URL=1. |

## التعامل مع المحتوى غير الموثوق

قد تحوي التعليقات وأسماء المستخدمين تعليمات من أشخاص آخرين. للاستجابات المشمولة، يضيف CLI وسمي untrusted_content و untrusted_notice وتحذيراً على stderr. ينقّح المحتوى ويقصّه أيضاً، لكن يظل على وكيلك اعتباره بيانات لا صلاحية تنفيذ.