# مرجع أدوات MCP

- [مرجع أدوات MCP](https://sosoapi.ai/ar/docs/mcp): اعثر على مدخلات الأدوات ومخرجاتها وملفاتها التعريفية وتوفرها محلياً أو مستضافة.
- [جلب الملف الشخصي للمستخدم](https://sosoapi.ai/ar/docs/mcp/get-user-profile): MCP: جلب الملف الشخصي للمستخدم. قراءة الملف الشخصي للمستخدم المسجّل نفسه (الاسم المعروض والمنطقة الزمنية والصورة والثيم)؛ يكون profile بقيمة null حتى إنشائه.
- [تحديث الملف الشخصي للمستخدم](https://sosoapi.ai/ar/docs/mcp/update-user-profile): MCP: تحديث الملف الشخصي للمستخدم. تغيير ملف المستخدم المسجّل نفسه (display_name و timezone و avatar_url و theme). أرسِل الحقول المراد تغييرها فقط.
- [توقيع رفع الصورة الشخصية](https://sosoapi.ai/ar/docs/mcp/sign-avatar-upload): MCP: توقيع رفع الصورة الشخصية. جلب URL موقّع لرفع صورة شخصية جديدة للمستخدم المسجّل (يلزم filename و content_type). لا يغيّر الملف الشخصي بمفرده.
- [عرض مفاتيح API](https://sosoapi.ai/ar/docs/mcp/list-api-keys): MCP: عرض مفاتيح API. عرض مفاتيح API للمستخدم (الاسم وآخر 4 أحرف والحالة والانتهاء والتسلسل)؛ اضبط include_authority لإمكانات كل مفتاح وحد مساحة عمله. لا تُعاد الأسرار. يلزم Manage API keys؛ لا يتاح لـ PAT.
- [إنشاء مفتاح API](https://sosoapi.ai/ar/docs/mcp/create-api-key): MCP: إنشاء مفتاح API. إنشاء مفتاح وصول شخصي بإمكانات مختارة (agent:operate و agent:publish و agent:engage) وحد workspace_ids اختياري وعمر حتى 365 يوماً؛ يُعاد السر مرة ولا يُقرأ ثانيةً. لا يمنح الوكيل إلا ما يملكه تفويضه حتى 30 يوماً، ويتوقف المفتاح بانتهاء التفويض. يلزم Manage API keys؛ لا يتاح لـ PAT.
- [تمديد صلاحية مفتاح API](https://sosoapi.ai/ar/docs/mcp/extend-api-key): MCP: تمديد صلاحية مفتاح API. تعيين انتهاء لاحق (expires_at) لمفتاح API حسب id: حتى 365 يوماً من الآن، أو 30 لمفتاح أنشأه وكيل. لا يمدد الوكيل إلا مفاتيح تفويضه. يلزم تفويض Manage API keys.
- [تجديد مفتاح API](https://sosoapi.ai/ar/docs/mcp/renew-api-key): MCP: تجديد مفتاح API. إنشاء لاحق لمفتاح API ‏(id) بسر جديد يُعاد مرة وإمكانات وحد مساحة العمل نفسها، واختيارياً اسم أوعمر جديد (حتى 365 يوماً، و 30 لما أنشأه وكيل). لا يُلغى الأصل. يلزم تفويض Manage API keys.
- [إلغاء مفتاح API](https://sosoapi.ai/ar/docs/mcp/revoke-api-key): MCP: إلغاء مفتاح API. إلغاء مفتاح API حسب id ليتوقف فوراً؛ المفتاح الملغى يُعيد already_revoked. لا يلغي الوكيل إلا مفاتيح أنشأها تفويضه. يلزم تفويض Manage API keys.
- [جلب حالة الفوترة](https://sosoapi.ai/ar/docs/mcp/get-billing-status): MCP: جلب حالة الفوترة. قراءة خطة فوترة المستخدم وحالة الدفع ومواعيد الدورة الحالية واستخدام الحصص (النشر الناجح والمنشورات المجدولة المعلّقة والحسابات المتصلة). افحصها قبل الجدولة الكبيرة.
- [الحصول على الوصول التجاري](https://sosoapi.ai/ar/docs/mcp/get-commercial-access): MCP: الحصول على الوصول التجاري. قراءة حقائق الخطة والحصص لحساب فوترة مساحة عمل واحدة، مع commercial_access_mode ‏(off أو shadow أو enforce).
- [جلب سياق المؤسسة](https://sosoapi.ai/ar/docs/mcp/get-organization-context): MCP: جلب سياق المؤسسة. قراءة خريطة مؤسساتك ومساحات عملها وقنواتها الحالية بمعرّفاتها وأدوارها. استخدمها عند الحاجة لمعرّفات المؤسسة أوالقناة. للنشر، استخدم id مساحة العمل المُعاد دون قراءة سياقها أيضاً.
- [إنشاء مساحة عمل](https://sosoapi.ai/ar/docs/mcp/create-workspace): MCP: إنشاء مساحة عمل. إنشاء مساحة عمل في مؤسسة تملكها أوتديرها. مرّر organization_id إن انتميت لمؤسسات متعددة. استخدم id المُعاد لاستدعاءاتك التالية؛ لا تفترض أن الجديدة تصبح نشطة.
- [جلب سياق مساحة العمل](https://sosoapi.ai/ar/docs/mcp/get-workspace-context): MCP: جلب سياق مساحة العمل. عرض المساحات التي ينتمي لها المستخدم المسجّل والنشطة بينها. استخدمه عند جهل workspace_id؛ أعِد استخدام السياق الحي دون تكرار القراءتين. النشطة اختيار شخص بتطبيق الويب، لا افتراضي لاستدعاءاتك: مرّر workspace_id صراحةً. ليس قراءة فقط: لحساب بلا مساحة، ينشئ الأولى.
- [تحديث مساحة العمل](https://sosoapi.ai/ar/docs/mcp/update-workspace): MCP: تحديث مساحة العمل. إعادة تسمية مساحة عمل أو تغيير slug. لمالك مساحة العمل فقط.
- [عرض المؤسسات](https://sosoapi.ai/ar/docs/mcp/list-organizations): MCP: عرض المؤسسات. عرض المؤسسات التي ينتمي إليها المستخدم المسجّل، مع المعرّفات التي تستخدمها أدوات نطاق المؤسسة في organization_id.
- [عرض اتصالات المؤسسة](https://sosoapi.ai/ar/docs/mcp/list-organization-connections): MCP: عرض اتصالات المؤسسة. عرض اتصالات مزوّدي الخدمة لمؤسسة (Meta و Instagram و Threads و YouTube) وحالاتها. يلزم organization_id.
- [مراجعة اتصال المؤسسة](https://sosoapi.ai/ar/docs/mcp/review-organization-connection): MCP: مراجعة اتصال المؤسسة. قراءة حسابات وصفحات المزوّد المكتشفة بعملية اتصال معلّقة واحدة (operation_id) للمراجعة. للقراءة فقط: يؤكّد إنسان الاتصال في تطبيق الويب.
- [عرض قنوات المؤسسة](https://sosoapi.ai/ar/docs/mcp/list-organization-channels): MCP: عرض قنوات المؤسسة. عرض قنوات مؤسسة (حسابات مزوّدي الخدمة المتصلة) ومساحة العمل المرتبطة بكل منها.
- [معاينة نقل القناة](https://sosoapi.ai/ar/docs/mcp/preview-organization-channel-move): MCP: معاينة نقل القناة. تجربة دون تنفيذ: فحص إمكانية نقل قناة إلى مساحة عمل أخرى وسرد العوائق. لا يغيّر شيئاً.
- [عرض أعضاء مساحة العمل](https://sosoapi.ai/ar/docs/mcp/list-workspace-members): MCP: عرض أعضاء مساحة العمل. عرض أعضاء مساحة عمل ودعواتها المعلّقة.
- [إرسال ملاحظات](https://sosoapi.ai/ar/docs/mcp/submit-feedback): MCP: إرسال ملاحظات. إرسال ملاحظات منتج (type بقيمة bug أو feature أو general؛ حتى 4,000 حرف) إلى فريق SosoAPI نيابةً عن المستخدم. استخدمه بطلب المستخدم فقط.
- [جلب تفضيلات الإشعارات](https://sosoapi.ai/ar/docs/mcp/get-notification-preferences): MCP: جلب تفضيلات الإشعارات. قراءة إعدادات إشعارات المستخدم (حالياً هل يُرسل بريد إلكتروني عند فشل منشور).
- [تحديث تفضيلات الإشعارات](https://sosoapi.ai/ar/docs/mcp/update-notification-preferences): MCP: تحديث تفضيلات الإشعارات. تغيير إعدادات إشعارات المستخدم (تفعيل email_post_failed أو تعطيله).
- [عرض إشعارات صندوق الوارد](https://sosoapi.ai/ar/docs/mcp/list-inbox-notifications): MCP: عرض إشعارات صندوق الوارد. قراءة صندوق المستخدم داخل التطبيق، من الأحدث (حتى 50)، مع خيار الاقتصار على غير المقروء أو نوع واحد.
- [عرض الحسابات المتصلة](https://sosoapi.ai/ar/docs/mcp/list-connected-accounts): MCP: عرض الحسابات المتصلة. عرض حسابات Instagram و Threads و Facebook و YouTube المتصلة بمساحة عمل، مع صحة الاتصال وحقائق الإمكانات. استخدم معرّفاتها كـ social_account_id للجدولة أوالتعليق. مرّر workspace_id: يُرفض غيابه عند فرض الاستهداف الصريح.
- [فصل حساب تواصل اجتماعي](https://sosoapi.ai/ar/docs/mcp/disconnect-social-account): MCP: فصل حساب تواصل اجتماعي. فصل حساب اجتماعي عن مساحة عمله (لمالك مساحة العمل فقط). يتوقف النشر إليه حتى يعيد إنسان ربطه مع `sosoapi connect`.
- [تعيين المزامنة التلقائية للحساب الاجتماعي](https://sosoapi.ai/ar/docs/mcp/set-social-account-auto-sync): MCP: تعيين المزامنة التلقائية للحساب الاجتماعي. تفعيل المزامنة التلقائية لحساب اجتماعي متصل واحد أو تعطيلها (دور editor). لا ينشر شيئاً.
- [إزالة الحظر عن حساب اجتماعي](https://sosoapi.ai/ar/docs/mcp/clear-social-account-block): MCP: إزالة الحظر عن حساب اجتماعي. إزالة فترة تهدئة مزوّد الخدمة عن حساب لاستئناف النشر. لا يعيد محاولة أي منشور فاشل؛ استخدم sosoapi_retry_scheduled_post لذلك.
- [الاستعلام عن الأصول](https://sosoapi.ai/ar/docs/mcp/query-assets): MCP: الاستعلام عن الأصول. العثور على أصول مساحة عمل حسب asset_type أو source أو tag؛ يُعيد صفحة (limit حتى 100 مع offset) والإجمالي. مرّر workspace_id صراحةً.
- [جلب أصل](https://sosoapi.ai/ar/docs/mcp/get-asset): MCP: جلب أصل. قراءة أصل واحد حسب id: البيانات الوصفية و URL معاينة قصير الصلاحية.
- [إنشاء أصل](https://sosoapi.ai/ar/docs/mcp/create-asset): MCP: إنشاء أصل. تسجيل أصل لوسائط أونص تستضيفه (asset_url و asset_type). لا يرفع شيئاً: استخدم sosoapi_upload_asset للمحلي أو sosoapi_import_asset_url لجلب SosoAPI رابطاً عاماً. مرّر workspace_id (يُرفض غيابه عند فرض الاستهداف الصريح). idempotency_key اختياري.
- [تحديث أصل](https://sosoapi.ai/ar/docs/mcp/update-asset): MCP: تحديث أصل. تغيير عنوان أصل أو وصفه أو وسومه (دور editor).
- [حذف أصل](https://sosoapi.ai/ar/docs/mcp/delete-asset): MCP: حذف أصل. حذف أصل واحد من مكتبة مساحة العمل حسب id. لمالك مساحة العمل فقط.
- [عرض الأصول](https://sosoapi.ai/ar/docs/mcp/list-assets): MCP: عرض الأصول. عرض أصول مساحة عمل بترشيح kind ‏(video و image و audio و cover و thumbnail و frame و video-source و branding) أو customer_ready_only، بصفحات next_offset. يلزم workspace_id.
- [استيراد أصل من URL](https://sosoapi.ai/ar/docs/mcp/import-asset-url): MCP: استيراد أصل من URL. اطلب من SosoAPI تنزيل URL عام لصورة أوفيديو عبر http(s) إلى تخزين مساحة عمل خاص كأصل جديد. يُعيد import_id؛ استعلم من sosoapi_get_asset_import_status. يلزم idempotency_key ودور editor.
- [جلب حالة استيراد الأصول](https://sosoapi.ai/ar/docs/mcp/get-asset-import-status): MCP: جلب حالة استيراد الأصول. قراءة استيراد حسب import_id. للنشر مرّر include_asset=true: تشمل ready معرّف الأصل المسجّل ونوعه و asset_url الثابت دون get_asset مستقل. لا تُجدول الأصول المعلّقة أوالمفقودة. لا تستخدم المصدر أوالمعاينة هوية وسائط. عند التعثر، اقرأ sosoapi_job_status بـ job_id؛ لا تُكرر الاستيراد.
- [عرض الأصول اليتيمة](https://sosoapi.ai/ar/docs/mcp/list-orphan-assets): MCP: عرض الأصول اليتيمة. عرض عناصر مخزّنة لا يشير إليها سجل أصل في مساحة عمل (تنظيف التخزين)، بصفحات continuation token. لمالك مساحة العمل فقط.
- [حذف الأصول اليتيمة](https://sosoapi.ai/ar/docs/mcp/delete-orphan-assets): MCP: حذف الأصول اليتيمة. حذف عناصر تخزين غير مسجّلة محددة حسب المفتاح. لمالك مساحة العمل فقط؛ اعرضها أولاً باستخدام sosoapi_list_orphan_assets.
- [جلب مخزون تخزين الأصول](https://sosoapi.ai/ar/docs/mcp/get-asset-storage-inventory): MCP: جلب مخزون تخزين الأصول. قراءة مخزون مقسّم إلى صفحات لأصول مساحة العمل المسجّلة وعناصرها المخزّنة لتدقيق التخزين.
- [إنشاء تصدير للأصول](https://sosoapi.ai/ar/docs/mcp/create-asset-export): MCP: إنشاء تصدير للأصول. تصدير أصول محددة (asset_ids) كبيان. يجهّز وضع export_verify_then_purge لإزالة لاحقة. idempotency_key اختياري.
- [التحقّق من تصدير الأصول](https://sosoapi.ai/ar/docs/mcp/verify-asset-export): MCP: التحقّق من تصدير الأصول. بدء التحقّق من تصدير أصل (export_id). يجب التحقّق من التصدير قبل طلب الإزالة.
- [جلب حالة تصدير الأصول](https://sosoapi.ai/ar/docs/mcp/get-asset-export-status): MCP: جلب حالة تصدير الأصول. قراءة حالة تصدير أصل: exported أو verification_required أو verifying أو verified أو failed.
- [طلب إزالة أصل](https://sosoapi.ai/ar/docs/mcp/request-asset-purge): MCP: طلب إزالة أصل. طلب حذف دائم لبايتات أصول يغطيها تصدير متحقّق منه (export_id و asset_ids؛ وقد يلزم confirm_history_loss). لمالك مساحة العمل فقط؛ الحذف لا رجعة فيه.
- [إعادة محاولة إزالة الأصل](https://sosoapi.ai/ar/docs/mcp/retry-asset-purge): MCP: إعادة محاولة إزالة الأصل. إعادة محاولة طلب إزالة توقّف (purge_request_id). لمالك مساحة العمل فقط.
- [عرض المشاريع](https://sosoapi.ai/ar/docs/mcp/list-projects): MCP: عرض المشاريع. عرض مشاريع مساحة عمل (طبقة اختيارية للمصدر والإعدادات الافتراضية للحساب) والمشروع النشط.
- [جلب مشروع](https://sosoapi.ai/ar/docs/mcp/get-project): MCP: جلب مشروع. قراءة مشروع واحد حسب id: الاسم وحالة دورة الحياة وإصدارات دورة الحياة والإعدادات الافتراضية اللازمة للكتابات اللاحقة.
- [إنشاء مشروع](https://sosoapi.ai/ar/docs/mcp/create-project): MCP: إنشاء مشروع. إنشاء مشروع في مساحة عمل. لمالك مساحة العمل فقط؛ و idempotency_key اختياري.
- [تحديث مشروع](https://sosoapi.ai/ar/docs/mcp/update-project): MCP: تحديث مشروع. إعادة تسمية مشروع (اسمه هو الحقل الوحيد القابل للتعديل). لمالك مساحة العمل فقط.
- [تعيين المشروع النشط](https://sosoapi.ai/ar/docs/mcp/set-active-project): MCP: تعيين المشروع النشط. تعيين المشروع النشط للمستخدم (قيمة افتراضية على الخادم).
- [جلب الإعدادات الافتراضية لحساب المشروع](https://sosoapi.ai/ar/docs/mcp/get-project-account-defaults): MCP: جلب الإعدادات الافتراضية لحساب المشروع. قراءة الحسابات الاجتماعية الافتراضية لمشروع وتجاوزات كل حساب، مع defaults_version اللازم للاستبدال التالي.
- [استبدال الإعدادات الافتراضية لحساب المشروع](https://sosoapi.ai/ar/docs/mcp/replace-project-account-defaults): MCP: استبدال الإعدادات الافتراضية لحساب المشروع. استبدال الحسابات الافتراضية لمشروع وتجاوزاتها بخطوة واحدة. يلزم expected_defaults_version من أحدث قراءة و idempotency_key (دور editor).
- [أرشفة مشروع](https://sosoapi.ai/ar/docs/mcp/archive-project): MCP: أرشفة مشروع. أرشفة مشروع دون تغيير Scheduled Posts التابعة له. لإيقاف منشور، ألغِ Scheduled Post المعني منفصلاً. لمالك مساحة العمل فقط؛ مرّر expected_lifecycle_version و idempotency_key.
- [إلغاء أرشفة مشروع](https://sosoapi.ai/ar/docs/mcp/unarchive-project): MCP: إلغاء أرشفة مشروع. إعادة تنشيط مشروع مؤرشف. لا يستأنف المنشورات أويعيد جدولتها؛ أدِرها عبر Scheduled Posts. لمالك مساحة العمل فقط؛ مرّر expected_lifecycle_version و idempotency_key.
- [جلب سجل دورة حياة المشروع](https://sosoapi.ai/ar/docs/mcp/get-project-lifecycle-history): MCP: جلب سجل دورة حياة المشروع. قراءة أحداث دورة حياة مشروع (مثل الأرشفة وإلغائها)، حتى 200 حدث.
- [جلب ملف المشروع](https://sosoapi.ai/ar/docs/mcp/get-project-profile): MCP: جلب ملف المشروع. قراءة ملف العلامة التجارية لمشروع (الشعار اللفظي والنبرة والجمهور المستهدف والأهداف ولوحة الألوان وغيرها)؛ يكون profile بقيمة null عند غيابه.
- [تحديث ملف المشروع](https://sosoapi.ai/ar/docs/mcp/update-project-profile): MCP: تحديث ملف المشروع. تعديل حقول ملف العلامة التجارية لمشروع جزئياً. تبقى الحقول المحذوفة من الطلب كما هي. يلزم expected_profile_version من أحدث قراءة و idempotency_key (دور editor).
- [عرض أصول المشروع](https://sosoapi.ai/ar/docs/mcp/list-project-assets): MCP: عرض أصول المشروع. عرض الأصول المرتبطة بمشروع وعلاقة كل رابط (identity أو source أو reference)، مع تصفّح الصفحات باستخدام cursor.
- [ربط أصل بالمشروع](https://sosoapi.ai/ar/docs/mcp/link-project-asset): MCP: ربط أصل بالمشروع. ربط أصل موجود بمشروع بوصفه identity أو source أو reference. يلزم دور editor و idempotency_key.
- [إلغاء ربط أصل بالمشروع](https://sosoapi.ai/ar/docs/mcp/unlink-project-asset): MCP: إلغاء ربط أصل بالمشروع. إزالة ربط أصل بمشروع؛ يُحتفظ بالأصل نفسه. يلزم idempotency_key.
- [عرض حسابات المشروع](https://sosoapi.ai/ar/docs/mcp/list-project-accounts): MCP: عرض حسابات المشروع. عرض الحسابات الاجتماعية المرتبطة بمشروع، مع تصفّح الصفحات باستخدام cursor.
- [ربط حساب بالمشروع](https://sosoapi.ai/ar/docs/mcp/link-project-account): MCP: ربط حساب بالمشروع. ربط حساب اجتماعي متصل بمشروع. يلزم دور editor و idempotency_key.
- [إلغاء ربط حساب بالمشروع](https://sosoapi.ai/ar/docs/mcp/unlink-project-account): MCP: إلغاء ربط حساب بالمشروع. إزالة ربط حساب اجتماعي بمشروع؛ يبقى الحساب متصلاً. يلزم idempotency_key.
- [إنشاء تصدير للمشروع](https://sosoapi.ai/ar/docs/mcp/create-project-export): MCP: إنشاء تصدير للمشروع. بدء تصدير مشروع (لمالك مساحة العمل فقط)؛ استعلم من sosoapi_get_project_export_status عن URL التنزيل. يلزم idempotency_key.
- [جلب حالة تصدير المشروع](https://sosoapi.ai/ar/docs/mcp/get-project-export-status): MCP: جلب حالة تصدير المشروع. قراءة تصدير مشروع (export_id): ‏queued أو processing أو completed (مع URL تنزيل قصير الصلاحية) أو failed. لمالك مساحة العمل فقط.
- [عرض ما يستلزم الانتباه في النشر](https://sosoapi.ai/ar/docs/mcp/list-publication-attentions): MCP: عرض ما يستلزم الانتباه في النشر. عرض المنشورات التي تستدعي الانتباه في مساحة عمل، بترشيح status ‏(open أو resolved) أو scheduled_post_id، وصفحات offset.
- [جلب رصيد النشر على X](https://sosoapi.ai/ar/docs/mcp/get-x-usage): MCP: جلب رصيد النشر على X. قراءة أرصدة نشر X للمؤسسة المشتركة مع مساحة العمل. يلزم workspace_id. تحصل Free على 10 مرة واحدة؛ و Pro على 100 لكل فترة فوترة. النص يكلّف 1، ومع URL يكلّف 10. نص اختياري لتقدير كلفته. يقرأ الحصة المخزّنة دون X API.
- [عرض المنشورات المجدولة](https://sosoapi.ai/ar/docs/mcp/list-scheduled-posts): MCP: عرض المنشورات المجدولة. عرض منشورات مساحة عمل المجدولة بترشيح المشروع والحالة (scheduled و publishing و published و failed و expired و needs_reschedule و cancelled و deleted) والنطاق الزمني، بصفحات cursor.
- [جلب منشور مجدول](https://sosoapi.ai/ar/docs/mcp/get-scheduled-post): MCP: جلب منشور مجدول. قراءة منشور مجدول واحد حسب id: المحتوى والحالة وحالة التسليم والنتائج. إصداره هو ما تحتاجه عمليات update و publish و retry و cancel في expected_version.
- [جلب أهلية المنشور المجدول](https://sosoapi.ai/ar/docs/mcp/get-scheduled-post-eligibility): MCP: جلب أهلية المنشور المجدول. فحص تمهيدي للقراءة فقط لكل وجهة. ضمّن draft ‏(caption و hashtags و scheduled_at و display_timezone والوقت المحلي/DST اختيارياً) لفحص المحتوى والتوقيت؛ يضيف include_quota=true لقطة استشارية للفترة. ارفع/استورد وانتظر الجاهزية أولاً. دون draft، يُفحص الحساب/الوسائط فقط. لا يحجز شيئاً؛ يعيد create/dispatch فحص الحدود والصلاحيات.
- [إنشاء منشور مجدول](https://sosoapi.ai/ar/docs/mcp/create-scheduled-post): MCP: إنشاء منشور مجدول. جدولة حساب واحد في scheduled_at مع provider_payload. تحتاج الوسائط asset_id جاهزاً ورابطاً أساسياً؛ لصورة مصدر واحدة استخدم sosoapi_post_image_url. وفّر local_scheduled_at و schedule_dst_disambiguation معاً أواحذفهما. يلزم publish ودور editor و idempotency_key. الجدولة ليست نشراً: اقرأ النتيجة.
- [إنشاء منشورات مجدولة جماعياً](https://sosoapi.ai/ar/docs/mcp/bulk-create-scheduled-posts): MCP: إنشاء منشورات مجدولة جماعياً. جدولة منشورات لحسابات متعددة باستدعاء واحد (targets). تحتاج الوسائط asset_ids مرفوعة/مستوردة جاهزة وروابطها الأساسية. ينجح أويفشل كل هدف مستقلاً ويظهر في successes أو failures. تلزم إمكانية publish.
- [تحديث منشور مجدول](https://sosoapi.ai/ar/docs/mcp/update-scheduled-post): MCP: تحديث منشور مجدول. تحرير منشور مجدول لم يُرسَل للتنفيذ بعد (النص والوسوم والوسائط والرابط والوقت). يلزم expected_version من أحدث قراءة؛ يُرفض الإصدار القديم.
- [نشر منشور مجدول الآن](https://sosoapi.ai/ar/docs/mcp/publish-scheduled-post-now): MCP: نشر منشور مجدول الآن. نشر منشور مجدول فوراً بدلاً من scheduled_at. علني ولا يمكن التراجع عنه؛ يلزم expected_version. الإدراج ليس نشراً: اقرأ outcome.
- [إعادة محاولة منشور مجدول](https://sosoapi.ai/ar/docs/mcp/retry-scheduled-post): MCP: إعادة محاولة منشور مجدول. إعادة محاولة منشور مجدول فاشل، مع scheduled_at جديد اختيارياً. يلزم expected_version.
- [حذف منشور مجدول](https://sosoapi.ai/ar/docs/mcp/delete-scheduled-post): MCP: حذف منشور مجدول. حذف منشور مجدول غير منشور (scheduled أو needs_reschedule أو failed أو cancelled). لا يحذف الوكلاء محتوى المزوّد بعد نشره. يلزم expected_version.
- [إلغاء منشور مجدول](https://sosoapi.ai/ar/docs/mcp/cancel-scheduled-post): MCP: إلغاء منشور مجدول. إلغاء منشور مجدول لم يُنشر بعد كي لا يُنشر أبداً. يُرفض المنشور المنشور، ولا يحذف الوكيل محتوى منشوراً أيضاً: يفعل المستخدم ذلك في تطبيق الويب. يلزم expected_version.
- [سحب طلب الحذف](https://sosoapi.ai/ar/docs/mcp/withdraw-scheduled-post-delete): MCP: سحب طلب الحذف. سحب طلب حذف Instagram Login متوقف والاحتفاظ بالمنشور المنشور. يلزم expected_version.
- [جلب أعداد لوحة المعلومات](https://sosoapi.ai/ar/docs/mcp/get-dashboard-counts): MCP: جلب أعداد لوحة المعلومات. قراءة الأعداد التشغيلية لمساحة عمل: المنشورات المجدولة والمهام الحديثة والحسابات المتصلة.
- [عرض المنشورات المراقَبة](https://sosoapi.ai/ar/docs/mcp/list-monitored-posts): MCP: عرض المنشورات المراقَبة. عرض المنشورات الاجتماعية التي اكتشفها SosoAPI لمساحة عمل (id و platform و permalink ووقت النشر)، بترشيح الحساب والمنصة والوقت وصفحات cursor. بيانات وصفية فقط، بلا نصوص منشورات.
- [عرض تعليقات المنشور](https://sosoapi.ai/ar/docs/mcp/list-post-comments): MCP: عرض تعليقات المنشور. عرض التعليقات المرصودة على منشورات مساحة العمل، بأحدث ملاحظة أولاً، مع الكاتب والنص؛ بترشيح المنشور أوالحساب أوالمنصة أوالوقت، وصفحات cursor. النص من أطراف ثالثة وموسوم untrusted.
- [طلب رؤى مزوّد الخدمة](https://sosoapi.ai/ar/docs/mcp/request-provider-insights): MCP: طلب رؤى مزوّد الخدمة. طلب رؤى حساب أومنشور واحد من المزوّد ضمن نطاق تاريخ اختياري (حتى 366 يوماً). يُعيد request_id والنتيجة إن كانت مخزنة مؤقتاً؛ وإلا فاستعلم من sosoapi_get_provider_insight_status.
- [جلب حالة رؤى مزوّد الخدمة](https://sosoapi.ai/ar/docs/mcp/get-provider-insight-status): MCP: جلب حالة رؤى مزوّد الخدمة. قراءة طلب رؤى (request_id): ‏queued أو processing أو completed (مع نتيجة مزوّد الخدمة وتوفر كل مقياس) أو failed.
- [بدء Instagram OAuth](https://sosoapi.ai/ar/docs/mcp/start-instagram-oauth): MCP: بدء Instagram OAuth. جلب authorize_url لدى المزوّد، ليفتحه إنسان ويربط حساب Instagram. مرّر workspace_id. لا يتم الربط حتى يوافق ويؤكّد في المتصفح.
- [تحديث Instagram OAuth](https://sosoapi.ai/ar/docs/mcp/refresh-instagram-oauth): MCP: تحديث Instagram OAuth. تحديث رمز وصول اتصال Instagram ‏(لحساب social_account_id واحد اختيارياً)؛ يُبلغ عن حدوث التحديث والانتهاء الجديد.
- [بدء Threads OAuth](https://sosoapi.ai/ar/docs/mcp/start-threads-oauth): MCP: بدء Threads OAuth. جلب authorize_url لدى المزوّد، ليفتحه إنسان ويربط حساب Threads. مرّر workspace_id. لا يتم الربط حتى يوافق ويؤكّد في المتصفح.
- [تحديث Threads OAuth](https://sosoapi.ai/ar/docs/mcp/refresh-threads-oauth): MCP: تحديث Threads OAuth. تحديث رمز وصول اتصال Threads ‏(لحساب social_account_id واحد اختيارياً)؛ يُبلغ عن حدوث التحديث والانتهاء الجديد.
- [فحص Threads OAuth](https://sosoapi.ai/ar/docs/mcp/check-threads-oauth): MCP: فحص Threads OAuth. قراءة صحة اتصال Threads: الاتصال والانتهاء والنطاق وإمكانية التحديث. مرّر workspace_id.
- [بدء Meta OAuth](https://sosoapi.ai/ar/docs/mcp/start-meta-oauth): MCP: بدء Meta OAuth. جلب authorize_url لدى المزوّد ليفتحه إنسان ويربط صفحة Facebook، أو Instagram عبر Facebook ‏(connection_intent). مرّر workspace_id. لا ربط حتى الموافقة والتأكيد بالمتصفح.
- [تحديث Meta OAuth](https://sosoapi.ai/ar/docs/mcp/refresh-meta-oauth): MCP: تحديث Meta OAuth. إعادة التحقّق من اتصال Facebook/Meta ‏(social_account_id) والإبلاغ عن capability_verified.
- [بدء YouTube OAuth](https://sosoapi.ai/ar/docs/mcp/start-youtube-oauth): MCP: بدء YouTube OAuth. جلب authorize_url لدى المزوّد، ليفتحه إنسان ويربط قناة YouTube. مرّر workspace_id. لا يتم الربط حتى يوافق ويؤكّد في المتصفح.
- [تحديث YouTube OAuth](https://sosoapi.ai/ar/docs/mcp/refresh-youtube-oauth): MCP: تحديث YouTube OAuth. تحديث رمز اتصال YouTube ‏(social_account_id)؛ يُعيد الانتهاء الجديد و capability_verified.
- [عرض المهام](https://sosoapi.ai/ar/docs/mcp/list-jobs): MCP: عرض المهام. عرض المهام الخلفية الحديثة للمستخدم المسجّل مع الحالة والتقدم.
- [جلب حالة المهمة](https://sosoapi.ai/ar/docs/mcp/job-status): MCP: جلب حالة المهمة. قراءة مهمة خلفية واحدة حسب job_id: الحالة والنوع ورسالة الخطأ إذا فشلت.
- [جلب نتيجة تسليم التعليق](https://sosoapi.ai/ar/docs/mcp/get-comment-outcome): MCP: جلب نتيجة تسليم التعليق. قراءة التسليم المؤكد وتسلسل الاسترداد والتحقّق المعلّق والمتابعة التي لم تُحسم.
- [تسوية نتيجة تسليم التعليق](https://sosoapi.ai/ar/docs/mcp/reconcile-comment-outcome): MCP: تسوية نتيجة تسليم التعليق. التحقّق من تسليم Facebook غامض دون إعادة إرسال، أو ربط بديل مطابق واحد مؤكّد. افحص outcome للدليل النهائي.
- [جلب إمكانات المجتمع](https://sosoapi.ai/ar/docs/mcp/get-community-engagement-capabilities): MCP: جلب إمكانات المجتمع. قراءة الإجراءات المجتمعية المدعومة (reply و hide و unhide و create_comment) لكل حساب متصل، وما إذا كان الحساب مؤهلاً حالياً.
- [الاستعلام عن قائمة المراجعة المجتمعية](https://sosoapi.ai/ar/docs/mcp/query-community-review-queue): MCP: الاستعلام عن قائمة المراجعة المجتمعية. قراءة التعليقات المنتظرة للمراجعة مع سياق سلسلتها، بترشيح الأولوية أواللغة أوالحساب أوالعمر؛ الصفحة الفارغة لا تعني النجاح. نصوصها من أطراف ثالثة وموسومة untrusted.
- [إرسال مراجعة مجتمعية](https://sosoapi.ai/ar/docs/mcp/submit-community-review): MCP: إرسال مراجعة مجتمعية. تسجيل نسخة مراجعة جديدة غير قابلة للتعديل لتعليق واحد: الإجراء الموصى به و reply_draft اختياري و priority و confidence (على الأقل 0.9). لا يرسل أويُعدّ شيئاً.
- [إعداد إجراء مجتمعي](https://sosoapi.ai/ar/docs/mcp/prepare-community-action): MCP: إعداد إجراء مجتمعي. ربط نسخة مراجعة بإجراء واحد (reply أو hide أو unhide) والحصول على prepare_token قصير الصلاحية لـ sosoapi_apply_community_action. لا يرسل شيئاً بعد.
- [تطبيق إجراء مجتمعي](https://sosoapi.ai/ar/docs/mcp/apply-community-action): MCP: تطبيق إجراء مجتمعي. إرسال الإجراء المرتبط بـ prepare_token إلى مزوّد الخدمة؛ الرد علني. الإدراج في القائمة ليس نجاحاً: استعلم من sosoapi_get_community_action_status.
- [جلب حالة الإجراء المجتمعي](https://sosoapi.ai/ar/docs/mcp/get-community-action-status): MCP: جلب حالة الإجراء المجتمعي. قراءة الإيصال النهائي لإجراء مجتمعي مُطبّق (action_id)؛ الإدراج في القائمة لا يعني النجاح.
- [إنشاء تعليق مجتمعي](https://sosoapi.ai/ar/docs/mcp/create-comment): MCP: إنشاء تعليق مجتمعي. إدراج تعليق محدد واحد لمنشور أو تعليق أساسي مستهدف؛ الحالة لا تعني نجاح مزوّد الخدمة.
- [جلب حالة التعليق المجتمعي](https://sosoapi.ai/ar/docs/mcp/get-comment-action-status): MCP: جلب حالة التعليق المجتمعي. قراءة الإيصال النهائي المنقّح لإجراء تعليق مباشر.
- [جلب ملخص المجتمع](https://sosoapi.ai/ar/docs/mcp/get-community-engagement-summary): MCP: جلب ملخص المجتمع. قراءة ملخص العمليات المجتمعية لمساحة عمل: وضع المسار والتراكم وأزمنة الاستجابة وحالات الإجراءات ومعدلات مزوّدي الخدمة.
- [نشر صورة واحدة من URL](https://sosoapi.ai/ar/docs/mcp/post-image-url): MCP: نشر صورة واحدة من URL. أرسِل منشور URL الصورة الكامل مرة، مع media فارغة. تُعدّه الخلفية وتنشره حتى بعد الانقطاع. تُعيد النشر النهائي إن توفر خلال 35 ثانية، وإلا معرّفاً دائماً؛ لا تُعد الإرسال بمفتاح جديد. يلزم operate و publish. حقلا الوقت المحلي/DST معاً. import_id لاستئناف العملاء القدامى فقط.
- [رفع صورة أو فيديو محلي](https://sosoapi.ai/ar/docs/mcp/upload-asset): MCP: رفع صورة أو فيديو محلي. رفع صورة أوفيديو محلي إلى مكتبة أصول المساحة وتسجيله. تُقبل ملفات PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG الحقيقية فقط حتى 500 MiB من مجلد العمل أوالمؤقت أو Pictures/Movies/Videos أو SOSOAPI_UPLOAD_ROOTS؛ تُرفض الملفات والمجلدات النقطية. يُعيد معرّف الأصل ورابطه لوسائط Scheduled Post.