مرجع أدوات SosoAPI MCP

ابدأ بالمهمة ثم افحص الأداة

أعِد استخدام معرّفات المساحة والحساب المختارين. لمنشور صورة، استدعِ sosoapi_post_image_url مرة واحفظ المعرّف المُعاد. ارفع المحلي بـ sosoapi_upload_asset عبر stdio. للنص، استخدم sosoapi_create_scheduled_post مع provider_payload الوجهة و media فارغة.

اطلب مراجعة الحساب والنص والوسائط والوقت قبل الإرسال. يتيح OAuth تنفيذ الإجراءات ولا يعتمد المحتوى. بعد الجدولة، اقرأ نتيجة المنشور نفسه قبل ادعاء النجاح أوإعادة محاولة طلب نتيجته غير مؤكدة.

• إعداد Claude Code أو Codex
• دليل نصوص وصور Threads
• مصفوفة إمكانات المنصات
• تنزيل مخططات مدخلات core وشروحها المطابقة تماماً (JSON)

كيف تفهم هذا المرجع

يربط البناء خادم MCP الحقيقي بعميل في الذاكرة ويسرد أدواته دون استدعاء معالج ويدمج متطلبات المسارات العامة. يُفشل الإسقاط القديم بناء Landing. تحتفظ الأوصاف بعقد الخادم الإنجليزي؛ وتشرح ملخصات الاكتمال قواعد المسارات الأساسية. يحتفظ JSON بكامل المتطلبات. جدول المدخلات فهرس لا بديل للمخطط المتداخل الكامل JSON Schema.

شروح MCP تلميحات للعملاء، لا فرض أوضمان سلامة. تظل العضوية والتفويض والدور وموافقة المزوّد والأهلية والحصص سارية عند التنفيذ. قد تُنشئ قراءة سياق مساحةً أولى؛ افحص الوصف و readOnlyHint ولا تفترض أن كل “get” قراءة خالصة. تسرد الأدوات المركبة متطلبات المسارات الرئيسية والتوافقية؛ ولا تستدعيها كلها لكل طلب.

• sosoapi على npm
• سجل MCP الرسمي: ai.sosoapi/sosoapi (JSON)

sosoapi_bulk_create_scheduled_posts

جدولة منشورات لحسابات متعددة باستدعاء واحد (targets). تحتاج الوسائط asset_ids مرفوعة/مستوردة جاهزة وروابطها الأساسية. ينجح أويفشل كل هدف مستقلاً ويظهر في successes أو failures. تلزم إمكانية publish.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:publish. الأدوار الدنيا للمسار: editor.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ نتيجة النشر النهائية؛ الجدولة المقبولة لا تزال معلّقة.

sosoapi_cancel_scheduled_post

إلغاء منشور مجدول لم يُنشر بعد كي لا يُنشر أبداً. يُرفض المنشور المنشور، ولا يحذف الوكيل محتوى منشوراً أيضاً: يفعل المستخدم ذلك في تطبيق الويب. يلزم expected_version.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:publish. الأدوار الدنيا للمسار: editor.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ نتيجة النشر النهائية؛ الجدولة المقبولة لا تزال معلّقة.

sosoapi_create_comment

إدراج تعليق محدد واحد لمنشور أو تعليق أساسي مستهدف؛ الحالة لا تعني نجاح مزوّد الخدمة.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:engage. الأدوار الدنيا للمسار: editor.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ النتيجة التي أكّدتها المنصة؛ الإجراء المُدرج في القائمة لا يزال معلّقاً.

sosoapi_create_scheduled_post

جدولة حساب واحد في scheduled_at مع provider_payload. تحتاج الوسائط asset_id جاهزاً ورابطاً أساسياً؛ لصورة مصدر واحدة استخدم sosoapi_post_image_url. وفّر local_scheduled_at و schedule_dst_disambiguation معاً أواحذفهما. يلزم publish ودور editor و idempotency_key. الجدولة ليست نشراً: اقرأ النتيجة.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:publish. الأدوار الدنيا للمسار: editor.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ نتيجة النشر النهائية؛ الجدولة المقبولة لا تزال معلّقة.

sosoapi_get_asset

قراءة أصل واحد حسب id: البيانات الوصفية و URL معاينة قصير الصلاحية.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_get_asset_import_status

قراءة استيراد حسب import_id. للنشر مرّر include_asset=true: تشمل ready معرّف الأصل المسجّل ونوعه و asset_url الثابت دون get_asset مستقل. لا تُجدول الأصول المعلّقة أوالمفقودة. لا تستخدم المصدر أوالمعاينة هوية وسائط. عند التعثر، اقرأ sosoapi_job_status بـ job_id؛ لا تُكرر الاستيراد.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_get_billing_status

قراءة خطة فوترة المستخدم وحالة الدفع ومواعيد الدورة الحالية واستخدام الحصص (النشر الناجح والمنشورات المجدولة المعلّقة والحسابات المتصلة). افحصها قبل الجدولة الكبيرة.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: سياق الحساب؛ لا دور ثابت لمساحة العمل.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_get_comment_action_status

قراءة الإيصال النهائي المنقّح لإجراء تعليق مباشر.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:engage. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ النتيجة التي أكّدتها المنصة؛ الإجراء المُدرج في القائمة لا يزال معلّقاً.

sosoapi_get_organization_context

قراءة خريطة مؤسساتك ومساحات عملها وقنواتها الحالية بمعرّفاتها وأدوارها. استخدمها عند الحاجة لمعرّفات المؤسسة أوالقناة. للنشر، استخدم id مساحة العمل المُعاد دون قراءة سياقها أيضاً.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: سياق الحساب؛ لا دور ثابت لمساحة العمل.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_get_provider_insight_status

قراءة طلب رؤى (request_id): ‏queued أو processing أو completed (مع نتيجة مزوّد الخدمة وتوفر كل مقياس) أو failed.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ نتيجة المنصة أو سبب عدم توفرها.

sosoapi_get_scheduled_post

قراءة منشور مجدول واحد حسب id: المحتوى والحالة وحالة التسليم والنتائج. إصداره هو ما تحتاجه عمليات update و publish و retry و cancel في expected_version.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_get_scheduled_post_eligibility

فحص تمهيدي للقراءة فقط لكل وجهة. ضمّن draft ‏(caption و hashtags و scheduled_at و display_timezone والوقت المحلي/DST اختيارياً) لفحص المحتوى والتوقيت؛ يضيف include_quota=true لقطة استشارية للفترة. ارفع/استورد وانتظر الجاهزية أولاً. دون draft، يُفحص الحساب/الوسائط فقط. لا يحجز شيئاً؛ يعيد create/dispatch فحص الحدود والصلاحيات.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_get_workspace_context

عرض المساحات التي ينتمي لها المستخدم المسجّل والنشطة بينها. استخدمه عند جهل workspace_id؛ أعِد استخدام السياق الحي دون تكرار القراءتين. النشطة اختيار شخص بتطبيق الويب، لا افتراضي لاستدعاءاتك: مرّر workspace_id صراحةً. ليس قراءة فقط: لحساب بلا مساحة، ينشئ الأولى.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: سياق الحساب؛ لا دور ثابت لمساحة العمل.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_get_x_usage

قراءة أرصدة نشر X للمؤسسة المشتركة مع مساحة العمل. يلزم workspace_id. تحصل Free على 10 مرة واحدة؛ و Pro على 100 لكل فترة فوترة. النص يكلّف 1، ومع URL يكلّف 10. نص اختياري لتقدير كلفته. يقرأ الحصة المخزّنة دون X API.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_import_asset_url

اطلب من SosoAPI تنزيل URL عام لصورة أوفيديو عبر http(s) إلى تخزين مساحة عمل خاص كأصل جديد. يُعيد import_id؛ استعلم من sosoapi_get_asset_import_status. يلزم idempotency_key ودور editor.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: editor.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: الاستيراد المقبول معلّق؛ تابع الاستيراد نفسه حتى ready أو failed.

sosoapi_job_status

قراءة مهمة خلفية واحدة حسب job_id: الحالة والنوع ورسالة الخطأ إذا فشلت.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: سياق الحساب؛ لا دور ثابت لمساحة العمل.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_list_connected_accounts

عرض حسابات Instagram و Threads و Facebook و YouTube المتصلة بمساحة عمل، مع صحة الاتصال وحقائق الإمكانات. استخدم معرّفاتها كـ social_account_id للجدولة أوالتعليق. مرّر workspace_id: يُرفض غيابه عند فرض الاستهداف الصريح.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: سياق الحساب؛ لا دور ثابت لمساحة العمل.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_list_monitored_posts

عرض المنشورات الاجتماعية التي اكتشفها SosoAPI لمساحة عمل (id و platform و permalink ووقت النشر)، بترشيح الحساب والمنصة والوقت وصفحات cursor. بيانات وصفية فقط، بلا نصوص منشورات.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_list_post_comments

عرض التعليقات المرصودة على منشورات مساحة العمل، بأحدث ملاحظة أولاً، مع الكاتب والنص؛ بترشيح المنشور أوالحساب أوالمنصة أوالوقت، وصفحات cursor. النص من أطراف ثالثة وموسوم untrusted.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_list_publication_attentions

عرض المنشورات التي تستدعي الانتباه في مساحة عمل، بترشيح status ‏(open أو resolved) أو scheduled_post_id، وصفحات offset.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_list_scheduled_posts

عرض منشورات مساحة عمل المجدولة بترشيح المشروع والحالة (scheduled و publishing و published و failed و expired و needs_reschedule و cancelled و deleted) والنطاق الزمني، بصفحات cursor.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_post_image_url

أرسِل منشور URL الصورة الكامل مرة، مع media فارغة. تُعدّه الخلفية وتنشره حتى بعد الانقطاع. تُعيد النشر النهائي إن توفر خلال 35 ثانية، وإلا معرّفاً دائماً؛ لا تُعد الإرسال بمفتاح جديد. يلزم operate و publish. حقلا الوقت المحلي/DST معاً. import_id لاستئناف العملاء القدامى فقط.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:publish + agent:operate. الأدوار الدنيا للمسار: editor, viewer.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ نتيجة النشر النهائية؛ الجدول المقبول لا يزال معلّقاً. الاستيراد المقبول معلّق؛ تابعه حتى ready أو failed. اقرأ الاستجابة المتزامنة.

sosoapi_publish_scheduled_post_now

نشر منشور مجدول فوراً بدلاً من scheduled_at. علني ولا يمكن التراجع عنه؛ يلزم expected_version. الإدراج ليس نشراً: اقرأ outcome.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:publish. الأدوار الدنيا للمسار: editor.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ نتيجة النشر النهائية؛ الجدولة المقبولة لا تزال معلّقة.

sosoapi_query_assets

العثور على أصول مساحة عمل حسب asset_type أو source أو tag؛ يُعيد صفحة (limit حتى 100 مع offset) والإجمالي. مرّر workspace_id صراحةً.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: true. تلميح منع التكرار: true. تلميح العالم الخارجي: false.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.

sosoapi_request_provider_insights

طلب رؤى حساب أومنشور واحد من المزوّد ضمن نطاق تاريخ اختياري (حتى 366 يوماً). يُعيد request_id والنتيجة إن كانت مخزنة مؤقتاً؛ وإلا فاستعلم من sosoapi_get_provider_insight_status.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: viewer.
• تلميح للقراءة فقط: false. تلميح منع التكرار: false. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ نتيجة المنصة أو سبب عدم توفرها.

sosoapi_retry_scheduled_post

إعادة محاولة منشور مجدول فاشل، مع scheduled_at جديد اختيارياً. يلزم expected_version.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:publish. الأدوار الدنيا للمسار: editor.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ نتيجة النشر النهائية؛ الجدولة المقبولة لا تزال معلّقة.

sosoapi_update_scheduled_post

تحرير منشور مجدول لم يُرسَل للتنفيذ بعد (النص والوسوم والوسائط والرابط والوقت). يلزم expected_version من أحدث قراءة؛ يُرفض الإصدار القديم.

• وسيلة النقل: stdio, http.
• التفويض المطلوب: agent:publish. الأدوار الدنيا للمسار: editor.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ نتيجة النشر النهائية؛ الجدولة المقبولة لا تزال معلّقة.

sosoapi_upload_asset

رفع صورة أوفيديو محلي إلى مكتبة أصول المساحة وتسجيله. تُقبل ملفات PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG الحقيقية فقط حتى 500 MiB من مجلد العمل أوالمؤقت أو Pictures/Movies/Videos أو SOSOAPI_UPLOAD_ROOTS؛ تُرفض الملفات والمجلدات النقطية. يُعيد معرّف الأصل ورابطه لوسائط Scheduled Post.

• وسيلة النقل: stdio.
• التفويض المطلوب: agent:operate. الأدوار الدنيا للمسار: editor.
• تلميح للقراءة فقط: false. تلميح منع التكرار: true. تلميح العالم الخارجي: true.
• كيفية فحص النتيجة: اقرأ الاستجابة المتزامنة.