notebooklm-py

一套综合的 NotebookLM 技能库与非官方 Python API。 通过 Python、CLI 以及 Claude Code、Codex 和 OpenClaw 等 AI Agent，实现对 NotebookLM 功能的全面程序化访问，包括网页版 UI 未公开的高级功能。

源码与开发:

⚠️ 非官方库 - 使用风险自担

本库使用了未公开的 Google API，这些 API 可能会在不通知的情况下发生变更。

• 与 Google 无关联 - 这是一个社区项目
• API 可能失效 - Google 随时可能更改内部接口
• 受速率限制 - 高频使用可能会被限流

适用于原型开发、研究及个人项目。请参阅 故障排除 获取调试技巧。

你可以构建的内容

🤖 AI Agent 工具 - 将 NotebookLM 集成到 Claude Code、Codex 及其他 LLM Agent 中。随附用于 GitHub 和 npx skills add 发现的根 NotebookLM 技能、支持 Claude Code 及 .agents 技能目录的本地 notebooklm skill install 功能，以及 AGENTS.md 中提供的仓库级 Codex 指导。

📚 研究自动化 - 批量导入源（URL、PDF、YouTube、Google Drive），运行带自动导入功能的网页/Drive 研究查询，并以程序化方式提取洞察。构建可复用的研究流水线。

🎙️ 内容生成 - 生成音频概述（播客）、视频、幻灯片、测验、抽认卡、信息图表、数据表、思维导图和学习指南。完全掌控格式、风格和输出内容。

📥 下载与导出 - 在本地下载所有生成的成品（MP3、MP4、PDF、PNG、CSV、JSON、Markdown）。支持导出至 Google Docs/Sheets。包含网页 UI 不具备的功能：批量下载、多种格式的测验/抽认卡导出、思维导图 JSON 提取。

三种使用方式

方法	适用场景
Python API	应用程序集成、异步工作流、自定义流水线
CLI	Shell 脚本、快速任务、CI/CD 自动化
Agent 集成	Claude Code、Codex、LLM Agent、自然语言自动化

功能特性

完整的 NotebookLM 覆盖

类别	功能
笔记本 (Notebooks)	创建、列出、重命名、删除
源 (Sources)	URL、YouTube、文件（PDF、文本、Markdown、Word、音频、视频、图像）、Google Drive、粘贴文本；刷新、获取指南/全文
聊天 (Chat)	提问、对话历史、自定义角色
研究 (Research)	带自动导入功能的网页和 Drive 研究 Agent（快速/深度模式）
共享 (Sharing)	公开/私有链接、用户权限（查看者/编辑者）、视图级别控制

内容生成（涵盖所有 NotebookLM Studio 类型）

类型	选项	下载格式
音频概述	4 种格式（深度解析、简要、评论、辩论），3 种时长，50 多种语言	MP3/MP4
视频概述	3 种格式（解说、简要、电影感），9 种视觉风格，另有专属 cinematic-video CLI 别名	MP4
幻灯片	详细或演讲者格式，长度可调；支持单页幻灯片修订	PDF, PPTX
信息图表	3 种方向，3 种详细程度	PNG
测验	可配置数量和难度	JSON, Markdown, HTML
抽认卡	可配置数量和难度	JSON, Markdown, HTML
报告	简报文档、学习指南、博客文章或自定义提示词	Markdown
数据表	通过自然语言自定义结构	CSV
思维导图	交互式层级可视化	JSON

超越网页 UI 的高级功能

这些功能可通过 API/CLI 使用，但未在 NotebookLM 网页界面中公开：

• 批量下载 - 一次性下载所有类型的成品
• 测验/抽认卡导出 - 获取结构化的 JSON、Markdown 或 HTML（网页 UI 仅显示交互式视图）
• 思维导图数据提取 - 为可视化工具导出层级化的 JSON
• 数据表 CSV 导出 - 将结构化表格下载为电子表格
• 幻灯片 PPTX 导出 - 下载可编辑的 PowerPoint 文件（网页 UI 仅提供 PDF）
• 幻灯片修订 - 使用自然语言提示词修改单个幻灯片
• 报告模板自定义 - 在内置格式模板上附加额外指令
• 将聊天保存为笔记 - 将问答或对话历史保存为笔记本笔记
• 源全文访问 - 获取任何源的索引文本内容
• 程序化共享 - 无需 UI 即可管理权限