notebooklm-py 是 teng-lin 维护的非官方 Gemini Notebook(原 NotebookLM)Python SDK、CLI、MCP/REST 服务和 Agent Skill。它把笔记本、资料源、问答、研究、生成物和分享操作做成可编程接口;它不是 Google SDK,两个后端都依赖未公开接口。
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md 查看 GitHub 仓库 → 📘 使用教程 →Google 在 2026-07-16 将 NotebookLM 更名为 Gemini Notebook,并披露超过 3000 万用户、60 万个组织使用该产品。项目随后在 v0.8.0 加入 MCP、REST 和远程连接器,在 v0.8.2 加入 Android gRPC 后端,所以关注点从脚本封装扩大到 Agent 集成和无人值守运行。
来源:blog.google/innovation-and-ai/products/gemini-notebook/notebooklm-gem…同一套客户端能力可从异步 Python API、CLI、本地或远程 MCP、实验性单租户 REST 服务以及 Agent Skill 调用。
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md可创建笔记本,加入网页、YouTube、本地文件、Drive 或文本资料,随后问答、研究,并生成音频、视频、幻灯片、测验、闪卡、报告、表格和思维导图。
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md默认 Web 后端使用浏览器会话和 batchexecute;v0.8.2 的 Android 后端使用持久主令牌换取短期 bearer token,十一组公开命名空间都可直接走移动端 gRPC。
来源:github.com/teng-lin/notebooklm-py/releases/tag/v0.8.2支持批量下载,以及把测验、闪卡、思维导图和数据表导出为 JSON、Markdown、HTML 或 CSV;幻灯片可下载为 PPTX/PDF。
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md公开入口共用 Python 客户端和应用层:功能按 notebooks、sources、chat、research、artifacts、sharing 等命名空间组织,再由认证与传输层选择 Web batchexecute 或 Android gRPC。CLI、MCP 与 REST 都复用这一核心。Web 配置保存浏览器会话;Android 配置保存能换取短期令牌的主令牌。远程 MCP 通常还会经过 Cloudflare Tunnel 或 Tailscale Funnel,因此账号凭据、连接器密码和公网入口必须一起纳入威胁模型。
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md;https://github.…httpxPlaywright/Chromium(browser extra)Android gRPC 运行依赖(android extra)适合个人研究原型、批量资料导入、结构化导出和本地 Agent 调用。涉及生产关键链路、多人账号或公网 MCP 时要谨慎,因为 Google 内部接口会变化,账号额度与地区限制也会影响结果。
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md当前稳定版 v0.8.2 发布于 2026-09-02。重点是完整 Android gRPC 后端、聊天任务状态与取消、笔记本复制、段落搜索、Play Books 资料源和研究发现;Release 同时警告持久主令牌比 Cookie 快照权限更强。
来源:github.com/teng-lin/notebooklm-py/releases/tag/v0.8.2status: official_docs_checked_not_run | checked_at: 2026-09-23 | environment: 核对官方 README、v0.8.2 Release 与 Google 更名公告 | limitations: 未安装包或 Chromium,未登录 Google,未读取 Cookie/主令牌,未创建笔记本,未上传资料,未启动 MCP/REST 或发出任何请求 | observed_output: 当前稳定版为 v0.8.2(2026-09-02);官方 Release 明确 Android 后端的主令牌风险以及两个后端都依赖未公开 API
来源:github.com/teng-lin/notebooklm-py/releases/tag/v0.8.2;https://github.…与 Google 官方 Gemini Notebook 网页产品相比,notebooklm-py 提供脚本、批量导出、MCP 与 REST 入口;代价是这些入口来自社区对未公开 API 的封装。Google 公告确认 Gemini Notebook 是官方独立产品,并提供 Gemini 应用与 Search 同步方向;它不等于为 notebooklm-py 提供兼容性或支持。
来源:blog.google/innovation-and-ai/products/gemini-notebook/notebooklm-gem…它是功能很全的 Gemini Notebook 自动化入口,适合受控的个人研究和原型。先用默认 Web 后端和非敏感资料做小范围验证;如果无法接受非公开 API 失效或账号凭据暴露的后果,就不应把它放进关键生产链路。
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md;https://github.…不是。仓库明确写明它是社区项目,与 Google 无关联;Web 和 Android 后端都使用未公开 API,可能在没有通知时变化。
普通交互先用默认 Web 后端。Android 后端适合长时间运行,但会保存权限更强的主令牌;只有能使用专用账号并妥善保护 profile 时才应考虑。
官方 README 建议用于原型、研究和个人项目。生产使用必须接受接口突变、限流、账号档位、地区限制和认证失效,并准备停用或回退方案。
默认不能认为安全。远程连接器可操作资料、生成物和分享设置,应限制隧道可达范围,使用独立强密码和专用账号,并避免把 Cookie、主令牌或 profile 写入日志和仓库。