eWوثائق eWasl

أداة سطر الأوامر (@ewasl/cli)

انشر وجدول وأدر المنشورات والإعلانات من الطرفية أو خطوط CI باستخدام أداة eWasl لسطر الأوامر.

تشغّل @ewasl/cli واجهة eWasl البرمجية (V1) من طرفيتك أو CI. وهي النظير البرمجي لـالواجهة البرمجية وخادم MCP.

npx @ewasl/cli login --api-key ewasl_xxxxxxxx
npx @ewasl/cli posts list --status SCHEDULED

المصادقة

تستخدم الأداة مفتاح API (ewasl_*) يُنشأ من الإعدادات ← مفاتيح API. المفاتيح مقيّدة بنطاقات — لا تفعل الأداة إلا ما يسمح به نطاق المفتاح. تُحَل بيانات الاعتماد بالترتيب التالي (الأعلى أولوية أولاً):

  1. الخيارات --api-key / --base-url
  2. متغيّرا البيئة EWASL_API_KEY / EWASL_BASE_URL (استخدمهما في CI)
  3. المفتاح المخزَّن بأمر ewasl login في ~/.ewasl/config.json (يُكتب بصلاحية 0600)
# محلياً: خزّن مفتاحاً لإعادة الاستخدام (يُتحقّق منه قبل الحفظ)
ewasl login --api-key ewasl_xxxxxxxx
ewasl whoami
ewasl logout
 
# في CI: دون حالة مخزَّنة
export EWASL_API_KEY=ewasl_xxxxxxxx
ewasl posts list --json

تسجيل الدخول عبر OAuth (تدفّق المتصفح/الجهاز) مُدرَج في خارطة الطريق. اليوم تستخدم الأداة مفاتيح API، وهو المسار المُوصى به للاستخدام بين الخوادم وفي CI.

الأوامر

الأمرالنطاقالوصف
login / logout / whoami—إدارة بيانات الاعتماد المخزَّنة
posts listposts:readعرض المنشورات (--status، --platform، --limit)
posts get <id>posts:readجلب منشور واحد
posts create --content <t> --accounts <ids>posts:createإنشاء الآن، أو جدولة بـ --schedule <iso>
posts delete <id>posts:createحذف مسودّة / منشور مجدول
connectionsposts:readعرض الحسابات الاجتماعية المتصلة
analytics summaryposts:readملخّص مؤشّرات اللوحة
analytics optimal-times --platform <p>posts:readأفضل أوقات النشر المقترحة بالذكاء الاصطناعي
ads campaignsads:readعرض الحملات الإعلانية
ads insightsads:readملخّص مؤشّرات الإعلانات (--days، --account)
ads pause <id>ads:writeإيقاف حملة (تجربة مبدئية ما لم تستخدم --commit)
ads resume <id>ads:writeاستئناف حملة (تجربة مبدئية ما لم تستخدم --commit)

الخيارات العامة

  • --json — مخرجات JSON خام (الأفضل للأتمتة؛ العرض الافتراضي نصّي مختصر)
  • --api-key <key> — تجاوز المفتاح لأمر واحد
  • --base-url <url> — التوجيه إلى نشر تجريبي / مُستضاف ذاتياً

تُجرى إجراءات الكتابة على الإعلانات كـتجربة مبدئية افتراضياً؛ استخدم --commit للتطبيق.

الأتمتة

--json مع رموز خروج ثابتة تجعل الأداة ملائمة للسكربتات — 0 نجاح، 1 خطأ، 2 غير موثّق:

# معاينة إيقاف كل الحملات النشطة
ewasl ads campaigns --status ACTIVE --json | jq -r '.data[].id' | while read id; do
  ewasl ads pause "$id" --json
done

في هذه الصفحة