用途:从 Claude Code 中查询 Google NotebookLM 笔记本,获取基于上传文档、带引用的回答。适用于用户提及 NotebookLM、分享 NotebookLM 链接、要求查询笔记本文档或向笔记本库添加文档时。
主要能力:认证管理(setup/status/reauth/clear);笔记本库管理(add/list/search/activate/remove/stats);提问接口(支持指定笔记本 ID 或 URL,可用 --show-browser 调试);数据清理;自动管理虚拟环境并安装依赖与 Chromium。
必要用法:始终通过 run.py 包装器调用,例如 python scripts/run.py auth_manager.py status 检查认证,首次使用 python scripts/run.py auth_manager.py setup 完成 Google 登录(浏览器必须可见),用 notebook_manager.py add 添加笔记本时 --description 与 --topics 为必填,若未知应先用 ask_question.py 智能发现内容;提问用 python scripts/run.py ask_question.py --question "..."。答案末尾会出现“Is that ALL you need to know?”提示,需据此继续追问,综合多个回答后再回复用户。
适用场景:查询个人文档、检索 NotebookLM 库、按主题搜索笔记本、获取带引用的来源性答案。
限制:无会话持久化,每次提问都新建浏览器;免费 Google 账户有速率限制(约每天 50 次查询);文档需用户手动上传到 NotebookLM;每次提问有浏览器开销;认证时浏览器必须可见。