Herramientasnotebooklm
NotebookLM Skill: conecta cuadernos con Claude Code
Descubre qué hace NotebookLM Skill, cómo evaluar su instalación y qué riesgos de acceso, privacidad y citas debes revisar antes de usarla en tu trabajo.
- Autor: humAIns
- 10 min de lectura
índice · 9 apartados
NotebookLM Skill es una skill comunitaria que permite a Claude Code local interactuar con cuadernos de NotebookLM —denominado Gemini Notebook desde el 16 de julio de 2026— mediante automatización del navegador. El repositorio elegido, cclank/notebooklm-skill, documenta consultas, gestión de una biblioteca de cuadernos y carga de fuentes. No es una integración oficial de Google o Anthropic, y no hemos encontrado en las fuentes oficiales consultadas una API oficial para esta integración. Esta guía explica qué revisar antes de instalarla y cómo probarla sin documentos reales ni credenciales expuestas. Consulta del repositorio, su README y la documentación oficial: 18 de noviembre de 2026.
Qué es NotebookLM Skill y quién mantiene el repositorio
Una skill de Claude Code es una carpeta de instrucciones que el asistente puede cargar cuando la tarea encaja. La documentación de Anthropic define el archivo SKILL.md y la ubicación de las skills; el código que acompaña una skill, en cambio, puede hacer mucho más que describir un procedimiento.
El repositorio cclank/notebooklm-skill se presenta como una implementación Python para Claude Code local, inspirada en un servidor MCP distinto. En su README declara funciones para hacer preguntas a notebooks, cargar archivos o URLs y administrar una biblioteca. La ficha de GitHub consultada muestra una licencia MIT, pero la licencia no certifica seguridad ni garantiza soporte. Revisa la fecha de cambios, los autores, incidencias y el contenido de la versión concreta antes de confiar en ella: el repositorio puede cambiar después de esta consulta.
La documentación del propio proyecto señala dependencias de Python y automatización con Patchright/navegador, y describe un flujo que puede instalar dependencias en un entorno local. No tomes sus afirmaciones promocionales sobre precisión, facilidad o inmunidad a bloqueos como resultados independientes verificados.
Skill de terceros, función nativa y API no son lo mismo
Gemini Notebook ofrece funciones propias de Google, descritas en su centro oficial de ayuda. Claude Code, por su parte, admite skills basadas en SKILL.md, cuyas rutas y reglas se detallan en la documentación de Anthropic. La skill de cclank conecta esos dos productos por su cuenta: sus instrucciones ejecutan scripts y automatizan un navegador. No se convierte por ello en una función nativa de ninguno de los dos.
El repositorio también distingue su skill de una integración MCP. Son enfoques y proyectos diferentes, con instalaciones, dependencias y comportamientos que pueden variar. Tampoco confundas automatizar la web con utilizar una API oficial: no atribuyas a Google una API pública para este puente si no hay documentación primaria que lo confirme. Si necesitas una integración soportada para un proceso empresarial, verifica primero los productos y APIs que Google ofrece oficialmente para tu caso.
Qué revisar antes de instalarla
No ejecutes directamente un comando de instalación copiado de un README. Primero lee los archivos de instrucciones y los scripts que esas instrucciones invocan. En el repositorio elegido revisa, como mínimo, SKILL.md, scripts/run.py, scripts/auth_manager.py, scripts/ask_question.py, los scripts de carga y requirements.txt. Busca operaciones de red, ejecución de subprocesos, lecturas y escrituras de archivos, manejo de cookies, almacenamiento de estado y solicitudes de permisos.
Comprueba también la versión o revisión exacta que has descargado, la licencia aplicable y qué cambios incluye respecto a la documentación que estás leyendo. Una guía puede describir una versión distinta a la que obtienes hoy. Si no puedes explicar qué hace un script o por qué necesita un permiso, no lo ejecutes; puedes usar la interfaz oficial de Gemini Notebook manualmente como alternativa.
La documentación oficial de Claude Code indica que una skill personal se guarda bajo ~/.claude/skills/<nombre>/SKILL.md; las skills de un proyecto pueden ir en .claude/skills/<nombre>/SKILL.md. Para este repositorio el README propone clonar la carpeta en ~/.claude/skills/notebooklm, lo que hace que sea una skill personal en esa máquina. Revisa la ruta antes de copiar archivos: una skill de proyecto comparte su alcance con el repositorio; una personal puede aparecer en otras sesiones de esa máquina.
Qué autoriza el inicio de sesión y cómo probarla
El README del proyecto describe una autenticación manual en una ventana de Chrome. La guía AUTHENTICATION.md explica que la sesión utiliza un perfil de navegador y un archivo local state.json con cookies, que se vuelven a cargar para las operaciones posteriores. Por tanto, aunque no pegues una contraseña en Claude, el programa puede acceder a una sesión autenticada guardada en tu equipo. Cualquier persona o proceso que pueda leer esos archivos podría heredar ese acceso.
Haz una prueba aislada, sin cuadernos de trabajo:
- Lee los scripts de autenticación y confirma la ubicación exacta donde guardan el perfil, las cookies y los metadatos. Comprueba qué carpetas quedan excluidas del control de versiones y no des por hecho que
.gitignoreequivale a cifrado o protección del sistema operativo. - Usa una cuenta y un entorno de prueba que tengas autorización para utilizar. No entregues contraseñas, tokens ni cookies en el chat, en prompts o en incidencias.
- Crea en Gemini Notebook un cuaderno con un documento inventado, por ejemplo una nota que diga «Proyecto Prueba: entrega el día 12».
- Si decides autorizar la sesión, hazlo en la ventana visible que documenta el proyecto. Pide una consulta simple sobre el dato ficticio y compara la respuesta con la fuente. No cargues datos de clientes, contratos ni documentos internos.
- Observa qué archivos crea, si la biblioteca local registra el enlace o metadatos del cuaderno y qué permisos solicita. Detén la prueba ante accesos inesperados, errores de autenticación o instrucciones para compartir el cuaderno públicamente.
El repositorio documenta comandos de estado, reautenticación y limpieza, incluidos auth_manager.py clear y cleanup_manager.py. Confirma en el código de la versión que instalaste qué borra cada uno antes de usarlos: borrar un archivo local no revoca necesariamente permisos o sesiones del lado de Google. Para terminar, elimina de forma segura los datos locales de autenticación según la documentación revisada y, si sospechas que una sesión quedó expuesta, cierra o revoca el acceso desde la configuración de seguridad de la cuenta de Google. No compartas cookies para pedir ayuda.
Ejemplo de consulta con citas: verifica la fuente
Con el cuaderno ficticio ya abierto, una consulta de evaluación podría pedir: «Según el documento Proyecto Prueba, ¿qué fecha aparece para la entrega? Incluye la cita o referencia disponible y señala si no encuentras evidencia». El objetivo no es comprobar si la respuesta suena convincente, sino si Claude transmite el dato exacto y permite localizarlo en la fuente.
Abre la referencia que devuelva Gemini Notebook, confirma que apunta al documento correcto y lee la frase completa alrededor del fragmento. Comprueba que no haya condiciones omitidas, una fecha diferente en otra versión o una cita que respalde solo parte de la respuesta. Si la interfaz o la automatización no aporta una referencia comprobable, registra el resultado como no verificado: no inventes una cita ni uses esa salida para una decisión profesional.
Las respuestas con fuentes pueden reducir el trabajo de búsqueda, pero no garantizan que el modelo haya seleccionado la fuente adecuada o interpretado bien una tabla, una excepción o el contexto. Para información crítica conserva el documento original y valida cada afirmación antes de reutilizarla. La guía de NotebookLM y Gemini Notebook explica el producto; la guía de privacidad de NotebookLM desarrolla qué evaluar antes de subir documentos.
Riesgos: navegador, sesión, documentos y actualizaciones
Automatización del navegador. Un script que opera una web depende de su interfaz y puede dejar de funcionar si Google modifica el sitio, introduce una verificación o cambia el flujo de acceso. El propio proyecto advierte que no puede garantizar que Google no detecte o limite el uso automatizado. No des por garantizada la continuidad ni intentes eludir controles de seguridad.
Cookies y sesión. El archivo de estado del navegador equivale a material de acceso sensible. Limita quién puede leer el directorio de la skill, evita sincronizarlo o incluirlo en repositorios y elimina los datos de autenticación cuando ya no los necesites. El README y la guía técnica describen almacenamiento local; eso no basta para concluir que ningún dato sale de tu equipo durante la consulta: el navegador accede a servicios de Google y debes revisar las solicitudes y el flujo completo.
Documentos y permisos. Una consulta puede exponer contenido al servicio al que se envía y a la cuenta autenticada. Confirma las condiciones de Google para la cuenta concreta y las reglas de tu organización. La documentación oficial de privacidad y condiciones de Gemini Notebook distingue modalidades de uso; no extrapoles las protecciones de Workspace a una cuenta personal.
Cambios del repositorio. Una actualización puede añadir scripts, dependencias o permisos. Fija una revisión conocida, vuelve a leer el diff antes de actualizar y repite la prueba ficticia. No automatices actualizaciones sin inspección.
Fallos habituales y alternativas
Si Claude Code no detecta la skill, comprueba el nombre SKILL.md, la estructura de carpetas, el directorio de inicio y las instrucciones actuales de Anthropic. Si la autenticación falla, no pegues cookies ni datos del navegador en una conversación para diagnosticarlo: revisa la documentación del proyecto, comprueba el estado de la cuenta en Google y usa la opción de reautenticación solo después de inspeccionar qué hace.
Si el navegador se rompe o el flujo deja de funcionar, evita instalar dependencias de fuentes desconocidas para «arreglarlo» sin leerlas. Puedes abrir Gemini Notebook directamente, añadir fuentes desde su interfaz y verificar allí las citas. Si necesitas otra arquitectura, compara el proyecto MCP enlazado desde el repositorio con integraciones oficialmente documentadas, teniendo en cuenta que un servidor distinto introduce sus propios riesgos.
Para aprender a revisar instrucciones y código de skills antes de instalarlos, consulta instalar skills en Claude Code. La decisión práctica es sencilla: si no puedes auditar el acceso a navegador y la sesión guardada, no conectes la skill a una cuenta con cuadernos sensibles.
Preguntas frecuentes
¿NotebookLM Skill es oficial?
No. Es un proyecto de terceros publicado en GitHub. Que Claude Code admita skills oficialmente no convierte este repositorio en una integración aprobada por Anthropic o Google.
¿Cómo se conecta con Claude Code?
El README propone instalar el repositorio en la carpeta personal de skills de Claude Code local. Sus instrucciones llaman scripts Python que automatizan el navegador para operar con Gemini Notebook. El repositorio indica que no está pensado para la interfaz web de Claude Code.
¿Accede a mis cuadernos?
Puede actuar con la cuenta de Google autenticada en el navegador. La documentación del repositorio describe un perfil de navegador y cookies almacenados localmente; comprueba el alcance de esa sesión y no lo pruebes con cuadernos que contengan información confidencial.
¿Las citas garantizan una respuesta correcta?
No. Abre cada referencia, comprueba el contexto y compara la respuesta con el documento original. Una cita facilita la verificación; no sustituye el criterio profesional.
Fuentes y siguientes pasos
Fuentes consultadas el 18 de noviembre de 2026: repositorio y README de cclank/notebooklm-skill, guía de autenticación del proyecto, skills de Claude Code y ayuda oficial de Gemini Notebook. Las instrucciones y funcionalidades comunitarias pueden variar entre revisiones; revisa el contenido de la versión que vayas a utilizar.
Si quieres desarrollar aplicaciones prácticas de IA en marketing, conoce el curso de IA para marketing; no presupone que enseñe esta integración específica. También puedes empezar por el test gratuito ¿Cuánto te queda?.
Sigue leyendo en humAIns