Python notebooklm-py 非官方NotebookLM的Python接口

一、项目介绍

NotebookLM（现已并入 Gemini Notebook）把文档变成可对话的知识库，但官方只给网页界面，很多能力——批量导出、程序化检索、把结果接进自己的流水线——网页点不出来。你想用脚本或 AI 智能体驱动 NotebookLM，却只能手动复制粘贴。
notebooklm-py 是一个非官方的 Python API 兼 Agent 技能，把 NotebookLM 的功能（包括网页 UI 没暴露的部分）变成可编程接口：支持 Python、CLI 和 Claude Code / Codex / OpenClaw 等智能体调用。登录一次，就能用代码列出笔记本、读取内容、跑分析，把“人工在网页上操作”升级成“自动化流水线”。

二、项目基本信息

三、核心优势

• 非官方全功能：覆盖网页端未暴露的能力
• 多形态调用：Python / CLI / Agent 技能都支持
• 登录态复用：一次 master-token 登录，多端可用
• 可组合：轻松接进你自己的数据处理脚本
• 智能体原生：npx skills 一键装进编码助手

四、适用场景

适合要把 NotebookLM/Gemini Notebook 接进自动化流程、做知识库批量处理的开发者与研究者：希望用代码而非手动操作来驱动笔记本。

五、安装教程

当前最新版本 latest。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 安装（可选浏览器后端）
pip install "notebooklm-py[android,browser]"
# 首次登录（会下载 Chromium 并走 Google 登录）
notebooklm login --master-token --account you@example.com
# 校验登录状态
notebooklm auth check --test --json

常见报错：依赖缺失时先升级运行环境（Node、Python、Go 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

# 列出某个后端下的笔记本
notebooklm --backend android list --json
# 在 Claude Code / Codex 中作为技能安装
npx skills add teng-lin/notebooklm-py

七、常见问题

问：官方改名 Gemini Notebook 影响使用吗？答：不影响，底层服务相同，库名仍保留 notebooklm-py。问：必须登录 Google 账号吗？答：是，登录态用于驱动你的 NotebookLM 实例。

八、总结

notebooklm-py 用一个清晰的设计，把把智能体工程能力沉淀成库这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。