/ Annuaire / Playground / NotebookLM-py
← Tous les serveurs ↗ GitHub
● Communauté teng-lin ⚡ Instantané

NotebookLM-py

par teng-lin · teng-lin/notebooklm-py

Pilotez Google NotebookLM depuis Claude — créez des notebooks, ingérez des sources, générez des aperçus audio, y compris les fonctionnalités cachées par l'interface web.

notebooklm-py est une API Python non officielle + skill Claude pour NotebookLM. Elle expose le CRUD de notebooks, l'ingestion de sources (PDFs, URLs, YouTube) et les fonctionnalités d'aperçu audio / mind map / FAQ. Comprend un CLI et un skill agent pour pouvoir dire « charge ces PDFs dans un notebook et donne-moi l'aperçu audio » sans jamais ouvrir notebooklm.google.com.

▶ Voir la démo 📦 Installer 💡 Cas d'usage

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

~/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
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.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 utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "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
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.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"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : NotebookLM-py

Construire une synthèse de recherche depuis un lot d'articles

👤 Chercheurs / analystes ⏱ ~20 min beginner

Quand l'utiliser : 10 articles sont arrivés dans votre boîte de réception ; vous voulez une synthèse rapidement.

Prérequis
  • Compte Google avec accès NotebookLM — Connectez-vous une fois via le flux d'auth Python
Déroulement
  1. Ingérer
    Utilise notebooklm-py. Crée un notebook 'Lecture T2'. Ajoute les 10 PDFs de /papers/.✓ Copié
    → Notebook créé ; sources chargées
  2. Synthétiser
    Génère un résumé par cluster thématique sur toutes les sources.✓ Copié
    → Synthèse cross-sources
  3. Audio
    Génère un aperçu audio. Sauvegarde le MP3.✓ Copié
    → Fichier MP3

Résultat : 10 articles digérés en quelque chose que vous pouvez lire en 20 minutes ou écouter pendant une promenade.

Pièges
  • La qualité des sources varie — Demandez l'attribution par source dans la synthèse
Combiner avec : filesystem

Générer automatiquement une FAQ depuis la documentation produit

👤 Product / DevRel ⏱ ~25 min beginner

Quand l'utiliser : Vous avez des docs et avez besoin d'une FAQ pour les utilisateurs.

Déroulement
  1. Charger
    Crée un notebook depuis /docs (récursivement). Génère une FAQ.✓ Copié
    → Sortie FAQ
  2. Affiner
    Retire les items FAQ qui ne sont pas vraiment fréquemment demandés. Ajoute des citations vers les sections sources.✓ Copié
    → FAQ citée et filtrée par pertinence

Résultat : FAQ prête à publier.

Pièges
  • Questions génériques — Fournissez des exemples de vraies questions d'utilisateurs si vous en avez

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

notebooklm-py-skill + filesystem

Sauvegarder les aperçus audio + résumés localement

Sauvegarde le MP3 dans /research/audio/.✓ Copié
notebooklm-py-skill + aris-research-skill

ARIS pour la recherche autonome, NotebookLM pour la synthèse

ARIS trouve les articles ; NotebookLM les digère en aperçu audio.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
create_notebook title Nouveau projet 1 op NotebookLM
add_source notebook_id, source: pdf|url|youtube Construire l'ensemble de sources 1 op + temps d'ingestion
generate_audio notebook_id, style? Aperçu audio 1 op + rendu
generate_mind_map notebook_id Visualiser la structure des sources 1 op
ask notebook_id, question Q&R ancré dans les sources 1 op

Coût et limites

Coût d'exécution

Quota d'API
Limité par les limites du plan NotebookLM
Tokens par appel
Tokens minimaux — la plupart du coût est dans l'API NotebookLM
Monétaire
Gratuit au niveau gratuit de NotebookLM ; payant pour des limites plus élevées
Astuce
Réutilisez les notebooks ; ne créez pas et ne jetez pas

Sécurité

Permissions, secrets, portée

Portées minimales : Auth Google pour NotebookLM
Stockage des identifiants : Cache local de token OAuth
Sortie de données : Google NotebookLM
Ne jamais accorder : Portées OAuth dont vous n'avez pas besoin

Dépannage

Erreurs courantes et correctifs

Flux d'auth bloqué

Videz le cache de token local et ré-authentifiez

Échec d'ingestion de source pour les gros PDFs

Découpez en parties plus petites ; NotebookLM a des limites de taille par source

Génération audio en file d'attente indéfiniment

La file audio de NotebookLM peut être lente ; réessayez plus tard

Alternatives

NotebookLM-py vs autres

AlternativeQuand l'utiliserCompromis
Interface web NotebookLMUsage manuel ponctuelPas d'automatisation ; manque les fonctionnalités programmatiques
Pipeline RAG personnaliséVous avez besoin d'un contrôle total sur les modèlesBeaucoup d'ingénierie vs fonctionnalités NotebookLM gratuites

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills