/ الدليل / الملعب / mcp-youtube-transcript
← كل الخوادم ↗ GitHub
● مجتمع jkawamoto ⚡ فوري

mcp-youtube-transcript

بواسطة jkawamoto · jkawamoto/mcp-youtube-transcript

استخرج نصوصاً منقولة (مع طوابع زمنية) وبيانات وصفية وقوائم لغات من أي فيديو YouTube — ليتمكن Claude من تلخيص أو الاستشهاد أو تطبيق طوابع زمنية لساعة من الفيديو في ثوان.

يوفر mcp-youtube-transcript 4 أدوات للحصول على نصوص منقولة خام، ونصوص منقولة بطوابع زمنية، وبيانات الفيديو الوصفية، واللغات المتاحة. يتم تقسيم النصوص المنقولة الطويلة تلقائياً عند 50 ألف حرف. يدعم Webshare / وكلاء HTTP مخصصة عندما تحد YouTube من معدل الطلبات أو تحظر عنوان IP الخاص بك.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

youtube-transcript.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "mcp-youtube-transcript"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "mcp-youtube-transcript"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "mcp-youtube-transcript"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "mcp-youtube-transcript"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "youtube-transcript",
      "command": "uvx",
      "args": [
        "mcp-youtube-transcript"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "youtube-transcript": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-youtube-transcript"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add youtube-transcript -- uvx mcp-youtube-transcript

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: mcp-youtube-transcript

تحويل محادثة YouTube مدتها 60 دقيقة إلى ملخص من 10 نقاط مع طوابع زمنية

👤 الباحثون ومسوقو المحتوى والطلاب ⏱ ~10 min beginner

متى تستخدمه: لا يمكنك مشاهدة الفيديو كاملاً لكنك تحتاج النقاط الأساسية (والاستشهاد بها مع الطوابع الزمنية).

الخطوات
  1. احصل على نص منقول بطوابع زمنية
    احصل على نص منقول بطوابع زمنية لـ https://www.youtube.com/watch?v=VIDEO_ID.✓ تم النسخ
    → نص منقول مع علامات [MM:SS]
  2. ملخص مع استشهادات
    اعطني 10 نقاط تلخص الحجة الرئيسية. يجب أن تنتهي كل نقطة بمؤشر [MM:SS] لموقعها في الفيديو.✓ تم النسخ
    → ملخص منقط مع طوابع زمنية قابلة للنقر

النتيجة: ملخص سهل الفهم يمكنك مشاركته مع فريق Slack في دقيقتين.

المزالق
  • النصوص المولدة تلقائياً قد تحتوي على أخطاء في المصطلحات التقنية — للاستشهادات التي تتطلب دقة عالية، تحقق من الفيديو الفعلي عند الطابع الزمني المحدد
اجمعها مع: notion

فهرسة الكتالوج الخلفي لبودكاست YouTube للبحث الدلالي

👤 محبو البودكاست والباحثون الذين يتابعون عرضاً معيناً ⏱ ~45 min intermediate

متى تستخدمه: تريد السؤال 'في أي حلقة تحدثوا عن X؟' عبر 100+ حلقة.

الخطوات
  1. اعرض روابط الحلقات
    إليك رابط قائمة التشغيل. احصل على أحدث 50 معرف فيديو.✓ تم النسخ
    → قائمة معرفات الفيديو
  2. احصل على البيانات وفهرسها
    لكل فيديو، احصل على get_transcript و get_video_info (العنوان والتاريخ). أدرج البيانات في local-rag كمستند واحد لكل حلقة.✓ تم النسخ
    → مجموعة مفهرسة
  3. بحث
    في أي حلقات ناقش المضيفون 'ring attention'؟ أعط رقم الحلقة والطابع الزمني.✓ تم النسخ
    → نتائج مع بيانات الحلقة الوصفية

النتيجة: مكتبة بودكاست قابلة للبحث تمتلكها وتتحكم فيها.

المزالق
  • بعض الفيديوهات لا تحتوي على نصوص — استدع get_available_languages أولاً؛ تخطَّ إذا كانت النتيجة فارغة
اجمعها مع: local-rag

ترجمة محادثة من لغة إلى أخرى

👤 المتحدثون بغير الإنجليزية ومحللو المحتوى المحليون ⏱ ~10 min beginner

متى تستخدمه: تريد قراءة محادثة إسبانية باللغة الإنجليزية دون تشغيل ترجمة ML بنفسك.

الخطوات
  1. احصل على النص المنقول باللغة الأصلية
    احصل على get_available_languages لهذا الرابط. استخدم الإسبانية إذا كانت متاحة.✓ تم النسخ
    → نص منقول باللغة الإسبانية
  2. ترجمة
    ترجم هذا النص المنقول إلى الإنجليزية، محافظاً على فواصل الفقرات.✓ تم النسخ
    → نص إنجليزي

النتيجة: نص منقول مترجم جدير بالقراءة.

المزالق
  • محتوى النبرة واللغة العامية يترجم بشكل محرج — للتوطين التجاري، اطلب من مترجم بشري مراجعته

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

youtube-transcript + local-rag

أدرج نصوص قناة في فهرس محلي قابل للبحث

لكل فيديو في قائمة التشغيل هذه، احصل على نص + بيانات وصفية، ثم أدرج البيانات في local-rag مع عنوان المصدر.✓ تم النسخ
youtube-transcript + notion

انشر ملخصات الفيديو في قاعدة بيانات Notion المعرفية

ملخص هذه المحادثة وإنشاء صفحة Notion في 'Talks' مع العنوان والقناة والتاريخ والملخص.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
get_transcript url_or_id: str, language?: str تريد النص فقط، بدون طوابع زمنية free
get_timed_transcript url_or_id, language? تحتاج طوابع زمنية للاستشهادات أو توليد الفصول free
get_video_info url_or_id بيانات وصفية للسياق / الفهرسة free
get_available_languages url_or_id تحقق من توفر النصوص قبل محاولة الحصول عليها free

التكلفة والحدود

تكلفة التشغيل

حصة API
YouTube لا تكشف رسمياً عن النصوص المنقولة — توقع حدود معدل IP
الرموز لكل استدعاء
النصوص المنقولة تتراوح بين 1k-50k رمز حسب الطول؛ مقسمة عند 50k افتراضياً
التكلفة المالية
مجاني؛ الوكلاء (Webshare) يكلفون بضعة $/شهر إذا احتجت إليها
نصيحة
النصوص المنقولة كبيرة غالباً. قلل حجمها عبر --response-limit أو اطلب نطاق زمني محدد.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: بيانات اعتماد الوكيل إذا استخدمت Webshare — متغير env
نقل البيانات الخارجي: خارج إلى youtube.com (ربما عبر وكيل)

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

HTTP 429 Too Many Requests

عنوان IP الخاص بك مقيد بمعدل من قبل YouTube. قم بتكوين وكيل Webshare عبر متغيرات env أو انتظر 30-60 دقيقة.

تحقق: جرب نفس الرابط من عنوان IP آخر
No transcript available

الفيديو لا يحتوي على نصوص. استدع get_available_languages أولاً؛ إذا كانت النتيجة فارغة، تخطَّ.

Age-restricted / region-locked video

غير مدعوم بواسطة هذا MCP. لا توجد حل بديل — استخدم YouTube Data API الرسمي مع المصادقة.

Python install issues (uvx)

قم بتثبيت uv أولاً: curl -LsSf https://astral.sh/uv/install.sh | sh. يتطلب Python 3.10+.

تحقق: uv --version

البدائل

mcp-youtube-transcript مقابل البدائل

البديلمتى تستخدمهاالمقايضة
YouTube Data API + official MCP wrapperتحتاج إلى وصول رسمي مصرحيتطلب مفتاح Google API؛ حدود حصة؛ لا يوفر نص النص المنقول مباشرة
yt-dlp MCPتريد أيضاً تحميل الفيديو/الصوت، وليس فقط النصوص المنقولةأثقل؛ يحمل ملفات الوسائط

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills