أتمتة شارك بـ n8n
يربط n8n شارك بكل ما تشغله سواه. فصف جديد في جدول بيانات يصير منشورًا مجدولًا؛ وعنصر RSS يصير مسودة يراجعها فريقك. بلا كود، وبلا سكربت استطلاع تبقيه يعمل.
وينشر شارك عقدة n8n خاصة به، فيصير هذا على n8n المستضاف ذاتيًا بضع نقرات بدل مجموعة عقد HTTP Request تصونها بنفسك.
وكلا الطريقين يستخدم مفتاح API الخاص بك في شارك. ليست ضمن كل الخطط. لا يظهر تبويب المطورون، حيث المفتاح، إلا حين تتضمن خطتك واجهة API العامة. راجع الأسعار.
ثبت العقدة
Section titled “ثبت العقدة”-
في n8n، افتح Settings، ثم Community nodes، واختر Install. وإن لم تكن أي عقدة مجتمع مثبتة بعد، فالزر يحمل اسم Install a community node.
-
أدخل اسم الحزمة:
n8n-nodes-sharek -
حدد I understand the risks of installing unverified code from a public source، ثم اختر Install. عندها تظهر عقدة اسمها Sharek في لوحة العقد.
على n8n Cloud
Section titled “على n8n Cloud”لا يستطيع n8n Cloud تثبيت عقدة شارك بعد، لكن عقدة HTTP Request المدمجة فيه تستطيع استدعاء واجهة API العامة مباشرة، بمفتاح API نفسه.
-
أضف عقدة HTTP Request. وتحت Authentication، اختر Generic Credential Type، ثم Header Auth في Generic Auth Type، وأنشئ بيانات اعتماد جديدة.
-
في بيانات الاعتماد، اضبط Name على
AuthorizationوValue على مفتاح API الخاص بك في شارك، من بطاقة مفتاح API التي تشرحها المصادقة. الصق المفتاح وحده، دونBearerأمامه. -
اضبط Method على
GETوURL على العنوان أدناه، ثم نفذ العقدة. فالعقدة ترسل هذا الطلب، والرد{"connected": true}يعني أن المفتاح يعمل:GET https://dash.sharek.app/api/public/v1/is-connectedAuthorization: your-api-key -
وجه العقدة إلى العملية التي تحتاجها، على عنوانها تحت
/public/v1. ولعملية لها جسم طلب، مثل إنشاء منشور، اجعل Send Body مفعلًا، واضبط Specify Body على Using JSON، والصق جسم الطلب من تلك الصفحة.
اربطها بحسابك
Section titled “اربطها بحسابك”-
أضف عقدة Sharek إلى سير عمل وأنشئ بيانات اعتماد Sharek API جديدة.
في حقل API Key، الصق مفتاح API الخاص بك في شارك. خذه من الإعدادات، ثم المطورون، ثم بطاقة مفتاح API في شارك، كما تشرح المصادقة. الصق المفتاح وحده، دون
Bearerأمامه.-
اترك Host كما هو. فهو يشير إلى المكان الصحيح بالفعل:
https://dash.sharek.app/api احفظ. يختبر n8n بيانات الاعتماد وهو يحفظها، باستدعاء
GET https://dash.sharek.app/api/public/v1/is-connected. والاختبار الأخضر يعني أن المفتاح يعمل.
ما الذي تستطيعه العقدة
Section titled “ما الذي تستطيعه العقدة”سبع عمليات:
| العملية | ما الذي تفعله |
|---|---|
| Get Channels | تسرد قنواتك المربوطة بمعرفاتها |
| Create Post | تنشئ مسودة منشور أو تجدوله أو تنشره، إلى قناة أو أكثر |
| Get Posts | تسرد المنشورات في مدى تواريخ، ولعلامة تجارية واحدة اختياريًا (حقل Customer يأخذ معرفها) |
| Delete Post | تحذف منشورًا بمعرفه |
| Upload File | تضع وسائط في مكتبتك وتعيد مرجعها |
| Generate Video | تولد فيديو |
| Video Function | تجلب القيم التي يحتاجها مولد الفيديو أولًا |
وكل واحدة منها تستدعي عملية واحدة في واجهة API العامة: Get Channels هي سرد القنوات، وCreate Post هي إنشاء منشور، وGet Posts هي سرد المنشورات، وDelete Post هي حذف منشور، وUpload File هي رفع ملف، وGenerate Video هي توليد فيديو، وVideo Function هي دوال مزودي الفيديو. وتلك الصفحات هي التفصيل خلف كل واحدة.
وتعمل العقدة أيضًا أداة لعقدة AI Agent في n8n. اربطها ضمن أدوات الوكيل، فيشغل الوكيل هذه العمليات بنفسه، كأن يجدول منشورًا كتبه للتو.
أول سير عمل لك
Section titled “أول سير عمل لك”أقصر سير عمل مفيد هو عقدتان.
-
أضف عقدة Sharek واضبط العملية على Get Channels. نفذها. تستعيد قنواتك بمعرفاتها، وهو ما يؤكد أن بيانات الاعتماد تعمل ويعطيك المعرف للخطوة التالية.
-
أضف عقدة Sharek ثانية مضبوطة على Create Post. اضبط Type على Schedule، وضع تاريخًا مستقبليًا بصيغة ISO 8601 في Date، ثم أضف مدخلًا واحدًا تحت Posts: معرف القناة من الخطوة 1، ومحتواك.
-
نفذ سير العمل، ثم افتح التقويم في شارك. ستجد المنشور هناك.
وبقية حقول Create Post:
- Short Link معطل افتراضيًا. اجعله مفعلًا لتستبدل بالروابط في محتواك روابط شارك المختصرة، كي يحسب شارك النقرات.
- Tags موضعه في Create Post نفسها، فالوسوم نفسها تغطي الطلب كله. أما Group فموضعه داخل كل مدخل تحت Posts، فاتركه فارغًا للمنشور الجديد. فالقيمة فيه تسمي مجموعة منشور موجود، فيستبدل ذلك المنشور ويحذف القديم، كما عبر API. ويعطي شارك كل منشور جديد مجموعة خاصة به.
- كل مدخل تحت Settings في المنشور له Key وValue Type وقيمة. وValue Type هو String ما لم تغيره إلى Number أو Boolean أو JSON؛ فاختر ما يتوقعه الإعداد، وJSON للكائن أو القائمة.
وبمجرد نجاح ذلك، ضع مكان المشغل اليدوي ما ينبغي أن يبدأ سير العمل فعلًا: جدول زمني، أو Webhook، أو صف جديد، أو عنصر RSS جديد.
إرفاق الوسائط
Section titled “إرفاق الوسائط”الوسائط لا بد أن تكون في شارك قبل أن يستخدمها منشور، فضع خطوة Upload File قبل المنشور.
وUpload File تقرأ بيانات ثنائية من العنصر الوارد لا من مسار، وحقل Binary Property
يسمي أيها تقرأ، وهو data عادةً. ومن ثم فالخطوة التي قبلها لا بد أن تنتج بيانات ثنائية:
عقدة HTTP Request تنزل الصورة، أو عقدة Read/Write Files from Disk، أو ما يوفره مشغلك أصلًا.
خذ id وpath اللذين يعيدهما الرفع إلى مدخل Images في المنشور، في حقلي ID وPath.
ويجب أن ينتهي المسار بـ .png أو .jpg أو .jpeg أو .gif أو .webp أو .mp4، وإلا رفض
Create Post، كما عبر API. أما مسار على جهازك فلا يعمل أبدًا، لأن شارك
لا ينشر إلا وسائط يستطيع جلبها.
حين لا يعمل
Section titled “حين لا يعمل”- فشل اختبار بيانات الاعتماد. افحص المفتاح أولًا. وإن غيرت Host، فينبغي أن ينتهي
عند
/apiبلا/public/v1وبلا شرطة مائلة في آخره. - 401 على كل عملية. يذكر
msgفي الرد السبب: مفتاح خاطئ أو جرى تدويره، أو مفتاح لصق معBearer، أو مؤسسة بلا اشتراك فعال. وتسرد المصادقة كلًا منها. راجع المفتاح مقابل بطاقة مفتاح API. - خطأ في Upload File بشأن البيانات الثنائية. العنصر الوارد بلا بيانات ثنائية، أو اسم Binary Property لا يطابق ما أنتجته العقدة السابقة.
- رفض Create Post. إعداد منصة ناقص لتلك القناة. وصفحة إعدادات كل قناة مرتبطة من القنوات التي يوفرها شارك.
- تنشر المنشورات في وقت خاطئ، أو فورًا. يقرأ Date بتوقيت UTC إن لم يحمل فرق توقيت، والتاريخ الماضي ينشر في الحال. وإن لم ينشر المنشور أبدًا، فتأكد أن Type ليس Draft.
إلى أين بعد ذلك
Section titled “إلى أين بعد ذلك”- ثلاثة أمثلة لسير العمل على موقع شارك، مبنية من هذه العقدة ومن عقد n8n القياسية.
- Webhooks في شارك لتبدأ سير عمل لحظة نشر منشور.
- واجهة API العامة لما يقع تحت العقدة.
- الربط عبر MCP إن أردت مساعدًا يفعل هذا حواريًا بدلًا من ذلك.