谷歌笔记非官方接口开源

GitHub精选
谷歌笔记非官方接口开源

NotebookLM 网页端不让批量导出音频、不开放 PPTX 下载、思维导图只能在浏览器里点。teng-lin 直接撬开 Google 的内部接口写了 notebooklm-py,把网页能做和不能做的功能全打成 Python API + CLI + Agent skill。仓库 14.4k stars,许可证 MIT。

它把 NotebookLM 拆成 SDK,连 Claude Code 都能直接调

NotebookLM 是 Google 给笔记打 LLM 上下文用的产品,今年靠 Audio Overview 出圈,但它的 API 一直没开放。作者 teng-lin 用 Playwright 抓登录态、再调内部 RPC,把这一整套未公开接口封成 Python 包:

pip install "notebooklm-py[browser]"
playwright install chromium
notebooklm login

登录后能干的事按类别分:notebook 增删改查;source 支持 URL、YouTube、PDF、Word、EPUB、音视频、Google Drive、纯文本;chat 带历史和自定义 persona;research agent 会自动开 web 或 drive 检索并把结果导入;sharing 能脚本化设置 viewer/editor 权限。

真正值得抄作业的是它把”网页端做不到的事”列了一个清单

README 列了 8 条网页端不开放、API 端能做的能力:批量下载所有产物;quiz/flashcard 能拿 JSON、Markdown、HTML(网页端只给交互式);mind map 拿 JSON 数据;data table 直接 CSV;slide deck 能下 PPTX 而不只是 PDF;slide 单页改写;report 模板可追加自定义指令;source 全文索引可直接读取。

对于做研究自动化的人来说,最后两条意义最大——以前要一份份点 NotebookLM 网页端的 share 链接复制内容,现在一条 notebooklm metadata –json 就把整个 notebook 的元数据和 source 拉下来。

Agent 集成是这个项目的另一只翅膀

teng-lin 没把它做成单纯的 Python 库,而是顺手把 SKILL.md 和 AGENTS.md 一起塞进了仓库根目录。Claude Code 用户跑一条 notebooklm skill install,skill 就被装到 ~/.claude/skills/notebooklm,agent 自动学会调 NotebookLM;Codex 用户读 AGENTS.md 拿到 RPC 调用约定。

npx 通道也开了:

npx skills add teng-lin/notebooklm-py

这意味着把 NotebookLM 接入研究流水线只剩两步——装包 + 让 agent 学会喊它。

但 README 第一段就用大字写了警告

“⚠️ Unofficial Library – Use at Your Own Risk”。Google 没打过招呼,内部接口随时可能被改;账号可能因频繁调用被风控。作者列出三条免责:跟 Google 没关系、API 可能突然失效、heavy usage 会被限流。所以这工具适合做原型、个人项目、研究批处理;想搭进生产业务线就别想了。

我看这种项目的活法逻辑,跟早年 youtube-dl 很像——只要 Google 不亲自下场封端,一群刚需用户就会让它一直更新。14.4k stars 撑两年没问题,但是哪天 Google 把 NotebookLM 内部 RPC 大改一次,作者就得连夜复刻。


参考链接