📌 Skill 基础信息
- Skill 名称: notebooklm
- Skill 简称: notebooklm
- 来源: 社区第三方 (teng-lin)
- 运行宿主: Claude-Code CLI、Cursor 等支持 MCP 协议的 AI Agent 工具
- 核心定位: 提供 Google NotebookLM 的完整程序化 API 访问,支持创建笔记本、添加多格式资源、生成各类内容产物并下载,适合自动化研究和工作流场景。
🧩 内部核心组成
该 Skill 通过 CLI 工具提供完整的 NotebookLM 自动化能力:
核心命令功能
| 命令类别 | 命令名 | 功能简述 |
|---|---|---|
| 认证管理 | login | 浏览器 OAuth 认证 |
| 认证管理 | auth check | 验证认证状态 |
| 认证管理 | auth refresh | 刷新认证令牌 |
| 笔记本管理 | list | 列出所有笔记本 |
| 笔记本管理 | create | 创建新笔记本 |
| 笔记本管理 | use | 设置当前笔记本上下文 |
| 资源管理 | source add | 添加资源(URL、PDF、音视频等) |
| 内容生成 | generate | 生成各类内容产物 |
| 内容交互 | ask | 与笔记本内容对话 |
| 文件操作 | download | 下载生成的内容 |
配置文件结构
~/.notebooklm/: 主配置目录profiles/<profile>/: 多账户配置文件context.json: 当前笔记本上下文storage_state.json: 认证状态存储
🛠 安装与启用方式
前置依赖: Python 3.7+
安装步骤:
# 基础安装(包含浏览器支持)
pip install "notebooklm-py[browser]"
# 安装 Skill 到 Agent
notebooklm skill install
# 或
npx skills add teng-lin/notebooklm-py
认证配置:
# 首次使用必须认证
notebooklm login # 打开浏览器完成 Google OAuth
notebooklm list # 验证认证成功
环境变量配置:
NOTEBOOKLM_HOME: 自定义配置目录NOTEBOOKLM_PROFILE: 激活的配置文件名NOTEBOOKLM_AUTH_JSON: 内联认证 JSON
📋 标准工作流
- 初始化认证: 用户执行
notebooklm login完成 Google 账户认证 - 创建笔记本: 使用
notebooklm create创建新研究笔记本 - 添加资源: 通过
source add添加 URL、PDF、音视频等研究材料 - 内容交互: 使用
ask与内容对话或generate生成特定格式产出 - 下载结果: 通过
download命令获取生成的内容文件 - 多会话管理: 使用 profile 系统管理不同研究项目
典型用例:用户输入"创建关于人工智能的播客",Skill 自动创建笔记本、添加相关资料、生成播客脚本并下载。
⚠️ 关键限制、缺陷、注意事项
平台限制:
- 无头环境(如 Claude Cowork)需要额外配置认证文件
- Python 3.13+ 无法安装 cookies 扩展功能
Token 消耗: 内容生成和大型文档处理消耗较多 Token
生产环境适用性:
- ✅ 适合自动化研究流水线
- ❌ 不适合高频率实时交互场景
已知坑点:
- 并行工作流需要显式指定 notebook ID,避免上下文冲突
- 认证文件
storage_state.json包含敏感凭证,需妥善保管 - 不要从 main 分支安装,仅使用 PyPI 或发布标签
✅ 适用场景 & ❌ 不适合场景
适合场景:
- 学术研究和文献整理自动化
- 内容创作工作流(播客、视频脚本生成)
- 教育材料制作(测验、闪卡生成)
- 多语言内容研究和翻译
- CI/CD 环境下的自动化内容生产
不适合场景:
- 实时聊天或快速响应的对话场景
- 需要极高并发处理的研究项目
- 对延迟极其敏感的实时应用
- 无持久化存储的临时环境
如何安装
skills install --user teng-lin/notebooklm-py通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)
桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。
Claude Code(终端 CLI)
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。
VS Code(含 GitHub Copilot)
打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。
Windsurf
底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。
其他工具(ChatGPT、本地脚本等)
不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
本 Skill 涉及读取隐私 / 敏感信息(如密钥、环境变量、凭据)。安装前请确认其用途是否必要。
检测到隐私/敏感信息读取(预设模式 #11)
命中检测项
- privacy_collect
Aitishiku.com