وثائق المطورين تُنشر بالإنجليزية. الشريط الجانبي يتبع اللغة المختارة.
تكامل MCP
اربط Claude وChatGPT وCursor وOpenAI Agent Builder بـ SubDownload عبر Model Context Protocol.
نظرة عامة
Model Context Protocol (MCP) هو إطار عمل مقنّن يسمح لمساعدي الذكاء الاصطناعي باستدعاء أدوات خارجية مباشرةً. يكشف خادم MCP الخاص بـ SubDownload عن 12 أداة — تشمل التفريغ الصوتي غير المتزامن بالذكاء الاصطناعي ومكتبة Library لكل مستخدم — ويدعم OAuth 2.1 مع Dynamic Client Registration (DCR) بالإضافة إلى مفاتيح API ثابتة.
إعداد الخادم
| الخاصية | القيمة |
|---|---|
| عنوان الخادم | https://api.subdownload.com/mcp |
| بيانات المصادقة | /.well-known/oauth-authorization-server |
| التسجيل الديناميكي | POST /oauth/register |
| التفويض | GET /oauth/authorize |
| الرمز | POST /oauth/token |
| النطاق | mcp:access |
| بادئة الرمز | oat_ (OAuth) أو sk_live_ (مفتاح API) |
إعداد العميل
انظر الأدلة خطوة بخطوة:
- → Claude (Desktop / Code) — OAuth مع DCR، دون الحاجة إلى اعتمادات مُنشأة مسبقًا
- → ChatGPT — عميل OAuth ثابت (Client ID / Secret)
- → OpenAI Agent Builder — المصادقة عبر مفتاح API
أدوات MCP
| الأداة | التكلفة | الغرض |
|---|---|---|
fetch_transcript | رصيد واحد | جلب النص عبر URL/ID (المعامِلات: video_url، lang). |
search_youtube | رصيد واحد | البحث عن فيديوهات أو قنوات (المعامِلات: query، type، limit). |
resolve_channel | مجاني | حلّ @handle / URL / UC… ID إلى معلومات القناة (المعامِل: input). |
search_channel_videos | رصيد واحد | البحث داخل قناة معيّنة (المعامِلات: channel، query، limit). |
get_channel_latest_videos | مجاني | أحدث ~15 فيديو عبر RSS (المعامِل: channel). |
list_channel_videos | رصيد/صفحة | تقسيم قائمة التحميلات (المعامِلات: channel أو continuation). |
list_playlist_videos | رصيد/صفحة | تقسيم قائمة التشغيل (المعامِلات: playlist أو continuation). |
transcribe_video | 5 نقاط عند done | يبدأ تفريغًا صوتيًا غير متزامن بـ Whisper للفيديوهات بلا ترجمات. يُرجع task_id + next_poll_after_seconds (المعامِلات: video_url، lang). |
get_asr_task | مجاني | استطلاع مهمة ASR؛ يُرجع segments عند status=done (المعامِل: task_id). |
list_library | مجاني | قائمة النصوص والملخصات المحفوظة للمستخدم (المعامِلات: favorite، q، limit، offset). |
get_library_item | مجاني | قراءة عنصر محفوظ مع النص والملخص مضمّنين (المعامِلات: id، locale). |
save_to_library | وحدة حصة توكن واحدة | kind=asr يضع علامة نص محفوظ؛ kind=summary يرفع ملخص الذكاء الاصطناعي (المعامِلات: video_id، kind، text، locale، model…). |
معالجة الأخطاء
الاستدعاءات الفاشلة لا تستهلك رصيدًا أبدًا. ترجع الأخطاء برسائل مفهومة يفسّرها الذكاء الاصطناعي طبيعيًا. القائمة الكاملة في رموز الأخطاء.