t
teng-lin/notebooklm-py
Unofficial Python API and agentic skill for Google NotebookLM. Full programmatic access to NotebookLM's features—including capabilities the web UI doesn't expose—via Python, CLI, and AI agents like Claude Code, Codex, and OpenClaw.
agentic-skillapiclaudeclaude-skillsgoogle-notebooklmnotebooklmnotebooklm-apinotebooklm-skillopenclaw-skillspodcast-generatorpythonpython-apisdkskills
PythonMIT创建于 2026/1/7更新于 今天
README
由 Gemini 翻译整理
notebooklm-py
一个功能完备的 NotebookLM Skill 及非官方 Python API。 通过 Python、CLI 以及 Claude Code、Codex 和 OpenClaw 等 AI Agent，实现对 NotebookLM 功能的全面编程访问（包括 Web UI 未公开的隐藏功能）。
源码与开发:
⚠️ 非官方库 - 使用风险自担
本库使用了未公开的 Google API，这些 API 可能会在不通知的情况下发生变更。
- 与 Google 无关联 - 这是一个社区项目
- API 可能中断 - Google 随时可能更改内部端点
- 受速率限制 - 高频使用可能会受到限制
最适用于原型开发、研究和个人项目。调试技巧请参阅 Troubleshooting。
您可以构建的内容
🤖 AI Agent 工具 - 将 NotebookLM 集成到 Claude Code、Codex 及其他 LLM Agent 中。随附用于 GitHub 的根 NotebookLM skill 以及 npx skills add 发现功能，支持 Claude Code 和 .agents skill 目录的本地 notebooklm skill install，以及 AGENTS.md 中提供的仓库级 Codex 指南。
📚 研究自动化 - 批量导入源（URL、PDF、YouTube、Google Drive），运行带有自动导入功能的 Web/Drive 研究查询，并以编程方式提取洞察。构建可重复的研究工作流。
🎙️ 内容生成 - 生成音频概览（播客）、视频、幻灯片、测验、抽认卡、信息图、数据表、思维导图和学习指南。完全控制格式、风格和输出。
📥 下载与导出 - 在本地下载所有生成的工件（MP3、MP4、PDF、PNG、CSV、JSON、Markdown）。支持导出到 Google Docs/Sheets。Web UI 不具备的功能：批量下载、多种格式的测验/抽认卡导出、思维导图 JSON 提取。
三种使用方式
| 方法 | 最佳用途 |
|---|---|
| Python API | 应用程序集成、异步工作流、自定义流水线 |
| CLI | Shell 脚本、快速任务、CI/CD 自动化 |
| Agent 集成 | Claude Code、Codex、LLM Agent、自然语言自动化 |
特性
完整的 NotebookLM 覆盖
| 类别 | 功能 |
|---|---|
| 笔记本 (Notebooks) | 创建、列出、重命名、删除 |
| 源 (Sources) | URL、YouTube、文件（PDF、文本、Markdown、Word、EPUB、音频、视频、图像）、Google Drive、粘贴文本；刷新、获取指南/全文 |
| 对话 (Chat) | 问题、对话历史记录、自定义角色 (Personas) |
| 研究 (Research) | 带有自动导入功能的 Web 和 Drive 研究 Agent（快速/深度模式） |
| 共享 (Sharing) | 公开/私有链接、用户权限（查看者/编辑者）、视图级别控制 |
内容生成（涵盖所有工件类型）
| 类型 | 选项 | 下载格式 |
|---|---|---|
| 音频概览 | 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 |
超越 Web UI 的能力
以下功能可通过 API/CLI 使用，但未在 NotebookLM 的 Web 界面中提供：
- 批量下载 - 一次性下载所有类型的工件
- 测验/抽认卡导出 - 获取结构化的 JSON、Markdown 或 HTML（Web UI 仅提供交互式视图）
- 思维导图数据提取 - 导出用于可视化工具的层级 JSON
- 数据表 CSV 导出 - 将结构化表格下载为电子表格
- 幻灯片转 PPTX - 下载可编辑的 PowerPoint 文件（Web UI 仅提供 PDF）
- 幻灯片修订 - 使用自然语言提示词修改单个幻灯片
- 报告模板自定义 - 在内置格式模板中附加额外指令
- 将聊天保存为笔记 - 将问答或对话历史保存为笔记本笔记
- 源全文访问 - 检索任何源的已索引文本内容
- 程序化共享 - 无需通过 UI 即可管理权限
- 多账户切换 - 方便管理多个 Google 账户下的笔记本