notebooklm-py 是什么?

notebooklm-py 是 teng-lin 维护的非官方 Gemini Notebook(原 NotebookLM)Python SDK、CLI、MCP/REST 服务和 Agent Skill。它把笔记本、资料源、问答、研究、生成物和分享操作做成可编程接口;它不是 Google SDK,两个后端都依赖未公开接口。

⭐ 17,360 Stars 🍴 2,362 Forks Python — 作者: teng-lin
来源: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 与 Android 双后端

默认 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.…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) httpx Playwright/Chromium(browser extra)Playwright/Chr… Android gRPC 运行依赖(android extra)Android gRPC… 五种调用入口 资料到产物的完整流程 Web 与 Android 双后端 批量与结构化导出 notebooklm-py 项目本体 核心功能 关键依赖

技术栈

语言Python 3.10–3.14框架async Python client、CLI、MCP、实验性 REST
httpxPlaywright/Chromium(browser extra)Android gRPC 运行依赖(android extra)
PyPI/uv/pipx;本地 profile 保存 Cookie 或主令牌;可选自托管远程连接器
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md;https://github.…

快速上手

先用 `uv tool install "notebooklm-py[browser]"` 装到隔离环境,再执行 `notebooklm login`;第一次会下载约 170 MB Chromium。用 `notebooklm auth check --test --json` 检查认证,看到 `status: ok` 后再创建笔记本、添加一份非敏感测试资料并提问。不要一开始就启用 Android 主令牌或公网远程 MCP;确有无人值守需求时,应使用专用 Google 账号、限制连接器可达范围并单独保护 profile。
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md

使用场景

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

来源:github.com/teng-lin/notebooklm-py/blob/main/README.md

优势与局限

优势

  • API、CLI、MCP、REST 和 Skill 共用一套能力
  • 覆盖资料、问答、研究、生成与下载的完整链路
  • v0.8.2 同时支持 Web 与 Android 后端

局限

  • 项目与 Google 无关联,两个后端都依赖未公开 API
  • 重度调用可能限流,账号档位和地区会限制功能
  • Cookie 或 Android 主令牌可访问账号能力,泄露影响大
  • 远程 MCP 会扩大网络和认证边界
来源:github.com/teng-lin/notebooklm-py/blob/main/README.md;https://github.…

最新版本

当前稳定版 v0.8.2 发布于 2026-09-02。重点是完整 Android gRPC 后端、聊天任务状态与取消、笔记本复制、段落搜索、Play Books 资料源和研究发现;Release 同时警告持久主令牌比 Cookie 快照权限更强。

来源:github.com/teng-lin/notebooklm-py/releases/tag/v0.8.2

实测与证据

status: 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.…

常见问题

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 写入日志和仓库。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件