📚 Web搜索 进阶 📦 teng-lin

notebooklm-py

Google NotebookLM 非官方 Python API 与 Agent Skill——通过 Python/CLI/Agent 实现 NotebookLM 全功能编程访问

8 /10 ★★★★☆
#开源免费#搜索#办公#API#Skill系统

📊 评分明细

📦 打包完整度
2 2 / 2.5
🎯 实用性
2 2 / 2.5
📖 文档清晰度
1.6 1.6 / 2
👥 社区影响力
1.2 1.2 / 1.5
🔗 集成度
1.2 1.2 / 1.5

🎯 适用场景

开源免费搜索办公APISkill系统

这是什么？

notebooklm-py 是 teng-lin 开发的 Google NotebookLM 非官方 Python API。它提供了 NotebookLM 的完整编程访问能力——包括 Web UI 没有暴露的功能——通过 Python SDK、CLI 命令行和 AI Agent Skill 三种方式使用。

17.7k Stars、2.4k Forks，MIT 协议开源。Python 编写，支持 Claude Code、Codex、OpenClaw 等 Agent 平台。你可以用 Python 脚本批量创建笔记本、上传文档、生成播客，也可以让 AI Agent 直接调用 NotebookLM 做研究和内容创作。

如果你需要将 NotebookLM 集成到自动化工作流中，或者希望 Agent 自主使用 NotebookLM 做深度研究，notebooklm-py 是必备工具。

准备工作

  • Python 3.9+ 环境
  • Google 账号（用于 NotebookLM 认证）
  • Claude Code / Codex 等 Agent（可选，用于 Agent 模式）

三步快速上手

第一步：安装

pip install notebooklm-py

第二步：认证

# CLI 方式登录
notebooklm auth login

按提示完成 Google 账号认证，token 会保存在本地。

第三步：使用

# CLI 模式：创建笔记本并上传文档
notebooklm create "我的研究笔记"
notebooklm upload --notebook "我的研究笔记" --file research.pdf

# Python 模式：
python -c "
from notebooklm import NotebookLM
nlm = NotebookLM()
nb = nlm.create_notebook('我的研究笔记')
nb.upload('research.pdf')
print(nb.generate_summary())
"

在 Agent 中加载 Skill 后，可以直接让 Agent 调用 NotebookLM：

用 NotebookLM 分析这份 PDF 并生成播客脚本

常见踩坑

  1. Google 认证：首次使用需要浏览器完成 OAuth 认证，CLI 环境需要能打开浏览器。

  2. 速率限制：非官方 API 可能触发 Google 的速率限制，大量操作时建议加延时。

  3. 功能覆盖：覆盖 NotebookLM 核心功能，但部分最新特性（如新 UI 功能）可能滞后。

  4. 非官方性质：这是社区维护的非官方 API，Google 可能随时更改接口导致不可用。

  5. Agent 模式：Agent Skill 需要配合 Claude Code 等平台使用，不是独立运行。

FAQ

Q1: 和官方 NotebookLM 有什么区别？

A1: notebooklm-py 提供编程接口，可以批量操作、自动化集成。官方 NotebookLM 是 Web 应用，需要手动操作。编程接口还能访问 Web UI 没有暴露的功能。

Q2: 需要付费吗？

A2: 不需要。notebooklm-py 是开源免费工具，但 NotebookLM 本身需要 Google 账号（免费）。

Q3: 支持哪些功能？

A3: 创建笔记本、上传文档（PDF/网页/YouTube）、生成摘要、问答、Audio Overview 播客生成等。具体功能列表见官方文档。

Q4: 开源协议是什么？

A4: MIT 协议，可自由使用和修改。

Q5: 适合什么场景？

A5: 批量文档处理、自动化研究流程、Agent 驱动的深度研究、内容创作流水线、播客自动生成等。

参考链接

📊 评分与标签

评分说明

总分 8.0/10 · P_优选

📊 可观测社区指标（数据核验日期：2026-07-14）

📦 可安装性 2.3/2.5

  • pip install notebooklm-py 一键安装，标准 Python 包管理方式，安装体验极简
  • 也可 clone 后复制 SKILL.md 到 skills 目录作为 Agent Skill 使用，支持多种安装路径
  • 需要 Google 账号认证和 NotebookLM 访问权限，非完全零配置
  • 对比 AI Research Skills Library：AI Research Skills Library 提供 npx 一键安装，notebooklm-py 的 pip 安装同样简洁
  • 对比 nanoclaw：nanoclaw 需要 Docker 环境和 11 个渠道凭证配置，notebooklm-py 的安装复杂度明显更低

🎯 实用性 2.2/2.5

  • 提供 NotebookLM 的完整编程访问能力，包括 Web UI 未暴露的功能，填补了 NotebookLM 缺少官方 API 的空白
  • 三种使用方式（Python API/CLI/Agent Skill）覆盖不同场景：编程集成、命令行操作、Agent 自动化
  • 非官方 API，可能随 NotebookLM 更新而变化，存在兼容性风险
  • 对比 Google NotebookLM 官方：官方仅有 Web UI，不提供 API，notebooklm-py 是唯一提供编程访问的方案
  • 对比 Perplexity API：Perplexity 提供官方 API 用于 AI 搜索，notebooklm-py 的独家性使其在 NotebookLM 生态中无可替代

📖 文档质量 1.6/2.0

  • README 包含安装说明、Python API 示例、CLI 用法和 Agent Skill 使用方式，覆盖三种使用模式
  • SKILL.md 文件为 Agent 提供结构化使用指南
  • 缺少独立文档站点，API 参考文档不够详尽，高级用法示例较少
  • 对比 Understand-Anything：Understand-Anything 的文档同样以 README 为主，两者文档水平相当
  • 对比 Perplexity 文档：Perplexity 有完整的 API 参考文档和交互式 Playground，notebooklm-py 的文档体系相对简陋

👥 社区活跃 1.0/1.5

🔗 兼容性 0.9/1.5

评分依据可追溯至公开来源，每项分数均有明确理由和数据支撑。

🏷️ 标签说明

📋 来源与核验记录

  • ✅ GitHub API 已验证: teng-lin/notebooklm-py — 17,717 Stars, 2,397 Forks, MIT License
  • ⚠️ 未验证: GitHub 页面 页面核验 失败（agent-browser 二进制缺失），已通过 GitHub API 替代验证
  • ⚠️ 间接来源: Google NotebookLM/Perplexity 的功能描述 — 基于官方文档和公开信息
  • ❌ 死链: 无