# إعداد SosoAPI للشخص الذي يستخدم هذا المساعد استخدم مساعد الشخص الحالي واحتفظ بالمهمة والمحتوى و مراجع الوسائط في هذه المحادثة. استخدم SosoAPI MCP واحداً لحساباتهم المتصلة الحسابات الاجتماعية. أعِد استخدام اتصال موجود أو اختر الوصول المحلي أو المستضاف أدناه. الإعداد لا ينشر منشوراً. يسجّل الشخص الدخول ويختار ما يفوّضوا في متصفحهم. لا تُدخل بيانات اعتمادهم ولا توافق على الأذونات بالنيابة عنهم. لا تتطلب Free بطاقة دفع. ## 1. ربط هذا المساعد افحص المضيف الحالي وإعداد SosoAPI الموجود فيه أولاً. أعِد استخدام اتصال يعمل؛ لا تسجّل الخروج ولا تستبدل الإعدادات ولا تنشئ اتصالاً آخر اتصالاً لمجرد فتح هذا الدليل مرة أخرى. في shell محلي، تحقّق من توفر Node.js 20 أو أحدث و npx. استخدم بيئة تشغيل مدعومة موجودة. إذا كانت مفقودة، اشرح المتطلب بلغة اللغة؛ لا تُجرِ تغييرات بصلاحيات مرتفعة أو تغييرات عامة للنظام تلقائياً. Claude Code: ```sh claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Codex: ```sh codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` بعد تسجيل الخادم، تحقّق من قدرتك على استدعاء أدواته في هذا المحادثة. إذا احتاج المضيف إلى إعادة ربط أو تشغيل، فأخبر الشخص بأي الإجراء المطلوب. انتظر حتى تعمل الأدوات قبل القول إن الاتصال جاهز. تستخدم الاتصالات الجديدة ملف core الحالي ذي 28 أداة للنشر العادي، الوسائط والتعليقات والرؤى. ينبغي إعادة استخدام اتصال يعمل بملف full. إذا لم توجد عملية إدارية مطلوبة، فاشرح أن ملف full متاحة؛ إخفاء أداة لا يمنح إذناً ولا يلغيه. لعميل يعمل في المتصفح فقط مثل ChatGPT مع دعم تطبيقات MCP المخصّصة، أضف URL الخاص بـ MCP البعيد واختر OAuth مع تسجيل العميل تلقائياً: `https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp` لا حاجة إلى لصق مفتاح API أو client ID أو client secret. يسجّل الشخص الدخول في SosoAPI ويختار مساحات العمل/الإجراءات. تعتمد تطبيقات ChatGPT المخصّصة على خطته وتوفر وضع المطوّر فيه. أعِد استخدام اتصال محلي أو بعيد يعمل اتصال إذا كان أحدها مُعدّاً بالفعل. يدعم X النصوص والروابط الأصلية. تتشارك كل مؤسسة 10 أرصدة X في Free مرة واحدة، أو 100 في كل فترة فوترة Pro. النص البسيط يكلّف 1؛ والمنشور الذي يتضمن URL يكلّف 10. اقرأ `sosoapi_get_x_usage` مع workspace_id قبل التخطيط لاستخدام X. لا تُفرض رسوم تجاوز تلقائياً؛ يحتفظ النشر غير المؤكد برصيده حجز ويجب تسويته قبل إرسال آخر. ## 2. تسجيل الدخول دون مفتاح API يفتح أول استدعاء MCP مصادَق عليه مسار تسجيل الدخول الحالي في المتصفح و مسار الموافقة. يمكن للشخص استخدام Google أو التسجيل والتحقّق من بريده الإلكتروني. دعهم يختارون مساحة العمل وما إذا كان المساعد يقتصر على إعداد المحتوى فقط أم يمكنه أيضاً الجدولة والنشر. لا تطلب منهم نسخ بيانات الاعتماد. تستمر موافقة النشر ضمن النطاق المحدد، وليست شاشة موافقة لكل منشور. أبقِ إدارة المفاتيح معطّلة للنشر العادي. يستخدم التسجيل والدخول بالبريد الإلكتروني تحققاً أمنياً في الخلفية، دون مربع اختيار ليحلّه الشخص. إذا فشل التحقق، أبلغ عن الخطأ الفعلي واستخدم إجراء إعادة المحاولة المتاح؛ لا تطلب من الشخص البحث عن مربع CAPTCHA. خيار **Continue with Google** الحالي متاح أيضاً إذا أراد الشخص استخدام Google؛ قد تطلب Google تحقق الهوية الخاص بها. دع الشخص يختار حسابه ويوافق على الوصول. احتفظ برابط تسجيل الدخول/الموافقة الحالي ووجهة العودة إليه؛ لا تستبدله برابط تسجيل مجرد أو تنتقل بصمت إلى هوية مسؤول صيانة موجودة. خطأ واحد في تسجيل الدخول لا يثبت أن جميع طرق الدخول غير متاحة. أوقف فقط الخطوة التي تحتاج إلى هوية الشخص أو موافقته. وأثناء إكماله، ثم أنهِ فحوص التثبيت وأعِد المسودة الأصلية دون اختراع حساب أو مساحة عمل. اشرح ما أصبح جاهزاً بالفعل والخطوة الوحيدة الإجراء التالي المطلوب. بعد تسجيل الدخول، أعِد قراءة السياق المصادَق عليه واستأنف المهمة نفسها. لا تُعطّل CAPTCHA ولا تستخدم واجهات تسجيل المسؤولين ولا تطلب رموزاً، ولا تدّعِ جاهزية الحساب/الاتصال قبل اكتمال المسار الفعلي. إذا احتاجت أدوات MCP إلى إعادة تحميل المضيف، فـ CLI المحلي متاح أيضاً لهذا المساعد. شغّل `npx -y sosoapi auth status` أولاً؛ استخدم `npx -y sosoapi auth login` فقط عند الحاجة إلى تسجيل الدخول. لا تقرأ أبداً ملف بيانات الاعتماد ولا تطبع الرموز. إذا فُتح الدخول في ملف متصفح خاطئ، أوقف تسجيل الدخول المعلّق هذا قبل بدء اتصال جديد `npx -y sosoapi auth login --no-open`. يفتح الشخص الرابط الجديد المطبوع في ملف المتصفح المقصود ويتحقّق من الهوية المسجّلة قبل الموافقة. لا تستخدم ملفّي متصفح بالتزامن مع الرابط نفسه. الاستخدام `--help` أولاً للتأكّد من وجود علامة الاسترداد هذه في CLI المثبّت؛ إذا لم تكن موجودة، اشرح قيد الإصدار بدلاً من اختراع علامة تعمل. يمكن لـ CLI فحص العقود المضمّنة فيه: ```sh npx -y sosoapi api contract --summary npx -y sosoapi api contract --route /studio-api/scheduled-posts/ ``` صيغة طلب CLI هي `sosoapi api post < request.json`. اكتب JSON باستخدام أداة الملفات؛ لا تُدرج محتوى المستخدم مباشرةً في أوامر shell الأوامر. اقرأ http_status وجسم الاستجابة، وليس رمز خروج العملية وحده الرمز. خطأ API لا يعني النجاح. استخدم المسارات والمخططات الواردة في العقد المضمّن؛ لا تخترع أسماء ولا تتجاوز إمكانية مفقودة. ## 3. ربط حساب التواصل الاجتماعي الخاص بالشخص تحديد المؤسسة ومساحة العمل المصادَق عليهما من سياق SosoAPI. لا تخمّن المعرّفات ولا تستبدل مساحة العمل بأخرى بصمت. إذا توجد أكثر من علامة مناسبة، فاسأل أيها يقصد الشخص. استخدم اتصالاً موجوداً عندما يكون سليماً. وإلا فشغّل `npx -y sosoapi connect ` (instagram أو threads أو facebook أو youtube أو x) أو إعطاء الشخص https://app.sosoapi.ai/connect. يُكملون لدى مزوّد الخدمة الموافقة ومراجعة الحساب المحدد في المتصفح. بعد عودتهم، أعِد قراءة الحسابات وإمكانات النشر. استدعاء رد اتصال ناجح لا يُعدّ دليلاً على السماح بالنشر. أعِد استخدام المسودة الأصلية؛ لا تطلب من الشخص نسخ معرّف داخلي أو إعادة إنشاء محتواه. ## 4. إكمال مهمة النشر الأصلية استخدم طلب الشخص الحالي أو اسأل عمّا يريد الترويج له. لا تخترع منشور اختبار. اعرض حساب الوجهة والمحتوى والوسائط و التاريخ/الوقت المحلي قبل الإرسال الأول. أكّد المنطقة الزمنية عند غير معروفة. اقرأ حقائق الإمكانات الحالية للحساب؛ حساب Instagram شخصي أو غياب قد تتطلب أذونات مزوّد الخدمة نوع حساب مدعوماً أو إعادة ربط. يقبل X النصوص والروابط الأصلية فقط؛ أبقِ الوسائط فارغة. وسائط X والردود و الاقتباسات وإعادات النشر ونشر سلاسل المنشورات غير مدعومة. للوجهات التي تدعم الوسائط، سجّلها قبل الجدولة: لملف محلي استخدم sosoapi_upload_asset ضمن مجلداته المسموح بها؛ ولـ URL خارجي استخدم sosoapi_import_asset_url وافحص sosoapi_get_asset_import_status مع include_asset=true إلى أن الاستيراد المحدود جاهزاً. يصبح asset.id الجاهز media.asset_id و يصبح asset.asset_url هو media.url؛ لا يلزم استدعاء get_asset مستقل. احتفظ بهوية الاستيراد نفسها والتزم بتعليمات إعادة المحاولة وتوقّف عند نتيجة نهائية الفشل. نجاح الطلب لا يثبت اكتمال فك الترميز/الاستيراد. إذا توقّف التقدم، اقرأ sosoapi_job_status باستخدام job_id لذلك الاستيراد قبل الانتظار مجدداً. قد تتضمن المهمة المعلّقة خطأ تنفيذ بالفعل. الخدمة خطأ إعداد يتطلب انتباه المشغّل، وليس استيراداً آخر أو اتصالاً اجتماعياً جديداً اتصال أو إذن من الشخص. أبلغ عن العائق دون الادعاء الصورة جاهزة. استخدم معرّف الأصل المسجّل المُعاد مع URL الوسائط الأساسي. لا تجدول URL الخارجي الأصلي أو URL معاينة مؤقتاً بديلاً عنه. أعِد استخدام أصل جاهز موجود فقط بعد فحص مساحة عمله وهويته. استخدم sosoapi_get_scheduled_post_eligibility عندما تفيد معاينة استشارية؛ هو اختياري ولا يحل محل التحقق الأساسي عند الإنشاء والتنفيذ. استخدام Scheduled Post الأساسي الأدوات. كل منشور له وجهة واحدة. أعِد استخدام idempotency_key نفسه لمحاولات للطلب المحدد نفسه؛ المسودة المعدّلة طلب جديد. بعد انتهاء المهلة، اقرأ المنشور الموجود قبل أي إجراء آخر. لا تُعِد إرسال كتابة غير مؤكدة كتابة لدى مزوّد الخدمة غير مؤكدة. تستخدم التحديثات والإلغاء وإعادة المحاولة الصريحة الإصدار الحالي وأهلية الإجراء لدى الخادم. يجب أن تميّز النتيجة بين: - مجدول: مقبول للوقت المحدد؛ ولم يُنشر بعد. - قيد التنفيذ أو التسوية: النتيجة النهائية غير مؤكدة؛ لا تُعِد الإرسال. - نُشر: نتيجة نهائية مستندة إلى مزوّد الخدمة تؤكّد المنشور المحدد؛ إرجاع رابطه المنشور عند توفره. - فشل أو يحتاج إلى انتباه: اذكر ما هو معلوم والإجراء التالي المسموح؛ أعِد ربط الحساب المتأثر فقط عندما يحتاج الشخص إلى منح الوصول مجدداً. للوجهات المتعددة، أبلغ عن كل منها على حدة. لا تصف المهمة كلها بأنها ناجحة إذا نجحت بعض المنصات فقط. للجدولة المستقبلية، أعِد معرّفات المنشورات والأوقات المقبولة؛ لا تُبقِ المحادثة تنتظر إلى موعد الاستحقاق أو تنشئ حلقة استعلام متكرر. عند العودة، اقرأ المنشورات نفسها مجدداً. يمكن للشخص أيضاً الرجوع إلى النتيجة نفسها على https://app.sosoapi.ai/scheduled-posts/, باستخدام المعرّف الفعلي المُعاد بواسطة SosoAPI. تتطلب تلك الصفحة تسجيل دخولهم المفوّض. لبيئة مخصّصة بيئة، فاستخدم بدلاً من ذلك عنوان التطبيق المُعدّ صراحةً لها. لا تعد بإيقاظ مساعد مغلق أو إرسال إشعار نجاح لم لم يتم إعداده والتحقّق منه. ## المراجع - دليل البدء السريع للأشخاص: https://app.sosoapi.ai/start - دليل المنتج: https://sosoapi.ai/ar/docs/quickstart - النطاق المدعوم: Instagram و Threads وصفحات Facebook و YouTube ونصوص X الأصلية نصوص/روابط. تختلف الصيغ والأذونات حسب الحساب؛ والمنصات الأخرى ليست متاحة لمجرد أن الشخص يطلبها.