أتمت سير عمل مقاطعك: واجهة ClipMaster API وخادم MCP

إذا كنت تقطّع الفيديوهات كل أسبوع، فستصبح واجهة التطبيق في النهاية هي الجزء البطيء. أنت تعرف مسبقًا أي بودكاست سيُقطَّع، وإلى أي قناة تذهب المقاطع، ومتى تُنشر تقريبًا — كل ما تفعله هو النقر عبر الشاشات نفسها لتحقيق ذلك. يتيح ClipMaster الآن سير العمل هذا كله برمجيًا: API من نوع REST للسكربتات والأدوات، وخادم MCP يتيح لـClaude إدارته من محادثة. يوضّح هذا المقال كيف يعمل كلٌّ منهما ومتى تستخدم أيهما.

API واحدة، ومدخلان

يستخدم المساران الـ API نفسها والحساب نفسه: كل طلب يقتصر على مشاريعك أنت، ويُحتسب بالتوكنات نفسها التي يستخدمها التطبيق، دون فوترة منفصلة. المصادقة تتم بمفتاح API (cm_live_…) تُنشئه في التطبيق من الإعدادات ← الوصول إلى API، وهو متاح في الخطط المدفوعة. يوضع المفتاح في ترويسة Authorization، ويمكن إلغاؤه في أي وقت، ولا يمنح أبدًا صلاحية الوصول إلى إدارة الحساب أو الفوترة أو وظائف المشرف — فهذه تبقى في تطبيق الويب.

• الـ REST API مخصّصة للسكربتات ومهام cron وأدواتك الخاصة — أي شيء تريد فيه تحكّمًا حتميًا لا مفاجآت فيه.
• خادم MCP للعمل بالمحادثة: تخبر Claude بالنتيجة التي تريدها، فيستدعي الـ API نفسها نيابةً عنك.

سير العمل كله مغطّى

كل ما بين «هذا فيديو» و«المقطع مجدول للنشر» يمكن أتمتته بسكربت: استيراد فيديو عبر رابط أو رفع ملف، ومتابعة المعالجة، وعرض المقاطع المولَّدة مع بياناتها الوصفية من الذكاء الاصطناعي (جمل الخطّاف، وأنواع المقاطع، والنصوص المفرّغة)، وضبط الحدود والترجمة، وحفظ إعدادات المحرر، وتصيير ملفات التصدير، وبناء التجميعات، وجدولة الملفات المصدَّرة الجاهزة على قناة YouTube مربوطة.

دورة كاملة في أربع خطوات

استورد فيديو وأوصله حتى مقطع جاهز للتنزيل:

# 1. Import a YouTube video
curl -X POST "https://api.clipmaster.app/api/v1/upload/from-url" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_url": "https://youtube.com/watch?v=..."}'
# -> {"project_id": 123, ...}

# 2. Poll until processing completes
curl "https://api.clipmaster.app/api/v1/projects/123/status" \
  -H "Authorization: Bearer $KEY"
# -> {"status": "completed", "total_clips": 6, ...}

# 3. List the generated clips
curl "https://api.clipmaster.app/api/v1/projects/123/clips" \
  -H "Authorization: Bearer $KEY"

# 4. Export it (captions, effects, trim), then download the export
curl -X POST "https://api.clipmaster.app/api/v1/projects/123/clips/456/export" \
  -H "Authorization: Bearer $KEY"
# -> {"export_id": 37, ...}; poll /exports/37/status until "completed"
curl "https://api.clipmaster.app/api/v1/exports?clip_id=456" \
  -H "Authorization: Bearer $KEY"
# -> newest completed export's "download_url" (presigned S3, expires next 00:00 UTC)
curl -L "$DOWNLOAD_URL" -o clip.mp4

ومن هنا يمتد النمط نفسه إلى الجدولة (POST /scheduled-posts). المرجع الكامل لنقاط النهاية، مع أمثلة على الطلبات والاستجابات، موجود على clipmaster.app/docs/api، ومعه نسخة مطابقة بصيغة Markdown عادية على /docs/api.md إن كنت ستمرّره إلى نموذج لغوي (LLM).

أو اترك Claude يتولّاها

يغلّف خادم MCP الـ API على شكل أدوات لـClaude Desktop وClaude Code وأي عميل MCP. الإعداد مجرد كتلة إعدادات واحدة فيها مفتاح API الخاص بك:

{
  "mcpServers": {
    "clipmaster": {
      "command": "uvx",
      "args": ["clipmaster-mcp"],
      "env": { "CLIPMASTER_API_KEY": "cm_live_..." }
    }
  }
}

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

• «استورد هذه الحلقة وأخبرني حين تنتهي.»
• «أيّ مقطع فيه أقوى خطّاف؟ اعرض لي نصه المفرّغ.»
• «صدّر أفضل مقطعين وجدولهما على قناتي يوم الجمعة الساعة 5 مساءً.»
• «ما الذي ينتظر النشر هذا الأسبوع؟»

الفرق عن السكربت هو حُسن التقدير: يقرأ Claude البيانات الوصفية للمقاطع — الخطّافات والأنواع والنصوص المفرّغة — ويختار ما كنت ستختاره بعينك. ويستأذنك عميل MCP قبل أي استدعاء أداة له عواقب، وكل ما يُجدول يظهر في تقويم التطبيق، حيث يمكن تغيير موعده أو إلغاؤه مثل أي منشور آخر. دليل الإعداد: clipmaster.app/docs/mcp.

التفاصيل العملية

• التكلفة مطابقة للتطبيق. 1 توكن = 1 دقيقة من الفيديو الأصلي في المعالجة؛ والتصدير يُحتسب حسب قواعد التطبيق. استدعاء الـ API لا يكلّف شيئًا إضافيًا أبدًا.
• المفاتيح قابلة للإلغاء ولها حدّ للطلبات. 120 طلبًا في الدقيقة لكل مفتاح؛ وإلغاء المفتاح من الإعدادات يوقفه فورًا.
• إعادة المحاولة آمنة حيث يهمّ الأمر. جدولة الملف المصدَّر نفسه في الموعد نفسه مرتين تُعيد المنشور الموجود بدل النشر مرتين.
• ربط القناة يتم مرة واحدة، داخل التطبيق. تستطيع الـ API وMCP الجدولة على قناة مربوطة، لكنهما لا تنفّذان ربط OAuth بنفسيهما أبدًا.

إذا كان روتين التقطيع لديك متوقَّعًا أصلًا، فتوقّف عن تنفيذه بالنقرات. أتمت الجزء المتوقَّع بسكربت، أو سلّمه لـClaude — واصرف وقتك على التسجيلات نفسها.