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

مرجع الأوامر

ستة عشر أمرًا، في خمس مجموعات. نفذ sharek --help للقائمة نفسها، أو sharek <command> --help لخيارات أمر واحد.

وكل أمر عدا أوامر auth:* الثلاثة يحتاج بيانات اعتماد أولًا. انظر تسجيل الدخول.

ينشئ منشورًا. وهو الأمر الأكثر خيارات على الإطلاق.

الخيار الاختصار مطلوب الافتراضي ما الذي يفعله
--content -c نعم، ما لم تستخدم --json محتوى المنشور. كرره: الأول هو المنشور، وكل واحد بعده تعليق أو الجزء التالي من سلسلة النقاش.
--integrations -i نعم، ما لم تستخدم --json معرفات القنوات مفصولة بفواصل.
--date -s نعم، ما لم تستخدم --json تاريخ الجدولة، بصيغة ISO 8601.
--media -m لا عناوين الوسائط مفصولة بفواصل، لـ -c المقابل. كرره بجانب -c.
--type -t لا schedule schedule أو draft.
--delay -d لا 0 الدقائق بين التعليقات.
--json -j لا مسار ملف JSON يحمل المنشور كاملًا بدل الخيارات.
--shortLink لا true اختصار الروابط في المحتوى.
--settings لا إعدادات المنصة كنص JSON.

منشور مجدول بسيط:

Terminal window
sharek posts:create -c "Our new pricing is live" \
-s "2027-09-01T09:00:00Z" -i "channel-id"

سلسلة نقاش. ولاحظ أن --date مطلوب هنا كما في كل مكان، وأن -d يباعد بين الأجزاء:

Terminal window
sharek posts:create -c "Thread 1/3" -c "Thread 2/3" -c "Thread 3/3" \
-d 5 -s "2027-09-01T09:00:00Z" -i "channel-id"

إعدادات المنصة تدخل كـ JSON. وصفحة الإعدادات لكل قناة، المدرجة تحت القنوات التي يوفرها شارك، توضح ما تقبله. والمثال أدناه لـ X:

Terminal window
sharek posts:create -c "Tweet content" -s "2027-09-01T09:00:00Z" \
--settings '{"who_can_reply_post":"everyone"}' -i "channel-id"

ولأي شيء متشعب، ضع المنشور كاملًا في ملف وتجاوز الخيارات. فمع --json يأتي المحتوى والقنوات والتاريخ من الملف:

Terminal window
sharek posts:create --json ./post.json

المقابل في API: إنشاء منشور.

يسرد المنشورات. وبلا تواريخ يغطي 30 يومًا للوراء و30 يومًا للأمام.

الخيار الافتراضي ما الذي يفعله
--startDate قبل 30 يومًا بصيغة ISO 8601.
--endDate بعد 30 يومًا بصيغة ISO 8601.
--customer حصر النتائج في علامة تجارية واحدة، بمعرفها.
Terminal window
sharek posts:list --startDate "2026-01-01T00:00:00Z" --endDate "2026-12-31T23:59:59Z"

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

يحذف منشورًا.

Terminal window
sharek posts:delete post-id

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

ينقل منشورًا بين المسودة وقائمة الانتظار. و--status (-s) مطلوب ويأخذ draft أو schedule.

Terminal window
sharek posts:status post-id --status schedule

وإعادة منشور من قائمة الانتظار إلى المسودة توقف نشره.

المقابل في API: تغيير حالة المنشور.

لمنشور تم نشره ولم يسجل شارك معرف إصداره، يسرد هذا ما لدى المنصة، لتتعرف على المنشور الصحيح.

Terminal window
sharek posts:missing post-id

وهذا هو الأمر الوحيد الذي يطبع JSON خامًا بلا سطر حالة فوقه.

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

يسجل معرف الإصدار الذي تعرفت عليه. و--release-id مطلوب.

Terminal window
sharek posts:connect post-id --release-id "platform-content-id"

وتحليلات ذلك المنشور تبدأ بالعمل بمجرد ربطه.

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

يسرد القنوات المربوطة بمعرفاتها. و--group يأخذ معرف علامة تجارية ويحصر القائمة في قنوات تلك العلامة.

Terminal window
sharek integrations:list --group "group-id"

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

يسرد علاماتك التجارية، بالمعرفات التي يأخذها --group و--customer. بلا خيارات. وأسماء الخيارات تتبع API، التي تسمي العلامة التجارية group أو customer.

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

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

Terminal window
sharek integrations:settings channel-id

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

ينفذ إحدى الأدوات المساعدة التي سردها integrations:settings، وهي طريقتك للبحث عن المعرفات التي تحتاجها الإعدادات. و--data (-d) يمرر المعاملات كنص JSON.

Terminal window
sharek integrations:trigger channel-id subreddits -d '{"word":"programming"}'

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

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

تحليلات القناة. و--date (-d) هو عدد الأيام للرجوع، والقيمة الافتراضية 7.

Terminal window
sharek analytics:platform channel-id -d 30

المقابل في API: تحليلات القناة.

تحليلات منشور واحد، بالخيار --date نفسه والقيمة الافتراضية نفسها.

Terminal window
sharek analytics:post post-id -d 30

فإن أعاد هذا {"missing": true}، فالمنشور بلا معرف إصدار بعد. عالج ذلك بـ posts:missing وposts:connect.

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

يرفع ملفًا ويعيد id وpath الخاصين به.

Terminal window
sharek upload ./image.png

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

يسجل الدخول عبر المتصفح. ولاستخدام خادم مصادقة مختلف، وهو ما لا تحتاجه عادة، مرر --auth-server أو اضبط SHAREK_AUTH_SERVER. وإن ضبطت الاثنين فالأولوية للخيار.

يبلغ عن الطريقة المستخدمة ويتحقق من أن بيانات الاعتماد ما زالت تعمل.

أقرب مقابل في API: التحقق من بيانات اعتمادك، الذي يؤكد أن المفتاح يعمل. أما auth:status نفسه فيتحقق بسرد قنواتك.

يحذف بيانات الاعتماد المحفوظة.

والثلاثة مغطاة في تسجيل الدخول.