teng-lin/notebooklm-py

解决的问题

notebooklm-py 提供对 Google NotebookLM（现为 Gemini Notebook）的程序化访问，允许用户绕过 Web UI 来实现研究、内容生成和知识管理的自动化。它能够将 NotebookLM 的基于事实的 AI 能力集成到 AI Agent（如 Claude Code 或 Codex）、Shell 脚本和自定义 Python 流水线中，有效地将该服务转变为其他 LLM 的可脚本化“记忆层”或综合引擎。

工作原理

该库作为一个非官方的 Python API 和 CLI 封装器，封装了未公开的 Google API。它支持多种身份验证方法，包括交互式浏览器登录、从现有浏览器导入 Cookie，以及用于无头服务器环境的主令牌 (master-token) 系统。它可以与 NotebookLM 交互以管理笔记本、上传各种类型的源（URL、PDF、YouTube 视频、Google Drive 文件），并触发引用式回答和多媒体内容的生成。

适用对象

• AI Agent 开发者：希望在不管理自身向量数据库的情况下，为 Agent 提供持久、基于事实的记忆或“项目大脑”的人员。
• 研究人员和学生：需要自动批量导入源文件并生成测验、抽认卡和播客等学习辅助工具的用户。
• 自动化工程师：正在构建用于定时音频简报或自动事件运行手册生成的无头流水线的人员。
• 知识管理人员：需要将 NotebookLM 的综合输出同步到 Obsidian 等工具的用户。

亮点

• 全功能覆盖：对笔记本、源、聊天、笔记和共享权限进行程序化控制。
• 多样化的内容生成：生成音频概览（播客）、视频、幻灯片、信息图、测验、抽认卡、报告和数据表。
• 扩展功能：提供 Web UI 中没有的功能，例如内容的批量下载，以及测验和思维导图的结构化导出（JSON、CSV、Markdown）。
• Agent 就绪：包含为 Claude Code 和 Codex 提供的内置技能，以及用于与 Claude Desktop 和 ChatGPT 集成的 MCP 服务器。
• 灵活的身份验证：支持多账号配置文件和用于无人值守、无头运行的主令牌系统。