NotebookLM Claude Code Skill：让 Claude 直接与 NotebookLM 对话
NotebookLM Claude Code Skill：让 Claude 直接与 NotebookLM 对话
GitHub: github.com/PleasePrompto/notebooklm-skill
功能：让 Claude Code 直接与 Google NotebookLM 交互，基于上传的文档获取准确答案
⚠️ 重要提示：仅支持本地 Claude Code
此 Skill 只能在本地安装的 Claude Code 中使用，网页版不支持。
网页版在沙盒中运行 Skill，没有网络访问权限，而此 Skill 需要浏览器自动化来访问 NotebookLM。
💡 解决的问题
使用 Claude Code 开发时，经常需要查阅项目文档或技术手册：
| 传统方式问题 | 说明 |
|---|---|
| 🔴 Token 消耗巨大 | 搜索文档意味着反复读取多个文件 |
| 🔴 检索不准确 | 关键词搜索，遗漏上下文和文档间的关联 |
| 🔴 幻觉问题 | 找不到内容时编造看似合理的 API |
| 🔴 手动复制粘贴 | 在 NotebookLM 浏览器和编辑器之间反复切换 |
解决方案： 让 Claude Code 直接与 NotebookLM 对话，无需离开命令行！
🎯 为什么用 NotebookLM，而不是本地 RAG？
| 方案 | Token 成本 | 设置时间 | 幻觉问题 | 回答质量 |
|---|---|---|---|---|
| 直接喂文档给 Claude | 🔴 很高（多次文件读取） | 即时 | 是 — 填补空白 | 检索不稳定 |
| 网络搜索 | 🟡 中等 | 即时 | 高 — 来源不可靠 | 时好时坏 |
| 本地 RAG | 🟡 中高 | 数小时（嵌入、分块） | 中等 — 检索缺口 | 取决于设置 |
| NotebookLM Skill | 🟢 极少 | 5 分钟 | 极少 — 仅基于来源 | 专家级综合 |
NotebookLM 的优势
- ✅ Gemini 预处理 — 一次上传文档，获得即时专家知识
- ✅ 自然语言问答 — 不仅是检索，而是真正的理解和综合
- ✅ 多源关联 — 跨 50+ 文档连接信息
- ✅ 引用支持 — 每个回答都包含来源引用
- ✅ 无基础设施 — 无需向量数据库、嵌入或分块策略
🚀 安装
最简单安装方式
# 1. 创建 skills 目录（如果不存在）
mkdir -p ~/.claude/skills
# 2. 克隆仓库
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# 3. 完成！打开 Claude Code 说：
"What are my skills?"
首次使用自动配置：
- 创建隔离的 Python 环境（.venv）
- 安装所有依赖，包括 Google Chrome
- 设置浏览器自动化（使用 Chrome 而非 Chromium，跨平台更可靠）
- 所有内容都保留在 Skill 文件夹中
📖 快速开始
1. 检查你的 Skills
在 Claude Code 中输入：
What skills do I have?
Claude 会列出可用 Skills，包括 NotebookLM。
2. Google 认证（一次性）
Set up NotebookLM authentication
Chrome 窗口打开 → 使用 Google 账号登录
3. 创建知识库
前往 notebooklm.google.com → 创建 Notebook → 上传文档：
- 📄 PDF、Google Docs、Markdown 文件
- 🔗 网站、GitHub 仓库
- 🎥 YouTube 视频
- 📚 每个 Notebook 支持多个来源
分享设置： ⚙️ Share → Anyone with link → Copy
4. 添加到库
方式 A：让 Claude 自动处理（智能添加）
Query this notebook about its content and add it to my library: [你的链接]
Claude 会自动查询 Notebook 了解内容，然后添加适当的元数据。
方式 B：手动添加
Add this NotebookLM to my library: [你的链接]
Claude 会询问名称和主题，然后保存供将来使用。
5. 开始研究
What does my React docs say about hooks?
Claude 会自动选择合适的 Notebook，直接从 NotebookLM 获取答案。
🛠️ 工作原理
这是 Claude Code Skill —— 包含指令和脚本的本地文件夹，Claude Code 需要时可以使用。
与 MCP Server 的区别
| 特性 | 此 Skill | MCP Server |
|---|---|---|
| 协议 | Claude Skills | Model Context Protocol |
| 安装 | Clone 到 ~/.claude/skills | claude mcp add ... |
| 会话 | 每个问题新开浏览器 | 持久聊天会话 |
| 兼容性 | 仅 Claude Code（本地） | Claude Code、Codex、Cursor 等 |
| 语言 | Python | TypeScript |
| 分发 | Git clone | npm 包 |
架构
~/.claude/skills/notebooklm/
├── SKILL.md # Claude 的指令
├── scripts/ # Python 自动化脚本
│ ├── ask_question.py # 查询 NotebookLM
│ ├── notebook_manager.py # 库管理
│ └── auth_manager.py # Google 认证
├── .venv/ # 隔离 Python 环境（自动创建）
└── data/ # 本地 Notebook 库
当你提到 NotebookLM 或发送 Notebook URL 时，Claude 会：
1. 加载 Skill 指令
2. 运行适当的 Python 脚本
3. 打开浏览器，提问
4. 直接返回答案给你
5. 使用这些知识帮助你完成任务
⭐ 核心功能
| 功能 | 说明 |
|---|---|
| 基于来源的回答 | 大幅减少幻觉，仅基于上传文档回答 |
| 直接集成 | 无需浏览器和编辑器间复制粘贴 |
| 智能库管理 | 保存 NotebookLM 链接并打标签，自动选择合适 Notebook |
| 自动认证 | 一次性 Google 登录，跨会话保持认证 |
| 自包含 | 在 Skill 文件夹中隔离运行，无全局安装 |
| 类人自动化 | 使用真实打字速度和交互模式避免检测 |
💬 常用命令
| 你说 | 会发生什么 |
|---|---|
| “Set up NotebookLM authentication” | 打开 Chrome 进行 Google 登录 |
| “Add [link] to my NotebookLM library” | 保存 Notebook 及其元数据 |
| “Show my NotebookLM notebooks” | 列出所有保存的 Notebooks |
| “Ask my API docs about [topic]” | 查询相关 Notebook |
| “Use the React notebook” | 设置活跃 Notebook |
| “Clear NotebookLM data” | 重新开始（保留库） |
📝 实际示例
示例 1：维修手册查询
用户： “查看我的 Suzuki GSR 600 维修手册，告诉我刹车液类型、发动机油规格和后轴扭矩。”
Claude 自动：
- 认证 NotebookLM
- 询问每个规格的详细问题
- 在被提示 “Is that ALL you need to know?” 时跟进
- 提供准确规格：DOT 4 刹车液、SAE 10W-40 机油、100 N·m 后轴扭矩
示例 2：无幻觉构建
你： “我需要构建一个 n8n 工作流来过滤 Gmail 垃圾邮件。使用我的 n8n Notebook。”
Claude 内部流程：
→ 加载 NotebookLM Skill
→ 激活 n8n Notebook
→ 带着跟进询问综合问题
→ 从多个查询中综合完整答案
结果： 第一次就运行正常的工作流，无需调试幻觉 API。
⚠️ 限制
Skill 特定限制
- 仅本地 Claude Code — 网页版不支持（沙盒限制）
- 无会话持久化 — 每个问题独立
- 无跟进上下文 — 不能引用”上一个回答”
NotebookLM 限制
- 速率限制 — 免费版有每日查询限制
- 需手动上传 — 必须先上传文档到 NotebookLM
- 分享要求 — Notebooks 必须公开分享
🔗 相关资源
- GitHub: https://github.com/PleasePrompto/notebooklm-skill
- MCP Server 版本: https://github.com/PleasePrompto/notebooklm-mcp
- NotebookLM: https://notebooklm.google.com
- Claude Code: https://github.com/anthropics/claude-code
💡 总结
不使用此 Skill：
NotebookLM 在浏览器中 → 复制答案 → 粘贴到 Claude → 复制下一个问题 → 回到浏览器…
使用此 Skill：
Claude 直接研究 → 即时获取答案 → 编写正确代码
停止复制粘贴，开始在 Claude Code 中直接获取准确、基于来源的答案！
整理时间：2026-02-02