notebooklm-py v0.8.2：先看清账号边界，再做自动化

notebooklm-py 把 Gemini Notebook（原 NotebookLM）的笔记本、资料、问答、研究、生成与下载做成 Python、CLI、MCP 和 REST 接口。它的能力很完整，但项目方在 README 顶部写得很清楚：这是社区项目，依赖 Google 未公开 API，不受 Google 支持。

先说结论：个人研究和原型可以从默认 Web 后端、小号和非敏感资料开始。关键生产链路、公司主账号、无人值守主令牌和公网 MCP 都需要额外的风险评估。

当前版本和变化

截至 2026-09-23，当前稳定版是 v0.8.2（2026-09-02）。这一版补齐 Android gRPC 后端，还加入聊天任务取消、笔记本复制、段落搜索、Play Books 资料源和研究发现。Google 已在 2026-07-16 把 NotebookLM 更名为 Gemini Notebook，包名没有跟着改。

双后端到底差在哪

默认 Web 后端使用浏览器登录状态和 batchexecute。Android 后端通过保存的主令牌换取短期 bearer token，更适合长时间进程，却把更强的全账号凭据放进本地 profile。官方 Release 也明确建议 Android 后端使用专用账号，并指出两个后端都可能因未公开接口变化而失效。

安装与最小工作流

uv tool install "notebooklm-py[browser]"
notebooklm login
notebooklm auth check --test --json
notebooklm create "test"
notebooklm source add "./public-sample.pdf"
notebooklm ask "这份资料的三点结论是什么？"

第一次登录会下载约 170 MB Chromium。先用一份公开样本检查账号、资料上传和引用，再考虑定时任务。不要把 profile、Cookie 或 `master_token.json` 提交进 Git。

权限与网络边界

上传的文件和网址会进入所选 Google 账号下的 Notebook 服务。
程序可以管理分享、资料和生成物，不能只按“问答工具”看待。
远程 MCP 通常还要经过 Cloudflare Tunnel 或 Tailscale Funnel；连接器密码、隧道策略和 Google 凭据是同一条攻击链。
账号档位、地区和配额会改变可用能力，脚本要处理限流与拒绝。

与 Google 官方 Gemini Notebook 对比

Google 官方产品提供网页和 Gemini 生态中的 Notebook 体验。notebooklm-py 的优势是脚本、批量导出、MCP 与 REST；代价是它通过社区封装访问未公开接口。Google 的产品公告不等于对这个库提供兼容承诺或技术支持。

验证边界：本轮只核对官方 README、v0.8.2 Release 和 Google 公告。未安装包或 Chromium，未登录 Google，未读取 Cookie/主令牌，未创建笔记本、上传资料、启动 MCP/REST 或发出请求。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

近期变化与关注原因

Google 在 2026-07-16 将 NotebookLM 更名为 Gemini Notebook，并披露超过 3000 万用户、60 万个组织使用该产品。项目随后在 v0.8.0 加入 MCP、REST 和远程连接器，在 v0.8.2 加入 Android gRPC 后端，所以关注点从脚本封装扩大到 Agent 集成和无人值守运行。

适合谁用

适合个人研究原型、批量资料导入、结构化导出和本地 Agent 调用。涉及生产关键链路、多人账号或公网 MCP 时要谨慎，因为 Google 内部接口会变化，账号额度与地区限制也会影响结果。

原教程未展开的系统信息

核心功能

五种调用入口
同一套客户端能力可从异步 Python API、CLI、本地或远程 MCP、实验性单租户 REST 服务以及 Agent Skill 调用。
资料到产物的完整流程
可创建笔记本，加入网页、YouTube、本地文件、Drive 或文本资料，随后问答、研究，并生成音频、视频、幻灯片、测验、闪卡、报告、表格和思维导图。
批量与结构化导出
支持批量下载，以及把测验、闪卡、思维导图和数据表导出为 JSON、Markdown、HTML 或 CSV；幻灯片可下载为 PPTX/PDF。

架构与数据流

公开入口共用 Python 客户端和应用层：功能按 notebooks、sources、chat、research、artifacts、sharing 等命名空间组织，再由认证与传输层选择 Web batchexecute 或 Android gRPC。CLI、MCP 与 REST 都复用这一核心。Web 配置保存浏览器会话；Android 配置保存能换取短期令牌的主令牌。远程 MCP 通常还会经过 Cloudflare Tunnel 或 Tailscale Funnel，因此账号凭据、连接器密码和公网入口必须一起纳入威胁模型。

常见问题

notebooklm-py v0.8.2 是 Google 官方 SDK 吗？

不是。仓库明确写明它是社区项目，与 Google 无关联；Web 和 Android 后端都使用未公开 API，可能在没有通知时变化。

notebooklm-py 的 Web 后端和 Android 后端该怎么选？

普通交互先用默认 Web 后端。Android 后端适合长时间运行，但会保存权限更强的主令牌；只有能使用专用账号并妥善保护 profile 时才应考虑。

notebooklm-py 能直接用于生产服务吗？

官方 README 建议用于原型、研究和个人项目。生产使用必须接受接口突变、限流、账号档位、地区限制和认证失效，并准备停用或回退方案。

把 notebooklm-py 的 MCP 暴露到公网安全吗？

默认不能认为安全。远程连接器可操作资料、生成物和分享设置，应限制隧道可达范围，使用独立强密码和专用账号，并避免把 Cookie、主令牌或 profile 写入日志和仓库。

官方来源：仓库、v0.8.2、Google 更名公告。