¿Qué hace nblm?
Usa esta habilidad para consultar tus cuadernos de Google NotebookLM directamente desde Claude Code y obtener respuestas fundamentadas en fuentes y respaldadas por citas de Gemini. Incluye automatización del navegador, gestión de bibliotecas y autenticación persistente. Reduce drásticamente las alucinaciones mediante respuestas basadas únicamente en documentos.
Requisitos
- Navegador: Chromium o Chrome con Puppeteer.
- Cuenta de Google: Se requiere una cuenta de Google con acceso a NotebookLM.
- Variables de entorno:
NBLM_EMAIL: Tu correo electrónico de Google.NBLM_PASSWORD: Tu contraseña de Google (se recomienda usar una contraseña de aplicación o token OAuth).
- Dependencias: Node.js 18+, Puppeteer, y
@anthropic-ai/claude-code(opcional).
Instalación
- Clona el repositorio:
git clone https://github.com/magicseek/nblm.git cd nblm - Instala las dependencias:
npm install - Configura las variables de entorno en un archivo
.env:[email protected] NBLM_PASSWORD=tu_contraseña - Inicia la sesión del navegador (esto guardará las cookies para autenticación persistente):
node login.js
Uso
Desde Claude Code
Una vez que la habilidad esté instalada y configurada, puedes invocarla con comandos como:
> nblm: ¿Cuáles son los puntos clave del cuaderno sobre machine learning?
Esto iniciará una sesión automatizada que:
- Autentica al usuario en NotebookLM (usando cookies guardadas).
- Busca el cuaderno especificado en la biblioteca.
- Ejecuta la consulta y devuelve fragmentos citados de los documentos.
- Cierra la sesión del navegador.
API Programática
También puedes usar la función queryNotebook(query, notebookName) desde Node.js:
import { queryNotebook } from 'magicseek/nblm';
const respuesta = await queryNotebook('Resume los argumentos principales', 'Mi Cuaderno de Investigación');
console.log(respuesta);
Características
- Autenticación persistente: Las cookies se almacenan localmente para evitar inicios de sesión repetitivos.
- Gestión de bibliotecas: Enumera y selecciona cuadernos por nombre.
- Respuestas con citas: Cada respuesta incluye enlaces directos a las fuentes en NotebookLM.
- Sin alucinaciones: Las respuestas se restringen al contenido de los documentos seleccionados.
Limitaciones
- Depende de la estabilidad de la interfaz web de NotebookLM.
- Requiere mantener actualizado el selector de elementos HTML (si Google cambia su interfaz).
- La autenticación puede fallar si se usan medidas de seguridad adicionales (como 2FA).
Licencia
MIT