14.6k نجمة: تحكم في Google NotebookLM عبر Python واربط Claude Code
- notebooklm ai
- notebooklm tutorial
- notebooklm
- notebooklm رسمي
واجهة Google NotebookLM على الويب مناسبة للاستخدام العرضي، لكن عندما تحتاج خطوط بحث أو سكربتات أو تدفقات عمل مع وكلاء ذكاء اصطناعي، تصطدم بجدار: معظم الإجراءات تتطلب النقر في الواجهة، والعمل الجماعي يصبح مرهقاً.
notebooklm-py على GitHub ( 14.6k+ نجمة حتى مايو 2026) يملأ هذه الفجوة — طبقة Python فوق NotebookLM مع ربط Claude Code ووكلاء مشابهين.
أين تتوقف واجهة NotebookLM على الويب
يتيح NotebookLM رفع PDF وروابط URL وYouTube، ثم الدردشة وتوليد بودكasts وشرائح واختبارات وغيرها. ابحث عن notebooklm tutorial وستجد أدلة البداية — لكن الواجهة الرسمية لها حدود واضحة:
- الاستيراد والتنزيل الجماعي يعني نقرة واحدة في كل مرة
- الاختبارات والبطاقات تفاعلية فقط — بلا تصدير JSON أو Markdown
- الخرائط الذهنية وجداول البيانات لا تعرض بيانات منظمة في المتصفح
- لا يوجد ربط أصلي مع Claude Code أو Codex أو وكلاء برمجة آخرين
للتدوين العرضي، الويب يكفي. للخطوط ومهام CI أو «اقرأ 20 ورقة وولّد اختبارات»، تحتاج API برمجياً.
ما هو notebooklm-py؟
notebooklm-py حزمة SDK وCLI غير رسمية بلغة Python، يديرها المجتمع (ترخيص MIT). عبر هندسة عكسية لـ RPC الداخلي لـ Google يكشف تقريباً كل قدرات NotebookLM، إضافة إلى ميزات لم تصل للويب.
تنبيه: غير تابع لـ Google. يستخدم APIs غير موثقة قد تتعطل. الأفضل للمشاريع الشخصية والبحث والنماذج الأولية.
ثلاث طرق للاستخدام
| الطريقة | الأنسب لـ |
|---|---|
| Python API | تكامل التطبيقات، خطوط async، سكربتات مخصصة |
| CLI | سكربتات shell، مهام سريعة، CI/CD |
| تكامل الوكلاء | Claude Code وCodex وOpenClaw، أتمتة بلغة طبيعية |
ما لا يقدمه الويب
| القدرة | ما تحصل عليه |
|---|---|
| تنزيل جماعي | كل مخرجات النوع دفعة واحدة (MP3 وMP4 وPDF وPNG إلخ) |
| تصدير quiz / بطاقات | JSON وMarkdown وHTML — وليس العرض التفاعلي فقط |
| JSON خريطة ذهنية | بيانات هرمية لـ D3 وECharts أو أدوات أخرى |
| CSV جداول البيانات | تصدير جاهز لجداول البيانات |
| PPTX للشرائح | PowerPoint قابل للتحرير، وليس PDF فقط |
| مراجعة شريحة واحدة | تعديل شريحة عبر prompt بلغة طبيعية |
| حفظ الدردشة كملاحظات | حفظ الأسئلة والأجوبة أو المحادثات كاملة في الدفتر |
| النص الكامل للمصادر | وصول برمجي للنص المفهرس |
| ملفات حسابات متعددة | التبديل بين حسابات Google دون إعادة تسجيل |
| استيراد cookies المتصفح | إعادة استخدام جلسة مسجّلة |
تغطية التوليد واسعة: ملخصات صوتية (4 صيغ، 50+ لغة)، فيديو (بما في ذلك cinematic)، إنفوغرافيك، تقارير، quiz، بطاقات، خرائط ذهنية وجداول — غالباً بتحكم أدق من الموقع.
تثبيت سريع
مستخدمو CLI (بما فيهم الوكلاء):
pip install "notebooklm-py[browser]"
playwright install chromium
notebooklm login
notebooklm auth check --test --json
المكتبة فقط (مع storage_state.json مسبقاً، دون Chromium):
pip install notebooklm-py
راجع installation.md في المشروع للتفاصيل.
جولة CLI: من الدفتر إلى تنزيل البودكast
notebooklm create "AI Research"
notebooklm use <notebook_id>
notebooklm source add "https://en.wikipedia.org/wiki/Artificial_intelligence"
notebooklm source add "./paper.pdf"
notebooklm ask "What are the key themes?"
notebooklm generate audio "make it engaging" --wait
notebooklm download audio ./podcast.mp3
notebooklm generate quiz --difficulty hard
notebooklm download quiz --format markdown ./quiz.md
استخدم --prompt-file للـ prompts الطويلة التي تتجاوز حد طول shell.
مثال Python API
import asyncio
from notebooklm import NotebookLMClient
async def main():
async with await NotebookLMClient.from_storage() as client:
nb = await client.notebooks.create("Research")
await client.sources.add_url(nb.id, "https://example.com", wait=True)
result = await client.chat.ask(nb.id, "Summarize this")
print(result.answer)
status = await client.artifacts.generate_quiz(nb.id)
await client.artifacts.wait_for_completion(nb.id, status.task_id)
await client.artifacts.download_quiz(nb.id, "quiz.json", output_format="json")
asyncio.run(main())
التصميم غير المتزامن يندمج جيداً في تدفقات asyncio الأوسع.
تكامل Claude Code
المستودع يتضمن Agent Skill. مساران للتثبيت:
# الخيار 1: تثبيت CLI إلى Claude Code / مجلد .agents
notebooklm skill install
# الخيار 2: نظام skills
npx skills add teng-lin/notebooklm-py
بعد الإعداد يمكنك أن تطلب من Claude Code: «أضف هذا PDF إلى NotebookLM، ولّد quiz صعباً وصدّر Markdown» — الوكيل يشغّل CLI notebooklm بدلاً من إجبارك على النقر في المتصفح.
للمطورين الذين يبنون تدفقات notebooklm ai ويريدون كل قدرات التوليد notebooklm رسمي، هذا أسلس مسار اليوم.
تفضل عدم إعداد بيئة محلية؟
Playwright والـ cookies وتغيّر APIs ليس للجميع. إذا أردت التركيز على رفع → سؤال → توليد دون تثبيت، جرّب تجربة NotebookLM عبر الإنترنت:
الخلاصة
notebooklm-py يحوّل NotebookLM من أداة ويب بالنقر فقط إلى محرك معرفة قابل للبرمجة وجاهز للوكلاء. 14.6k نجمة تعكس طلباً حقيقياً: باحثون يصدّرون quiz جماعياً، منشئون يدمجون توليد البودكast في خطوط، مطورون يديرون الاستيراد والتنزيل من Claude Code بجملة واحدة.
احتفظ بالويب للاستخدام اليومي الخفيف؛ استخدم Python + CLI + وكلاء عندما تحتاج أتمتة وتصديراً لم يقدمه المتصفح أبداً.
المشروع: github.com/teng-lin/notebooklm-py