/ الدليل / الملعب / NotebookLM-py
● مجتمع teng-lin ⚡ فوري

NotebookLM-py

بواسطة teng-lin · teng-lin/notebooklm-py

تحكّم في Google NotebookLM من Claude — أنشئ دفاتر ملاحظات، استوعب المصادر، ولّد نظرات عامة صوتية، بما فيها ميزات تخفيها واجهة الويب.

notebooklm-py واجهة برمجية Python غير رسمية + مهارة Claude لـ NotebookLM. تكشف CRUD دفاتر الملاحظات واستيعاب المصادر (PDFs وURLs وYouTube) وميزات النظرة العامة الصوتية/الخريطة الذهنية/FAQ. تتضمن CLI لسكريبتات لمرة واحدة ومهارة agent حتى تقول 'حمّل هذه PDFs في دفتر ملاحظات وأعطني النظرة العامة الصوتية' دون فتح notebooklm.google.com أبدًا.

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

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

عرض مباشر

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

جاهز

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "notebooklm-py-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "notebooklm-py-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "notebooklm-py-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "notebooklm-py-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "notebooklm-py-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "notebooklm-py-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/teng-lin/notebooklm-py",
          "~/.claude/skills/notebooklm-py"
        ]
      }
    }
  }
}

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

claude mcp add notebooklm-py-skill -- git clone https://github.com/teng-lin/notebooklm-py ~/.claude/skills/notebooklm-py

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

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

استخدامات عملية: NotebookLM-py

بناء ملخص بحثي من دفعة أوراق

👤 الباحثون والمحللون ⏱ ~20 min beginner

متى تستخدمه: وصل 10 أوراق بحثية إلى صندوق بريدك؛ تريد تركيبًا سريعًا.

المتطلبات الأساسية
  • حساب Google مع وصول NotebookLM — سجّل الدخول مرة واحدة عبر تدفق مصادقة Python
الخطوات
  1. الاستيعاب
    Use notebooklm-py. Create a notebook 'Q2 Reading'. Add the 10 PDFs in /papers/.✓ تم النسخ
    → دفتر ملاحظات مُنشأ؛ المصادر محمّلة
  2. التركيب
    Generate a topic-clustered summary across all sources.✓ تم النسخ
    → تركيب عبر المصادر
  3. الصوت
    Generate an audio overview. Save the MP3.✓ تم النسخ
    → ملف MP3

النتيجة: 10 أوراق مُهضومة إلى شيء يمكنك قراءته في 20 دقيقة أو الاستماع إليه في المشي.

المزالق
  • جودة المصادر تتفاوت — اطلب نسبًا للمصادر في التركيب
اجمعها مع: filesystem

توليد FAQ تلقائي من وثائق المنتج

👤 المنتج / DevRel ⏱ ~25 min beginner

متى تستخدمه: لديك وثائق وتحتاج FAQ للمستخدمين.

الخطوات
  1. التحميل
    Create a notebook from /docs (recursive). Generate FAQ.✓ تم النسخ
    → مخرج FAQ
  2. التحسين
    Drop FAQ items that aren't actually frequently asked. Add citations to source sections.✓ تم النسخ
    → FAQ مُصفّى مع اقتباسات

النتيجة: FAQ جاهز للنشر.

المزالق
  • أسئلة عامة — قدّم أمثلة على أسئلة مستخدمين حقيقية إذا كانت متاحة

التركيبات

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

notebooklm-py-skill + filesystem

حفظ النظرات العامة الصوتية والملخصات محليًا

Save MP3 to /research/audio/.✓ تم النسخ
notebooklm-py-skill + aris-research-skill

ARIS للبحث الاستقلالي، NotebookLM للتركيب

ARIS finds papers; NotebookLM digests them into an audio overview.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
create_notebook title مشروع جديد 1 NotebookLM op
add_source notebook_id, source: pdf|url|youtube بناء مجموعة المصادر 1 op + ingestion time
generate_audio notebook_id, style? النظرة العامة الصوتية 1 op + render
generate_mind_map notebook_id تصوير بنية المصادر 1 op
ask notebook_id, question سؤال وجواب مستند إلى المصادر 1 op

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

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

حصة API
مقيّد بحدود خطة NotebookLM
الرموز لكل استدعاء
Tokens ضئيلة — معظم التكلفة من NotebookLM API
التكلفة المالية
مجاني في المستوى المجاني لـ NotebookLM؛ مدفوع لحدود أعلى
نصيحة
أعِد استخدام دفاتر الملاحظات؛ لا تُنشئها وتتخلص منها

الأمان

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

الحد الأدنى من الصلاحيات: Google auth for NotebookLM
تخزين بيانات الاعتماد: ذاكرة تخزين token OAuth محلية
نقل البيانات الخارجي: Google NotebookLM
لا تمنح أبدًا: OAuth scopes you don't need

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

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

Auth flow stuck

امسح ذاكرة تخزين token المحلية وأعد المصادقة

Source ingestion fails for big PDFs

قسّم إلى أجزاء أصغر؛ NotebookLM له حدود حجم لكل مصدر

Audio generation queued forever

قائمة انتظار الصوت في NotebookLM قد تكون بطيئة؛ أعد المحاولة لاحقًا

البدائل

NotebookLM-py مقابل البدائل

البديلمتى تستخدمهاالمقايضة
NotebookLM web UIاستخدام يدوي، لمرة واحدةلا أتمتة؛ يفوّت الميزات البرمجية
Custom RAG pipelineتحتاج تحكمًا كاملًا في النماذجهندسة كثيرة مقابل ميزات NotebookLM المجانية

المزيد

الموارد

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

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

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