# 用于克劳德代码的笔记本LM代理技能

> 将谷歌的笔记本LM直接集成到克劳德代码中，从您上传的文档中获取基于来源、有引用支持的答案，大幅减少幻觉。几秒钟内开始增强您的编码工作流程。

- Canonical: https://nanoskill.ai/zh/skills/notebooklm-skill
- Markdown: https://nanoskill.ai/zh/skills/notebooklm-skill.md
- Author: PleasePrompto
- Published: 2026-06-01T07:12:40.837Z
- Updated: 2026-07-23T03:32:43.424Z
- Language: zh-CN
- Source type: github
- Popularity signal: 6754

## Sources

- https://github.com/PleasePrompto/notebooklm-skill

## Install

```shell
npx skills add https://github.com/PleasePrompto/notebooklm-skill
```

## About

用于克劳德代码的笔记本LM技能将谷歌强大的笔记本LM直接集成到您的本地克劳德代码环境中，从您上传的文档中提供基于来源和引用的答案。此技能通过确保所有响应都完全来自您指定的知识库，消除了AI幻觉的常见问题。它允许克劳德以编程方式查询您的笔记本、综合信息并提供准确结果，无需手动复制粘贴，从而简化您的工作流程。

此技能专为提高效率而设计，提供智能库管理等功能，您可以在其中保存带有元数据的笔记本LM链接，使克劳德能够为您的任务智能选择最相关的来源。它包含一次性设置后的自动持久谷歌身份验证，并在您的技能文件夹内的独立隔离Python环境中运行，确保干净安装且与其他系统依赖项无冲突。

无论您是在查询车间手册以获取特定技术细节，还是基于内部文档构建复杂的代码工作流程，或者研究API规范，笔记本LM技能都能使克劳德代码成为一个高度知情的助手。它改变了您与文档交互的方式，使克劳德能够提出全面的问题、跟进更多细节并综合完整的答案，从而获得更准确的代码和研究结果。

## Key features

- **基于来源的响应**: 通过仅从您上传的文档中提供答案，显著减少 AI 幻觉，当信息不可用时表明不确定性。
- **直接集成 Claude Code**: 消除了在浏览器和编辑器之间手动复制粘贴的需要，允许 Claude 以编程方式提问并接收答案。
- **智能库管理**: 使用标签和描述保存 NotebookLM 链接，使 Claude 能够为您的特定任务自动选择最相关的笔记本。
- **自动认证**: 执行一次性 Google 登录，身份验证将在多个会话中持续存在，以便将来无缝使用。
- **自包含且隔离**: 完全在其技能文件夹内运行，具有隔离的 Python 环境，确保没有全局安装或冲突。

## Use cases

- **查询车间手册**: 快速从上传的车间手册中检索特定细节，如制动液类型、发动机机油规格或扭矩值，无需手动搜索。
- **基于可靠信息构建代码**: 根据您的文档开发复杂的工作流程或代码，通过利用 NotebookLM 的合成答案确保准确性并避免幻觉。
- **研究技术文档**: 轻松向 Claude Code 询问有关 API 文档、内部 wiki 或项目文档的问题，获得精确的、有引用的答案。

## Result preview

查看直接从笔记本LM生成的关于“最佳代理技能”的真实见解和思维导图。

![the demo of NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-demo-1.jpg)

![the demo of NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-demo-2.jpg)

![the demo of NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-demo-3.jpg)

![the demo of NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-demo-4.jpg)

## Result walkthrough

### 步骤1：安装

将技能添加到您的代理。

![a simple demonstration of the first step in using NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-step-1.jpg)

### 步骤2：查询知识库

从您的笔记本LM笔记本中提问或请求见解。

![a simple demonstration of the second step in using NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-step-2.jpg)

### 步骤3：查看结果

查看响应及其支持性引用。

![a simple demonstration of the third step in using NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-step-3.jpg)

## Skill definition

# NotebookLM Claude Code 技能

**让 [Claude Code](https://github.com/anthropics/claude-code) 直接与 NotebookLM 对话，获取仅基于您上传文档的源验证答案**

> 使用此技能，直接从 Claude Code 查询您的 Google NotebookLM 笔记本，获取 Gemini 提供的基于源、附带引用的答案。浏览器自动化、库管理、持久认证。大幅减少幻觉——答案仅来自您上传的文档。

[安装](#installation) • [快速开始](#quick-start) • [为什么选择 NotebookLM](#why-notebooklm-not-local-rag) • [工作原理](#how-it-works) • [MCP 替代方案](https://github.com/PleasePrompto/notebooklm-mcp)

---

## ⚠️ 重要：仅限本地 Claude Code

**此技能仅适用于本地 [Claude Code](https://github.com/anthropics/claude-code) 安装，不适用于 Web 界面。**

Web 界面在沙箱中运行技能，无网络访问权限，而此技能需要网络访问来进行浏览器自动化。您必须在本地机器上使用 [Claude Code](https://github.com/anthropics/claude-code)。

---

## 问题所在

当您告诉 [Claude Code](https://github.com/anthropics/claude-code) “搜索我的本地文档”时，会发生以下情况：
- **巨大的 token 消耗**：搜索文档意味着反复阅读多个文件
- **检索不准确**：搜索关键词，错过文档间的上下文和联系
- **幻觉**：找不到东西时，它会编造听起来合理的 API
- **手动复制粘贴**：不断在 NotebookLM 浏览器和编辑器之间切换

## 解决方案

此 Claude Code 技能允许 [Claude Code](https://github.com/anthropics/claude-code) 直接与 [**NotebookLM**](https://notebooklm.google/) 对话——Google 的由 Gemini 2.5 驱动的**基于源的知识库**，仅从您上传的文档中提供智能、综合的答案。

```
Your Task → Claude asks NotebookLM → Gemini synthesizes answer → Claude writes correct code
```

**不再复制粘贴**：Claude 直接提问，并在 CLI 中即时得到答案。通过自动跟进，它建立深入理解，获取具体的实现细节、边缘情况和最佳实践。

---

## 为什么选择 NotebookLM，而不是本地 RAG？

| 方式 | Token 成本 | 设置时间 | 幻觉 | 答案质量 |
|----------|------------|------------|----------------|----------------|
| **将文档喂给 Claude** | 🔴 非常高（多次文件读取） | 即时 | 会 - 填补空缺 | 不稳定的检索 |
| **网页搜索** | 🟡 中等 | 即时 | 高 - 来源不可靠 | 时好时坏 |
| **本地 RAG** | 🟡 中等-高 | 数小时（嵌入、分块） | 中等 - 检索间隙 | 取决于设置 |
| **NotebookLM 技能** | 🟢 最小 | 5 分钟 | **最小** - 仅基于源 | 专家级综合 |

### 是什么让 NotebookLM 更胜一筹？

1. **由 Gemini 预处理**：上传一次文档，立即获得专家知识
2. **自然语言问答**：不仅仅是检索——真正的理解和综合
3. **多源关联**：连接 50+ 文档间的信息
4. **引用支持**：每个答案都包含源引用
5. **无需基础设施**：不需要向量数据库、嵌入或分块策略

---

## 安装

### 有史以来最简单的安装：

```bash
# 1. Create skills directory (if it doesn't exist)
mkdir -p ~/.claude/skills

# 2. Clone this repository
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

# 3. That's it! Open Claude Code and say:
"What are my skills?"
```

当您首次使用此技能时，它会自动：
- 创建隔离的 Python 环境（`.venv`）
- 安装所有依赖项，包括 **Google Chrome**
- 使用 Chrome（而非 Chromium）设置浏览器自动化以获得最大可靠性
- 所有内容都包含在技能文件夹中

**注意：** 设置使用真实的 Chrome 而非 Chromium，以实现跨平台可靠性、一致的浏览器指纹识别以及更好地对抗 Google 服务的检测

---

## 快速开始

### 1. 检查您的技能

在 Claude Code 中说：
```
"What skills do I have?"
```

Claude 将列出您可用的技能，包括 NotebookLM。

### 2. 使用 Google 认证（一次性）

```
"Set up NotebookLM authentication"
```
*一个 Chrome 窗口会打开 → 使用您的 Google 账户登录*

### 3. 创建您的知识库

前往 [notebooklm.google.com](https://notebooklm.google.com) → 创建笔记本 → 上传您的文档：
- 📄 PDF、Google 文档、markdown 文件
- 🔗 网站、GitHub 仓库
- 🎥 YouTube 视频
- 📚 每个笔记本多个来源

分享：**⚙️ 分享 → 任何知道链接的人 → 复制**

### 4. 添加到您的库

**选项 A：让 Claude 自行处理（智能添加）**
```
"Query this notebook about its content and add it to my library: [your-link]"
```
Claude 将自动查询笔记本以发现其内容，然后使用适当的元数据添加它。

**选项 B：手动添加**
```
"Add this NotebookLM to my library: [your-link]"
```
Claude 会要求提供名称和主题，然后保存供将来使用。

### 5. 开始研究

```
"What does my React docs say about hooks?"
```

Claude 会自动选择合适的笔记本，并直接从 NotebookLM 获取答案。

---

## 工作原理

这是一个 **Claude Code 技能**——一个包含指令和脚本的本地文件夹，Claude Code 可以在需要时使用。与 [MCP 服务器版本](https://github.com/PleasePrompto/notebooklm-mcp) 不同，它直接在 Claude Code 中运行，无需单独的服务器。

### 与 MCP 服务器的主要区别

| 特性 | 此技能 | MCP 服务器 |
|---------|------------|------------|
| **协议** | Claude 技能 | Model Context Protocol |
| **安装** | 克隆到 `~/.claude/skills` | `claude mcp add ...` |
| **会话** | 每个问题新开浏览器 | 持久聊天会话 |
| **兼容性** | 仅限本地 Claude Code | Claude Code、Codex、Cursor 等 |
| **语言** | Python | TypeScript |
| **分发** | Git 克隆 | npm 包 |

### Architecture

```
~/.claude/skills/notebooklm/
├── SKILL.md              # Instructions for Claude
├── scripts/              # Python automation scripts
│   ├── ask_question.py   # Query NotebookLM
│   ├── notebook_manager.py # Library management
│   └── auth_manager.py   # Google authentication
├── .venv/                # Isolated Python environment (auto-created)
└── data/                 # Local notebook library
```

当您提到 NotebookLM 或发送笔记本 URL 时，Claude 会：
1. 加载技能指令
2. 运行适当的 Python 脚本
3. 打开浏览器并提问
4. 直接将答案返回给您
5. 使用这些知识帮助您完成任务

---

## 核心功能

### **基于源的响应**
NotebookLM 通过仅从您上传的文档中回答，显著减少了幻觉。如果信息不可用，它会表明不确定性，而不是编造内容。

### **直接集成**
无需在浏览器和编辑器之间复制粘贴。Claude 以编程方式提问和接收答案。

### **智能库管理**
使用标签和描述保存 NotebookLM 链接。Claude 会自动为您的任务选择合适的笔记本。

### **自动认证**
一次 Google 登录，后续会话中认证持久有效。

### **自包含**
一切都在技能文件夹中运行，拥有隔离的 Python 环境。无需全局安装。

### **类人自动化**
使用逼真的打字速度和交互模式以避免检测。

---

## 常用命令

| 您说的话 | 发生的情况 |
|--------------|--------------|
| *“设置 NotebookLM 认证”* | 打开 Chrome 进行 Google 登录 |
| *“将 [链接] 添加到我的 NotebookLM 库”* | 保存带有元数据的笔记本 |
| *“显示我的 NotebookLM 笔记本”* | 列出所有保存的笔记本 |
| *“询问我的 API 文档关于 [主题]”* | 查询相关笔记本 |
| *“使用 React 笔记本”* | 设置活动笔记本 |
| *“清除 NotebookLM 数据”* | 全新开始（保留库） |

---

## 实际示例

### 示例 1：车间手册查询

**用户提问**：“检查我的 Suzuki GSR 600 车间手册，获取制动液类型、发动机机油规格和后桥扭矩。”

**Claude 自动执行**：
- 认证 NotebookLM
- 针对每个规格提出全面问题
- 当提示“这是你需要知道的一切吗？”时进行跟进
- 提供准确的规格：DOT 4 制动液、SAE 10W-40 机油、100 N·m 后桥扭矩

![NotebookLM 聊天示例](https://file.nanoskill.ai/example_notebookchat.png)

### 示例 2：无幻觉构建

**你**：“我需要构建一个用于 Gmail 垃圾邮件过滤的 n8n 工作流。使用我的 n8n 笔记本。”

**Claude 的内部过程：**
```
→ 加载 NotebookLM 技能
→ 激活 n8n 笔记本
→ 提出带有跟进问题的全面问题
→ 从多个查询中综合完整答案
```

**结果**：第一次尝试即成功的工作流，无需调试幻觉 API。

---

## 技术细节

### 核心技术
- **Patchright**：浏览器自动化库（基于 Playwright）
- **Python**：此技能的实现语言
- **隐身技术**：类人打字和交互模式

注意：MCP 服务器使用相同的 Patchright 库，但通过 TypeScript/npm 生态系统。

### 依赖项
- **patchright==1.55.2**：浏览器自动化
- **python-dotenv==1.0.0**：环境配置
- 首次使用时自动安装在 `.venv` 中

### 数据存储

所有数据都存储在技能目录本地：

```
~/.claude/skills/notebooklm/data/
├── library.json       - Your notebook library with metadata
├── auth_info.json     - Authentication status info
└── browser_state/     - Browser cookies and session data
```

**重要安全提示：**
- `data/` 目录包含敏感的身份验证数据和个人笔记本
- 它通过 `.gitignore` 自动排除在 git 之外
- 切勿手动提交或分享 `data/` 目录的内容

### 会话模型

与 MCP 服务器不同，此技能使用**无状态模型**：
- 每个问题打开一个新浏览器
- 提问并获取答案
- 添加跟进提示，鼓励 Claude 提出更多问题
- 立即关闭浏览器

这意味着：
- 无持久聊天上下文
- 每个问题独立
- 但您的笔记本库保持不变
- **跟进机制**：每个答案都包含“这是你需要知道的一切吗？”，以提示 Claude 提出全面的跟进问题

对于多步骤研究，Claude 会在需要时自动提出跟进问题。

---

## 局限性

### 技能特定
- **仅本地 Claude Code** - 无法在 Web UI 中运行（沙箱限制）
- **无会话持久性** - 每个问题独立
- **无跟进上下文** - 无法引用“上一个答案”

### NotebookLM
- **速率限制** - 免费层级有每日查询限制
- **手动上传** - 您必须先将文档上传到 NotebookLM
- **共享要求** - 笔记本必须公开共享

---

## 常见问题

**为什么在 Claude Web UI 中无法使用？**
Web UI 在无网络访问的沙箱中运行技能。浏览器自动化需要网络访问才能访问 NotebookLM。

**这与 MCP 服务器有何不同？**
这是一个更简单的、基于 Python 的实现，直接作为 Claude 技能运行。MCP 服务器功能更丰富，具有持久会话，并可与多种工具（Codex、Cursor 等）配合使用。

**我能否同时使用此技能和 MCP 服务器？**
可以！它们满足不同的需求。使用技能实现快速 Claude Code 集成，使用 MCP 服务器实现持久会话和多工具支持。

**如果 Chrome 崩溃怎么办？**
运行：`“清除 NotebookLM 浏览器数据”`，然后重试。

**我的 Google 账户安全吗？**
Chrome 在您的本地机器上运行。您的凭据永远不会离开您的计算机。如有顾虑，请使用专用的 Google 账户。

---

## 故障排除

### 技能未找到
```bash
# Make sure it's in the right location
ls ~/.claude/skills/notebooklm/
# Should show: SKILL.md, scripts/, etc.
```

### 认证问题
说：`“重置 NotebookLM 认证”`

### 浏览器崩溃
说：`“清除 NotebookLM 浏览器数据”`

### 依赖项问题
```bash
# Manual reinstall if needed
cd ~/.claude/skills/notebooklm
rm -rf .venv
python -m venv .venv
source .venv/bin/activate  # or .venv\\Scripts\\activate on Windows
pip install -r requirements.txt
```

---

## 免责声明

此工具自动化与 NotebookLM 的浏览器交互，以提高您的工作流效率。然而，有几个友好的提醒：

**关于浏览器自动化：**
虽然我内置了人性化功能（逼真的打字速度、自然延迟、鼠标移动），以使自动化行为更自然，但我无法保证 Google 不会检测或标记自动化使用。我建议使用专用的 Google 账户进行自动化，而不是您的主账户——就像网络爬虫一样：可能没问题，但安全总比后悔好！

**关于 CLI 工具和 AI 代理：**
像 Claude Code、Codex 和类似的 AI 驱动的助手非常强大，但它们可能会犯错。请谨慎并注意使用：
- 在提交或部署之前始终审查更改
- 先在安全环境中测试
- 备份重要工作
- 记住：AI 代理是助手，不是万无一失的神谕

我为自己构建了这个工具，因为我厌倦了在 NotebookLM 和编辑器之间复制粘贴。我分享它是希望它也能帮助其他人，但对于可能出现的任何问题、数据丢失或账户问题，我不能承担责任。请自行决定和判断使用。

话虽如此，如果您遇到问题或有疑问，请随时在 GitHub 上提出问题。我很乐意帮助排除故障！

---

## 致谢

此技能的灵感来自我的 [**NotebookLM MCP 服务器**](https://github.com/PleasePrompto/notebooklm-mcp)，并作为一个 Claude Code 技能提供了另一种实现：
- 两者都使用 Patchright 进行浏览器自动化（MCP 使用 TypeScript，技能使用 Python）
- 技能版本直接在 Claude Code 中运行，无需 MCP 协议
- 无状态设计，针对技能架构进行了优化

如果您需要：
- **持久会话** → 使用 [MCP 服务器](https://github.com/PleasePrompto/notebooklm-mcp)
- **多工具支持**（Codex、Cursor） → 使用 [MCP 服务器](https://github.com/PleasePrompto/notebooklm-mcp)
- **快速 Claude Code 集成** → 使用此技能

---

## 总结

**没有此技能**：在浏览器中使用 NotebookLM → 复制答案 → 粘贴到 Claude → 复制下一个问题 → 返回浏览器……

**有了此技能**：Claude 直接研究 → 即时获得答案 → 编写正确的代码

停止复制粘贴的舞蹈。开始在 Claude Code 中直接获得准确、有依据的答案。

```bash
# Get started in 30 seconds
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# Open Claude Code: "What are my skills?"
```

---

作为我的 [NotebookLM MCP 服务器](https://github.com/PleasePrompto/notebooklm-mcp) 的 Claude Code 技能改编而构建

用于在 Claude Code 中直接进行基于源、基于文档的研究

## FAQ

### 什么是用于 Claude Code 的 NotebookLM 技能？

NotebookLM 技能允许 Claude Code 直接与 Google 的 NotebookLM（一个基于来源的知识库）进行交互。它使 Claude 能够仅从您上传的文档中获取答案，从而减少幻觉并提高准确性。

### 为什么此 NotebookLM 技能仅适用于本地 Claude Code 安装？

此技能需要网络访问权限，以便通过浏览器自动化与 NotebookLM 进行交互。Claude 网页 UI 在沙盒环境中运行技能，没有网络访问权限，因此无法在此环境中运行该技能。您必须使用本地 Claude Code 安装。

### 与直接将文档提供给 Claude 相比，此技能如何减少幻觉？

此技能不直接提供原始文档，而是利用 NotebookLM，它使用 Gemini 预处理您的文档。NotebookLM 提供自然语言问答和多源关联，合成出有引用支持且仅基于您上传内容的专家答案。

### 使用此技能时，我的 Google 帐户安全吗？

是的，Chrome 在您的机器上本地运行，您的凭据永远不会离开您的计算机。如果您有安全顾虑，建议使用专用的 Google 帐户进行自动化操作，类似于网页抓取的最佳实践。

### 此技能与 NotebookLM MCP 服务器之间的主要区别是什么？

此技能是一个更简单的、基于 Python 的实现，旨在快速集成 Claude Code，作为无状态模型的 Claude 技能直接运行。MCP 服务器功能更丰富，提供持久会话和多工具支持（例如 Codex、Cursor），使用 TypeScript。

### 如何使用此技能将 NotebookLM 添加到我的库中？

您可以使用诸如“将此 NotebookLM 添加到我的库：\[your-link\]”或“查询此笔记本的内容并将其添加到我的库：\[your-link\]”之类的命令，让 Claude 自动添加和分类您的 NotebookLM 来源。