● Comunidad
teng-lin
⚡ Instantáneo
NotebookLM-py
por teng-lin · teng-lin/notebooklm-py
Controla Google NotebookLM desde Claude — crea notebooks, ingesta fuentes, genera resúmenes de audio, incluyendo funciones que la UI web oculta.
notebooklm-py es una API Python no oficial + skill de Claude para NotebookLM. Expone el CRUD de notebooks, ingestión de fuentes (PDFs, URLs, YouTube) y las funciones de resumen de audio / mapa mental / FAQ. Incluye un CLI y un skill de agente para que puedas decir 'carga estos PDFs en un notebook y dame el resumen de audio' sin abrir nunca notebooklm.google.com.
Por qué usarlo
Características clave
- CRUD de notebooks via Python o skill
- Ingestión de múltiples fuentes (PDF, URL, YouTube)
- Genera resúmenes de audio, mapas mentales, FAQs de forma programática
- Acceso a funciones que la UI web no expone
- CLI para scripting puntual
Demo en vivo
Cómo se ve en la práctica
listo
Casos de uso
Usos del mundo real: NotebookLM-py
Cuándo usarlo: 10 papers llegaron a tu bandeja; quieres una síntesis rápida.
Requisitos previos
- Cuenta de Google con acceso a NotebookLM — Inicia sesión una vez a través del flujo de autenticación de Python
Flujo
-
Ingestar
Usa notebooklm-py. Crea un notebook 'Lecturas T2'. Añade los 10 PDFs de /papers/.✓ Copiado
→ Notebook creado; fuentes cargadas
-
Sintetizar
Genera un resumen agrupado por temas a través de todas las fuentes.✓ Copiado
→ Síntesis entre fuentes
-
Audio
Genera un resumen de audio. Guarda el MP3.✓ Copiado
→ Archivo MP3
Resultado: 10 papers digeridos en algo que puedes leer en 20 minutos o escuchar mientras caminas.
Errores comunes
- La calidad de las fuentes varía — Pide atribución por fuente en la síntesis
Cuándo usarlo: Tienes docs y necesitas un FAQ para los usuarios.
Flujo
-
Cargar
Crea un notebook a partir de /docs (recursivo). Genera el FAQ.✓ Copiado
→ Output del FAQ
-
Refinar
Elimina los elementos del FAQ que no se preguntan realmente. Añade citas a las secciones de la fuente.✓ Copiado
→ FAQ citado y filtrado por relevancia
Resultado: FAQ listo para publicar.
Errores comunes
- Preguntas genéricas — Proporciona ejemplos de preguntas reales de usuarios si los tienes
Combinaciones
Combínalo con otros MCPs para multiplicar por 10
Guardar resúmenes de audio + resúmenes localmente
Guarda el MP3 en /research/audio/.✓ Copiado
ARIS para investigación autónoma, NotebookLM para síntesis
ARIS encuentra los papers; NotebookLM los digiere en un resumen de audio.✓ Copiado
Coste y límites
Lo que cuesta ejecutarlo
- Cuota de API
- Limitado por los límites del plan de NotebookLM
- Tokens por llamada
- Tokens mínimos — el coste principal es la API de NotebookLM
- Monetario
- Gratis en el nivel gratuito de NotebookLM; de pago para límites más altos
- Consejo
- Reutiliza los notebooks; no los crees y deseches
Seguridad
Permisos, secretos, alcance
Ámbitos mínimos: Google auth for NotebookLM
Almacenamiento de credenciales: Caché local de token OAuth
Salida de datos: Google NotebookLM
No conceder nunca: OAuth scopes you don't need
- No oficial — puede romperse si Google cambia la superficie subyacente
Resolución de problemas
Errores comunes y soluciones
Flujo de autenticación bloqueado
Limpia el caché local de token y vuelve a autenticarte
La ingestión de fuentes falla en PDFs grandes
Divide en trozos más pequeños; NotebookLM tiene límites de tamaño por fuente
La generación de audio está en cola para siempre
La cola de audio de NotebookLM puede ser lenta; reintenta más tarde
Alternativas
NotebookLM-py vs otros
| Alternativa | Cuándo usarla | Contrapartida |
|---|
| UI web de NotebookLM | Uso manual, puntual | Sin automatización; se pierden las funciones programáticas |
| Pipeline RAG personalizado | Necesitas control total sobre los modelos | Mucha ingeniería frente a las funciones gratuitas de NotebookLM |