● 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.
Pourquoi l'utiliser
Fonctionnalités clés
- CRUD de notebooks via Python ou skill
- Ingestion multi-sources (PDF, URL, YouTube)
- Génération d'aperçus audio, mind maps, FAQs de façon programmatique
- Accès aux fonctionnalités que l'interface web n'expose pas
- CLI pour les scripts ponctuels
Démo en direct
Aperçu en pratique
prêt
Cas d'usage
Usages concrets : NotebookLM-py
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
-
Ingérer
Utilise notebooklm-py. Crée un notebook 'Lecture T2'. Ajoute les 10 PDFs de /papers/.✓ Copié
→ Notebook créé ; sources chargées
-
Synthétiser
Génère un résumé par cluster thématique sur toutes les sources.✓ Copié
→ Synthèse cross-sources
-
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
Quand l'utiliser : Vous avez des docs et avez besoin d'une FAQ pour les utilisateurs.
Déroulement
-
Charger
Crée un notebook depuis /docs (récursivement). Génère une FAQ.✓ Copié
→ Sortie FAQ
-
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
Sauvegarder les aperçus audio + résumés localement
Sauvegarde le MP3 dans /research/audio/.✓ Copié
ARIS pour la recherche autonome, NotebookLM pour la synthèse
ARIS trouve les articles ; NotebookLM les digère en aperçu audio.✓ Copié
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
- Non officiel — peut se casser si Google modifie la surface sous-jacente
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
| Alternative | Quand l'utiliser | Compromis |
|---|
| Interface web NotebookLM | Usage manuel ponctuel | Pas d'automatisation ; manque les fonctionnalités programmatiques |
| Pipeline RAG personnalisé | Vous avez besoin d'un contrôle total sur les modèles | Beaucoup d'ingénierie vs fonctionnalités NotebookLM gratuites |