NotebookLM Claude Code Skill

当你让 Claude Code “搜索本地文档”时，通常会遇到这些问题：

• Token 消耗巨大：反复读取多个文件
• 检索效果差：只能关键词匹配，无法理解上下文关联
• 容易幻觉：找不到信息就“合理编造”
• 操作繁琐：在浏览器和编辑器之间来回复制粘贴

现在，有一个更高效的解决方案：NotebookLM Claude Code Skill。

它让 Claude Code 直接与 Google NotebookLM 对话，从你上传的文档中获取 有来源、有引用、无幻觉 的答案——全程在命令行完成，无需手动干预。

⚠️ 重要前提：此技能仅支持本地安装的 Claude Code，不适用于网页版（因沙盒限制无网络权限）。

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

NotebookLM 由 Gemini 2.5 驱动，具备以下优势：

• 预处理一次，问答无限：上传后自动解析结构、建立关联
• 跨文档推理：可关联 50+ 份资料中的信息
• 自然语言综合：不是简单检索，而是理解后重新组织语言
• 每条答案带引用：明确指出信息来源
• 零基础设施：无需部署向量数据库、无需写 RAG 逻辑

安装与配置（30 秒完成）

mkdir -p ~/.claude/skills
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

打开 本地 Claude Code，输入：

What are my skills?

如果看到 notebooklm，说明安装成功。

首次使用会自动：

• 创建隔离的 Python 虚拟环境（.venv）
• 安装依赖（包括 Google Chrome）
• 配置浏览器自动化（使用 Chrome 而非 Chromium，确保与 Google 服务兼容）

使用流程

1. 一次性身份验证

Set up NotebookLM authentication

→ 自动弹出 Chrome 窗口 → 用你的 Google 账号登录

2. 准备知识库

访问 notebooklm.google.com，创建笔记本并上传：

• PDF、Markdown、Google Docs
• GitHub 仓库、网页、YouTube 视频

务必点击“分享” → “知道链接的任何人可查看” → 复制链接

3. 添加到本地库

智能添加（推荐）：

Query this notebook about its content and add it to my library: [你的链接]

Claude 会自动分析内容并打标签。

或手动添加：

Add this NotebookLM to my library: [你的链接]

4. 直接提问

What does my React docs say about hooks?

Claude 会自动选择匹配的笔记本，向 NotebookLM 提问，并返回带引用的答案。

技术原理

这是一个 Claude Code 技能（Skill），本质是一个本地脚本包，结构如下：

~/.claude/skills/notebooklm/
├── SKILL.md              # 给 Claude 的使用说明
├── scripts/              # 自动化脚本（Python）
│   ├── ask_question.py   # 核心查询逻辑
│   ├── notebook_manager.py
│   └── auth_manager.py
├── .venv/                # 隔离环境
└── data/                 # 本地缓存（含认证信息）

工作流程：

1. 你提到 NotebookLM 或粘贴链接
2. Claude 加载技能指令
3. 启动 Chrome，自动登录并提问
4. 解析回答（含引用）并返回 CLI
5. 用该知识编写代码或解答问题

所有数据仅存于本地，data/ 目录已自动 .gitignore，切勿手动提交。

与 MCP 服务器的区别

选哪个？

• 想快速在 Claude Code 中用 → 用此技能
• 需要多工具支持或会话记忆 → 用 MCP 服务器

实际效果对比

场景：查询摩托车维修手册

你问：
“检查我的铃木 GSR 600 维修手册，了解刹车油类型、机油规格、后轴扭矩。”

结果：
Claude 自动获取并返回：

• 刹车油：DOT 4
• 机油：SAE 10W-40
• 后轴扭矩：100 N·m

无幻觉，有依据，一步到位。

场景：构建 n8n 工作流

你问：
“用我的 n8n 笔记本，做一个 Gmail 垃圾邮件过滤流程。”

结果：
Claude 直接调用笔记本内容，生成可运行的工作流，无需调试虚构的 API。

注意事项与限制

• 仅限本地 Claude Code：网页版无法使用
• 需公开分享 NotebookLM 链接：权限设为“知道链接的人可查看”
• 免费版有查询频率限制
• 每次提问开启新浏览器：无上下文记忆，但通过“Is that ALL you need to know?”触发自动追问
• 建议使用专用 Google 账号：避免自动化行为影响主账号

常用命令速查