SkillsScout
CONTENT-KNOWLEDGE ／ 内容创作与知识管理

notebooklm-py

收录日期 2026-07-17·来源仓库 ↗·2026-07-22 修订
受欢迎程度
9
可用程度与相关性
9
安全性
8
8.7SCOUT SCORE

一、基本信息

项目 内容 数据来源
正式名称 notebooklm-py GitHub 独立仓库名
作者/维护者 Teng Lin（个人开发者，GitHub 用户 teng-lin） LICENSE 文件版权声明 + GitHub API
来源链接 https://github.com/teng-lin/notebooklm-py —
许可证 MIT GitHub API + LICENSE 文件
GitHub Stars / Forks 17,858 / 2,407 GitHub API 实测（2026-07-17）
最新版本 v0.7.3（2026-06-30 发布） GitHub Releases API，与 PyPI 最新稳定版一致（PyPI 另有 0.8.0 alpha/beta 预发布）
安装方式 uv tool install "notebooklm-py[browser]" / pipx install / pip install；技能安装 notebooklm skill install 或 npx skills add teng-lin/notebooklm-py 官方 README + SKILL.md

二、功能介绍与亮点

notebooklm-py 是 Google NotebookLM 的非官方 Python API + Agent Skill，通过还原网页 UI 未开放的内部接口，把 NotebookLM 变成可被脚本与 Agent 编排的基础设施。核心能力：

亮点：PyPI 正式发布 + CI 测试徽章齐备；GitHub Trendshift 趋势仓库；近日仍有代码提交，维护活跃；README 收录多篇第三方文章与视频教程，显示已形成“零 token 研究卸载”等社区使用模式。

三、适用场景

固定分类：内容创作与知识管理

面向需要用 Claude Code / Codex 处理大量资料做研究、写作与知识沉淀的开发者与知识工作者：把几十份 PDF/网页/视频丢进 NotebookLM 做“零 Agent token 成本”的深度阅读，再取回播客、报告、测验、思维导图等成品；也适合搭建长期“项目大脑”笔记本，供 coding agent 在写代码前查询带引用的背景知识。

四、跨 Agent 兼容性

Agent 结论 依据
Claude Code 原生支持 notebooklm skill install 直接安装进 ~/.claude/skills；提供 MCP Server 供 Claude Desktop/Code 调用
Codex 原生支持 仓库自带 AGENTS.md 提供 Codex 专用指引，README 将 Codex 列为一等公民场景
OpenClaw 支持 README 明确列出 OpenClaw 为受支持 Agent，且收录真实案例：“OpenClaw 驱动该库抓取 docs.openclaw.ai 全站 524 页并去重至 269 份干净源”
Hermes Agent 未验证 已抓取材料（README、SKILL.md）均未提及，未为此单独搜索

五、推荐理由

notebooklm-py 把 Google NotebookLM 变成可编程基础设施，让 Claude Code / Codex 等 Agent 能以接近零 token 成本调用 Gemini 的深度阅读与多形态生成能力，并批量导出网页 UI 不开放的产物格式——是目前“Agent + 云端研究引擎”这一组合里生态认可度最高、覆盖面最全的桥接工具。

六、评分

维度 分数 说明
受欢迎程度 9 17,858 stars；GitHub Trendshift 趋势仓库；多篇独立博客/X 帖子/YouTube 视频独立报道使用案例
可用性 9 uv tool/pipx/pip 一条命令安装；PyPI 正式发布 + CI 测试徽章；文档含安装指南、CLI Reference、Python API、故障排查；近日仍有提交，维护极活跃；核心功能无付费依赖（复用用户自有 Google 账号）
安全性 8 见下方安全检查清单
综合评分 8.7 三项均值

安全检查清单：

检查项 结果
① Shell 命令与权限范围 本地通过 Playwright 驱动浏览器完成一次性 OAuth 登录及后续接口调用，权限范围限定在项目自身流程内，代码开源可审计
② 运行时联网外发 仅与 NotebookLM/Google 官方域名通信，未发现向未声明第三方服务器外发数据
③ API Key / 凭据 需要用户 Google 账号登录态（浏览器 cookies 或“master token”），通过 Google 官方 OAuth 网页完成，登录态存储在本地 ~/.notebooklm/，存储位置与格式文档中有明确说明
④ 可疑指令排查 已抓取 README、SKILL.md 全文，未发现越权操作、提示词注入或混淆代码迹象
⑤ 作者/组织信誉 个人维护者，非官方机构出品，但项目透明度高：仓库首段即声明“非官方、使用未公开接口、后果自负”，测试覆盖齐全，多篇独立第三方文章佐证
⑥ License MIT，权属清晰
⑦ 最近维护 2026-07-17 仍有提交，维护活跃

因需托管用户真实 Google 账号登录态，未达“无外联/纯提示词”的 9-10 档；但代码执行范围明确可审计、外联目标透明、License 清晰，且对“非官方接口”风险有清晰前置披露，对照 7-8 档取 8 分。

七、跟同类 Skills 相比的优势

对比对象（Stars） 定位 与本 skill 的差异
notebooklm-py（17.8k） NotebookLM 全量 API + 多 Agent 桥接 唯一把 NotebookLM 私有能力（播客、思维导图、批量结构化导出）系统性开放给 Agent 编排的项目
claude-obsidian（AgriciDaniel，9.5k） 本地 Obsidian 知识图谱自组织“第二大脑” 纯本地笔记整理与关联，不依赖云端 NotebookLM 的深度阅读/多形态生成能力，二者可组合使用而非替代
oh-story-claudecode（4.2k） 中文网文写作全流程 skill 包 聚焦小说创作单一垂类（扫榜、拆文、写作、去 AI 味），不做通用资料研究或多形态内容生成
md2wechat-skill（3.3k） Markdown 转微信公众号排版发布 只解决“排版发布”这一环节，不涉及资料研究或内容生成，且缺失明确开源许可证

核心差异化：上述同类项目多聚焦本地笔记整理或单一垂直内容创作，notebooklm-py 是其中唯一把 NotebookLM 这个云端“零 token 研究引擎”系统性接入 Agent 工作流、并能批量取回结构化产物的项目，功能覆盖面与“反哺 Agent”的深度明显领先。

八、用户评价

该技能目前可查到的具名第三方评价仅有一条：

  1. pradeep00271（Medium 专栏文章《Every software project needs a project brain》）：认为该库让团队能够“从脚本、CLI 或 AI 编码工作流中查询 NotebookLM”，对内部工作流、原型开发与 Agent 集成场景有实用价值；同时提醒这是依赖未公开接口的非官方库，企业采用时应保持谨慎。

九、其他补充

官方 README 还列出多篇第三方使用记录（X 帖子、YouTube 教程等），显示社区已形成“零 token 研究卸载”等具体用法，但均仅见于摘要、未逐一抓取验证，不计入第八章评价，仅作背景参考。

十、安装使用方式

推荐安装（CLI，覆盖 Claude Code / Codex / OpenClaw）：

uv tool install "notebooklm-py[browser]"   # 或 pipx install "notebooklm-py[browser]"
notebooklm login                            # 首次运行自动下载 Chromium 并完成 Google 登录
notebooklm auth check --test --json         # 验证：期望返回 "status": "ok"

作为库嵌入（无需 Playwright/Chromium）：

uv add notebooklm-py   # 或：pip install notebooklm-py

Agent Skill 安装：

notebooklm skill install          # 安装进 ~/.claude/skills 与 ~/.agents/skills
# 或
npx skills add teng-lin/notebooklm-py

安装后注意事项：首次使用必须完成一次交互式 Google 登录（或用 --browser-cookies 复用已登录浏览器会话、或配置 master-token）；无显示的沙箱环境（如 Claude Cowork）需先在有显示的机器登录一次，再把生成的 storage_state.json 带入沙箱复用；无需重启 Agent，安装完成即可通过自然语言或 /notebooklm 触发。

十一、注意事项