مرجع الأدوات
يوفر خادم MCP من شارك الأدوات التالية. أنت لا تستدعيها بالاسم أبدًا: مساعدك هو من يختارها، وغالبًا ما يسلسل عدة أدوات ليجيب طلبًا واحدًا. وهذه الصفحة هنا لتعرف ما الممكن، ولتميز بين أداة فشلت ومساعد لم يحاول أصلًا.
| الأداة | ما الذي تفعله |
|---|---|
integrationList |
تسرد قنواتك المربوطة |
groupList |
تسرد علاماتك التجارية |
integrationSchema |
تقرأ ما يشترطه نوع القناة قبل النشر |
triggerTool |
تبحث عن المعرفات التي تحتاجها القناة، مثل لوحة أو مجتمع subreddit |
integrationSchedulePostTool |
تنشئ المنشورات وتجدولها |
postsListTool |
تسرد منشوراتك بين تاريخين |
postSettingsTool |
تغير إعدادات منشور لم ينشر بعد |
deletePostTool |
تحذف منشورًا |
uploadFromUrlTool |
تسحب وسائط إلى مكتبتك من رابط عام |
mediaListTool |
تسرد الوسائط الموجودة في مكتبتك |
uploadWidgetTool |
تعرض نافذة رفع للملفات التي على جهازك |
uploadWidgetStatusTool |
تسرد الملفات المرفوعة عبر تلك النافذة |
generateImageTool |
تولد صورة |
generateVideoOptions |
تسرد طرق توليد الفيديو المتاحة |
videoFunctionTool |
تجلب الخيارات التي يحتاجها مولد الفيديو، مثل الأصوات |
generateVideoTool |
تبدأ توليد فيديو |
videoStatusTool |
تتحقق من فيديو قيد التوليد |
ask_sharek |
تطرح سؤالًا على وكيل شارك |
أي ربط يحصل على أي أدوات
Section titled “أي ربط يحصل على أي أدوات”طريقة ربط أداتك هي التي تحدد ما تراه منها:
- مفتاح API: كل الأدوات أعلاه.
- تسجيل الدخول عبر شارك: كل الأدوات ما عدا
ask_sharek.
ولا تظهر نافذة الرفع إلا في التطبيقات التي تعرض واجهات تفاعلية، مثل Claude وChatGPT. وفي غيرها يضيف مساعدك الوسائط من رابط بدلًا من ذلك.
العثور على قنواتك
Section titled “العثور على قنواتك”integrationList
Section titled “integrationList”تسرد القنوات المربوطة بحسابك: المعرف الذي يحتاجه مساعدك في كل استدعاء لاحق، واسم القناة، وأي منصة هي.
تأخذ معرف group اختياريًا لحصر القائمة في علامة تجارية واحدة. وبدونه تحصل على كل شيء.
المقابل في API: سرد القنوات.
groupList
Section titled “groupList”تسرد علاماتك التجارية. مفيدة حين تدير قنوات لعدة علامات تجارية وتريد أن يعمل المساعد داخل
واحدة منها. مرر معرف العلامة التجارية من هنا إلى integrationList. وما زالت الأدوات
تسمي العلامة التجارية بأسمائها القديمة: group في integrationList، وcustomer في
postsListTool.
المقابل في API: سرد العلامات التجارية.
فهم القناة قبل النشر
Section titled “فهم القناة قبل النشر”integrationSchema
Section titled “integrationSchema”الخطوة التي تصنع الفرق بين منشور يجدول وآخر يرفض. فهي تعيد، لنوع قناة بعينه، قواعد المنصة، وأقصى طول للمحتوى، والإعدادات التي تقبلها تلك القناة، والأدوات المساعدة المتاحة لملء تلك الإعدادات.
تحتاج اسم المزود وما إذا كان الحساب مميزًا، وهو ما يهم على X حيث تحصل الحسابات المميزة على منشورات أطول.
المقابل في API: جلب قواعد القناة ومخطط إعداداتها.
triggerTool
Section titled “triggerTool”بعض الإعدادات تطلب معرفًا لا سبيل لك إلى معرفته. أي مجتمع subreddit، وأي لوحة على Pinterest، وأي
قناة على Discord. وتحدد integrationSchema الأداة المساعدة التي ينبغي استدعاؤها، وهذه الأداة
تستدعيها.
تحتاج معرف القناة، واسم الأداة المساعدة من ذلك المخطط، وما تطلبه تلك الأداة، وهو أحيانًا كلمة بحث. فإن سألك مساعدك «أي لوحة؟» في منتصف الطلب، فهذا هو السبب.
وعلى LinkedIn، تضم الأدوات المساعدة أداة بحث للإشارة: تجد صفحة شركة لتشير إليها في
المنشور باسمها المختصر الدقيق في الرابط، أي الجزء الذي يلي linkedin.com/company/.
وLinkedIn هي القناة الوحيدة التي توفر هذه الأداة حاليًا.
المقابل في API: تشغيل أداة قناة.
الجدولة
Section titled “الجدولة”integrationSchedulePostTool
Section titled “integrationSchedulePostTool”الأداة التي تنشئ المنشور فعلًا. وكل ما عداها موجود ليغذيها.
لكل قناة تنشر إليها، تأخذ:
- معرف القناة وما إذا كان ذلك الحساب مميزًا.
- تاريخًا بتوقيت UTC.
- نوعًا:
draftلحفظه مسودة، أوscheduleلوضعه في قائمة الانتظار، أوnowللنشر فورًا. - المحتوى، كقائمة أولها المنشور وكل عنصر بعده تعليق أو الجزء التالي من سلسلة النقاش.
- الوسائط على كل عنصر من تلك القائمة. وكل مرفق إما عنوان وسائط يستضيفها شارك، وإما
كائن فيه ذلك العنوان في
pathمع نص بديل اختياري فيalt. وللفيديو، يمكن للكائن أن يحدد الغلاف أيضًا:thumbnail، وهو عنوان صورة JPEG أو PNG مرفوعة، أوthumbnailTimestamp، وهو اللقطة المطلوبة بالملي ثانية. - الإعدادات التي قال
integrationSchemaإن هذه القناة تحتاجها. - ما إذا كانت الروابط تختصر في المحتوى.
المحتوى HTML لا نصًا عاديًا. فكل سطر يغلف بـ <p>، ووسوم HTML المسموح بها هي p وh1
وh2 وh3 وul وli وstrong وu، إضافة إلى img على المنصات التي تضع قواعدها الصور
داخل النص، وspan للإشارة فقط، مكتوبًا تمامًا كما تعيده أداة البحث للإشارة. ولا يمكن
الجمع بين العريض والتسطير على النص نفسه. مساعدك يتولى هذا؛ وهو لا يهمك
إلا حين تتساءل لماذا خرج التنسيق مختلفًا عما كتبت.
والاستدعاء الواحد يحمل منشورات كثيرة. فعشرون منشورًا إلى Facebook على مدى عشرين يومًا استدعاء واحد بعشرين مدخلًا، لا عشرون استدعاءً. ويعود كل منشور برابط معاينة تستطيع فتحه.
وهذه الأداة تنشئ المنشورات فقط. أما تغيير منشور أو حذفه فيمر عبر أدوات القسم التالي.
المقابل في API: إنشاء منشور.
إدارة المنشورات
Section titled “إدارة المنشورات”postsListTool
Section titled “postsListTool”تسرد كل المنشورات بين تاريخين، أيًا كانت حالتها: مجدولة أو مسودة أو منشورة أو فاشلة. تحتاج تاريخ بداية وتاريخ نهاية بتوقيت UTC، وتأخذ معرف علامة تجارية اختياريًا لحصرها في علامة تجارية واحدة. ويعود كل منشور بمعرفه، وتاريخ نشره، وحالته، وأي خطأ فيه، ومحتواه، وقناته، وإعداداته الحالية.
ولرؤية كل ما هو قادم، يمرر مساعدك مدة واسعة، مثل العام المقبل. والمعرفات التي يحصل عليها هنا هي ما تحتاجه الأداتان التاليتان.
المقابل في API: سرد المنشورات.
postSettingsTool
Section titled “postSettingsTool”تغير إعدادات المنصة لمنشور لم ينشر بعد، مجدول أو مسودة، مثل من يستطيع الرد على X. ويبقى النص والتاريخ كما هما تمامًا.
تحتاج معرف المنشور والإعدادات المراد تغييرها فقط. وما لا تمرره يبقى كما كان. وأي الإعدادات
موجود يأتي من integrationSchema.
المقابل في API: تحديث إعدادات المنشور.
deletePostTool
Section titled “deletePostTool”تحذف منشورًا واحدًا على قناة واحدة، مع تعليقاته. تحتاج معرف المنشور.
- المنشور الذي أنشأته لعدة قنوات له معرف مستقل على كل قناة، فحذفه من قناة يترك الباقي.
- المنشور المتكرر يحذف بكل تكراراته.
- المنشور المجدول المحذوف لا ينشر أبدًا.
- حذف منشور سبق نشره يزيله من شارك فقط، ويبقى ظاهرًا على الشبكة الاجتماعية.
ولا يمكن التراجع عن الحذف.
المقابل في API: حذف منشور.
الوسائط
Section titled “الوسائط”uploadFromUrlTool
Section titled “uploadFromUrlTool”تسحب صورة أو فيديو من رابط عام إلى مكتبة الوسائط وتعيد النسخة المخزنة.
وهذه ليست تحسينًا للأداء. فالمرفقات يجب أن يستضيفها شارك، ومن ثم فالوسائط الآتية من أي مكان آخر لا بد أن تمر من هنا قبل أن تصلح لمنشور. فإن أعطيت مساعدك رابط صورة، فهذه هي الأداة التي تجعلها قابلة للاستخدام. أما الملفات التي على جهازك فلا تأتي عبر رابط: استخدم نافذة الرفع أدناه، أو أداة CLI من شارك، أو واجهة API العامة.
المقابل في API: الرفع من عنوان.
mediaListTool
Section titled “mediaListTool”تسرد الصور والفيديوهات الموجودة في مكتبة الوسائط، الأحدث أولًا، 32 في كل مرة، ويمكنها البحث فيها باسم الملف. فيرفق مساعدك واحدًا منها مباشرة بدل رفعه من جديد.
المقابل في API: سرد الوسائط.
uploadWidgetTool
Section titled “uploadWidgetTool”تعرض نافذة رفع في المحادثة، لتضيف صورًا وفيديوهات من جهازك: الصور حتى 10 ميغابايت والفيديوهات حتى 1024 ميغابايت. وما ترفعه يصل إلى مكتبة الوسائط ويصل خبره إلى مساعدك، جاهزًا للإرفاق.
ولا تظهر النافذة إلا في التطبيقات التي تعرض واجهات تفاعلية، مثل Claude وChatGPT. وللحصول على
تذكرة رفع، تستدعي النافذة نفسها uploadWidgetTicketTool، وهي أداة مخصصة للنافذة وحدها:
التطبيقات التي تعرض النافذة تخفيها عن مساعدك، وقد تظهر في قائمة أدوات التطبيقات الأخرى، لكن
مساعدك لا يحتاج إلى استدعائها.
المقابل في API: لا يوجد، فليس للنافذة مسار عام. وأقرب ما يقابلها رفع ملف، الذي يرسل ملفًا من جهازك عبر HTTP.
uploadWidgetStatusTool
Section titled “uploadWidgetStatusTool”تسرد الملفات المرفوعة عبر نافذة رفع واحدة. والملف الذي حالته processing ما زال قيد التجهيز:
اسأل مجددًا بعد لحظة. ولا تسرد بقية مكتبتك، فتلك مهمة mediaListTool.
المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.
generateImageTool
Section titled “generateImageTool”تولد صورة من وصف وتضعها في مكتبة الوسائط، جاهزة للإرفاق. وتعيد الوسائط المخزنة، أو خطأً حين ينفد رصيد الصور لديك.
المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.
generateVideoOptions
Section titled “generateVideoOptions”تسرد مولدات الفيديو المتاحة لك. وكل مولد يصف ما ينتجه وما يصلح له، ليختار المساعد عن قصد ويخبرك بالسبب. والمولدات هي نفسها التي يعرضها المحرر، وهي مشروحة بالتفصيل في صور وفيديو بالذكاء الاصطناعي.
المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.
videoFunctionTool
Section titled “videoFunctionTool”بعض المولدات تحتاج اختيارًا قبل أن تعمل، والصوت أشهرها. وهذه تجلب القيم المتاحة لذلك الاختيار.
المقابل في API: دوال مزودي الفيديو.
generateVideoTool
Section titled “generateVideoTool”تبدأ توليد الفيديو وتعيد معرف مهمة، أو خطأً حين ينفد رصيد الفيديو أو حين لا يتاح نوع الفيديو خلال فترتك التجريبية. ويستغرق التوليد دقائق، لذا لا ينتظره مساعدك: يظهر الفيديو الجاهز في مكتبة الوسائط.
المقابل في API: توليد فيديو.
videoStatusTool
Section titled “videoStatusTool”تتحقق من فيديو بدأ عبر generateVideoTool، بمعرف مهمته. ويستدعيها مساعدك حين تسأل عن
الفيديو لاحقًا. وحين يكتمل، تحمل النتيجة رابط الفيديو، جاهزًا للإرفاق بمنشور.
المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.
سؤال شارك
Section titled “سؤال شارك”ask_sharek
Section titled “ask_sharek”تطرح سؤالًا على وكيل شارك، الذي يجيب باستخدام أدوات هذه الصفحة على حسابك. ولديه أدوات الجدولة والوسائط والفيديو نفسها التي لدى سامي في التطبيق، ولا يملك أيًا من قدرات سامي الخاصة بالمحادثة: فهو لا يقرأ الويب، ولا يستخدم هوية علامتك التجارية، ولا يصنع صورًا من صور ترفقها. مفيدة حين يكون السؤال عن المحتوى أو الاستراتيجية لا عن إجراء بعينه. ولا تتاح إلا للربط الذي يستخدم مفتاح API.
المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.
حين يفشل شيء
Section titled “حين يفشل شيء”- نفاد الرصيد عند توليد صورة أو فيديو يعيد خطأً بدل أن يوقف المحادثة. وكل ما عدا ذلك في الطلب يظل يعمل.
- المنشور المرفوض يكاد يكون دائمًا إعدادًا ناقصًا أو خاطئًا لتلك المنصة. والعلاج نظرة
أخرى في
integrationSchema. - المنشور الذي يتعذر تغييره أو حذفه يعود بخطأ يشرح السبب، مثل تغيير إعدادات منشور سبق نشره.
- عدم سرد أي قناة يعني أن الحساب لا قنوات مربوطة به، لا أن الأداة تعطلت. اربط واحدة أولًا.
والنشر والقنوات والوسائط وبدء توليد فيديو تعمل عبر HTTP أيضًا: انظر
واجهة API العامة. أما توليد الصور، ونافذة الرفع، وgenerateVideoOptions،
وvideoStatusTool، وask_sharek فليس لها مسار عام.