تخطَّ إلى المحتوى

مرجع الأدوات

يوفر خادم 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. وفي غيرها يضيف مساعدك الوسائط من رابط بدلًا من ذلك.

تسرد القنوات المربوطة بحسابك: المعرف الذي يحتاجه مساعدك في كل استدعاء لاحق، واسم القناة، وأي منصة هي.

تأخذ معرف group اختياريًا لحصر القائمة في علامة تجارية واحدة. وبدونه تحصل على كل شيء.

المقابل في API: سرد القنوات.

تسرد علاماتك التجارية. مفيدة حين تدير قنوات لعدة علامات تجارية وتريد أن يعمل المساعد داخل واحدة منها. مرر معرف العلامة التجارية من هنا إلى integrationList. وما زالت الأدوات تسمي العلامة التجارية بأسمائها القديمة: group في integrationList، وcustomer في postsListTool.

المقابل في API: سرد العلامات التجارية.

الخطوة التي تصنع الفرق بين منشور يجدول وآخر يرفض. فهي تعيد، لنوع قناة بعينه، قواعد المنصة، وأقصى طول للمحتوى، والإعدادات التي تقبلها تلك القناة، والأدوات المساعدة المتاحة لملء تلك الإعدادات.

تحتاج اسم المزود وما إذا كان الحساب مميزًا، وهو ما يهم على X حيث تحصل الحسابات المميزة على منشورات أطول.

المقابل في API: جلب قواعد القناة ومخطط إعداداتها.

بعض الإعدادات تطلب معرفًا لا سبيل لك إلى معرفته. أي مجتمع subreddit، وأي لوحة على Pinterest، وأي قناة على Discord. وتحدد integrationSchema الأداة المساعدة التي ينبغي استدعاؤها، وهذه الأداة تستدعيها.

تحتاج معرف القناة، واسم الأداة المساعدة من ذلك المخطط، وما تطلبه تلك الأداة، وهو أحيانًا كلمة بحث. فإن سألك مساعدك «أي لوحة؟» في منتصف الطلب، فهذا هو السبب.

وعلى LinkedIn، تضم الأدوات المساعدة أداة بحث للإشارة: تجد صفحة شركة لتشير إليها في المنشور باسمها المختصر الدقيق في الرابط، أي الجزء الذي يلي linkedin.com/company/. وLinkedIn هي القناة الوحيدة التي توفر هذه الأداة حاليًا.

المقابل في API: تشغيل أداة قناة.

الأداة التي تنشئ المنشور فعلًا. وكل ما عداها موجود ليغذيها.

لكل قناة تنشر إليها، تأخذ:

  • معرف القناة وما إذا كان ذلك الحساب مميزًا.
  • تاريخًا بتوقيت 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: إنشاء منشور.

تسرد كل المنشورات بين تاريخين، أيًا كانت حالتها: مجدولة أو مسودة أو منشورة أو فاشلة. تحتاج تاريخ بداية وتاريخ نهاية بتوقيت UTC، وتأخذ معرف علامة تجارية اختياريًا لحصرها في علامة تجارية واحدة. ويعود كل منشور بمعرفه، وتاريخ نشره، وحالته، وأي خطأ فيه، ومحتواه، وقناته، وإعداداته الحالية.

ولرؤية كل ما هو قادم، يمرر مساعدك مدة واسعة، مثل العام المقبل. والمعرفات التي يحصل عليها هنا هي ما تحتاجه الأداتان التاليتان.

المقابل في API: سرد المنشورات.

تغير إعدادات المنصة لمنشور لم ينشر بعد، مجدول أو مسودة، مثل من يستطيع الرد على X. ويبقى النص والتاريخ كما هما تمامًا.

تحتاج معرف المنشور والإعدادات المراد تغييرها فقط. وما لا تمرره يبقى كما كان. وأي الإعدادات موجود يأتي من integrationSchema.

المقابل في API: تحديث إعدادات المنشور.

تحذف منشورًا واحدًا على قناة واحدة، مع تعليقاته. تحتاج معرف المنشور.

  • المنشور الذي أنشأته لعدة قنوات له معرف مستقل على كل قناة، فحذفه من قناة يترك الباقي.
  • المنشور المتكرر يحذف بكل تكراراته.
  • المنشور المجدول المحذوف لا ينشر أبدًا.
  • حذف منشور سبق نشره يزيله من شارك فقط، ويبقى ظاهرًا على الشبكة الاجتماعية.

ولا يمكن التراجع عن الحذف.

المقابل في API: حذف منشور.

تسحب صورة أو فيديو من رابط عام إلى مكتبة الوسائط وتعيد النسخة المخزنة.

وهذه ليست تحسينًا للأداء. فالمرفقات يجب أن يستضيفها شارك، ومن ثم فالوسائط الآتية من أي مكان آخر لا بد أن تمر من هنا قبل أن تصلح لمنشور. فإن أعطيت مساعدك رابط صورة، فهذه هي الأداة التي تجعلها قابلة للاستخدام. أما الملفات التي على جهازك فلا تأتي عبر رابط: استخدم نافذة الرفع أدناه، أو أداة CLI من شارك، أو واجهة API العامة.

المقابل في API: الرفع من عنوان.

تسرد الصور والفيديوهات الموجودة في مكتبة الوسائط، الأحدث أولًا، 32 في كل مرة، ويمكنها البحث فيها باسم الملف. فيرفق مساعدك واحدًا منها مباشرة بدل رفعه من جديد.

المقابل في API: سرد الوسائط.

تعرض نافذة رفع في المحادثة، لتضيف صورًا وفيديوهات من جهازك: الصور حتى 10 ميغابايت والفيديوهات حتى 1024 ميغابايت. وما ترفعه يصل إلى مكتبة الوسائط ويصل خبره إلى مساعدك، جاهزًا للإرفاق.

ولا تظهر النافذة إلا في التطبيقات التي تعرض واجهات تفاعلية، مثل Claude وChatGPT. وللحصول على تذكرة رفع، تستدعي النافذة نفسها uploadWidgetTicketTool، وهي أداة مخصصة للنافذة وحدها: التطبيقات التي تعرض النافذة تخفيها عن مساعدك، وقد تظهر في قائمة أدوات التطبيقات الأخرى، لكن مساعدك لا يحتاج إلى استدعائها.

المقابل في API: لا يوجد، فليس للنافذة مسار عام. وأقرب ما يقابلها رفع ملف، الذي يرسل ملفًا من جهازك عبر HTTP.

تسرد الملفات المرفوعة عبر نافذة رفع واحدة. والملف الذي حالته processing ما زال قيد التجهيز: اسأل مجددًا بعد لحظة. ولا تسرد بقية مكتبتك، فتلك مهمة mediaListTool.

المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.

تولد صورة من وصف وتضعها في مكتبة الوسائط، جاهزة للإرفاق. وتعيد الوسائط المخزنة، أو خطأً حين ينفد رصيد الصور لديك.

المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.

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

المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.

بعض المولدات تحتاج اختيارًا قبل أن تعمل، والصوت أشهرها. وهذه تجلب القيم المتاحة لذلك الاختيار.

المقابل في API: دوال مزودي الفيديو.

تبدأ توليد الفيديو وتعيد معرف مهمة، أو خطأً حين ينفد رصيد الفيديو أو حين لا يتاح نوع الفيديو خلال فترتك التجريبية. ويستغرق التوليد دقائق، لذا لا ينتظره مساعدك: يظهر الفيديو الجاهز في مكتبة الوسائط.

المقابل في API: توليد فيديو.

تتحقق من فيديو بدأ عبر generateVideoTool، بمعرف مهمته. ويستدعيها مساعدك حين تسأل عن الفيديو لاحقًا. وحين يكتمل، تحمل النتيجة رابط الفيديو، جاهزًا للإرفاق بمنشور.

المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.

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

المقابل في API: لا يوجد. فليس في واجهة API العامة مسار لهذا.

  • نفاد الرصيد عند توليد صورة أو فيديو يعيد خطأً بدل أن يوقف المحادثة. وكل ما عدا ذلك في الطلب يظل يعمل.
  • المنشور المرفوض يكاد يكون دائمًا إعدادًا ناقصًا أو خاطئًا لتلك المنصة. والعلاج نظرة أخرى في integrationSchema.
  • المنشور الذي يتعذر تغييره أو حذفه يعود بخطأ يشرح السبب، مثل تغيير إعدادات منشور سبق نشره.
  • عدم سرد أي قناة يعني أن الحساب لا قنوات مربوطة به، لا أن الأداة تعطلت. اربط واحدة أولًا.

والنشر والقنوات والوسائط وبدء توليد فيديو تعمل عبر HTTP أيضًا: انظر واجهة API العامة. أما توليد الصور، ونافذة الرفع، وgenerateVideoOptions، وvideoStatusTool، وask_sharek فليس لها مسار عام.