كيف تبني مولّد ملاحظات محاضرات وبطاقات تعليمية من YouTube

المشكلة التي تحلها

يعيد الطلاب مشاهدة محاضرات كاملة لمراجعة مفهوم واحد، وكثير منهم لا يدوّن ملاحظات أصلًا. يريد الأساتذة توفير مواد للمراجعة لكن لا وقت لديهم لكتابتها لكل جلسة. والمولّد الذي يعمل عبر قائمة تشغيل كاملة يمنح كل متعلم مواد متسقة وقابلة للبحث.

ما يجب تضمينه في نسختك الأولى

• ■استيراد قائمة تشغيل دورة كاملة بنقرة واحدة
• ■ملاحظات منظمة لكل محاضرة بعناوين ومصطلحات رئيسية
• ■بطاقات تعليمية قابلة للتصدير إلى Anki أو تطبيقات التكرار المتباعد الأخرى
• ■بحث عبر كل محاضرات الدورة
• ■روابط من كل ملاحظة إلى الطابع الزمني في الفيديو

كيف تبنيها خطوة بخطوة

1. 01

   استورد قائمة التشغيل

   استدعِ /playlists/resolve برابط قائمة تشغيل الدورة للحصول على كل المحاضرات بالترتيب.

2. 02

   اجلب النصوص بالجملة

   أرسل المعرّفات إلى /batch مع format.paragraphs وformat.timestamp.

3. 03

   أنشئ الملاحظات والبطاقات

   لكل محاضرة، اطلب من LLM ملاحظات منظمة وبطاقات تعليمية بصيغة سؤال وجواب، كل منها مرتبط بطابع زمني.

4. 04

   ابنِ تجربة المراجعة

   اعرض الملاحظات بجانب الفيديو المضمّن، وأضف البحث عبر المحاضرات، وصدّر البطاقات بصيغة متوافقة مع Anki.

كود جاهز للبدء

تعتمد هذه الفكرة على نمط «الوصفة 3: حمّل قائمة تشغيل كاملة في قاعدة معرفة». استبدل القنوات والتعليمات (prompts) ووسيلة التخزين بما يناسبك.

import requests

API = "https://www.youtubetranscript.dev/api/v2"
HEADERS = {"Authorization": "Bearer yt_sk_live_YOUR_KEY"}

playlist = requests.post(f"{API}/playlists/resolve", headers=HEADERS,
                         json={"playlist_url": "https://www.youtube.com/playlist?list=PLAYLIST_ID",
                               "limit": 100}).json()

ids = [v["video_id"] for v in playlist["items"]]
batch = requests.post(f"{API}/batch", headers=HEADERS, json={
    "video_ids": ids,
    "format": {"timestamp": True, "paragraphs": True},
}).json()

# Large batches run async: poll GET /batch/{batch_id} until status is "completed"
for r in batch.get("results", []):
    if r["status"] == "completed":
        for p in r["data"]["transcript"].get("paragraphs") or []:
            store(video_id=r["video_id"], start=p["start"], text=p["text"])  # your vector DB

لماذا تستحق البناء

بِعه للطلاب باشتراك شهري، أو للأساتذة ومنصات الدورات كميزة ترفع معدلات إتمام الدورات. وقد ترخّصه الجامعات لأغراض الإتاحة ودعم التعلم.

أخطاء يجب تجنبها

• ✕التلخيص المفرط: يحتاج الطلاب إلى التعريفات والأمثلة والخطوات، لا إلى ملخص فقط.
• ✕فقدان ترتيب الدورة: حافظ على ترتيب قائمة التشغيل لتتبع الملاحظات بنية الدورة.
• ✕بطاقات تعليمية بلا سياق: اربط كل بطاقة باللحظة في المحاضرة التي يُشرح فيها المفهوم.

أسئلة حول هذه الفكرة