从零搭建 SonicNote Claude Code NotebookLM 自动化流水线让录音一键变成可检索的 AI 知识库 项目简介你是否遇到过这些场景开了两小时会记了一页纸笔记回头想查个细节却翻半天找不到录了一堆培训音频想复习时只能从头到尾重听一遍录音文件躺在文件夹里吃灰知识从未真正变成可检索的资产本项目的目标打通 SonicNote聆犀 AI 录音卡→ Claude Code → NotebookLM 的自动化流水线让你只需按一下录音键剩下的全部自动完成。环节工具作用️ 录音SonicNote 录音卡一键录制自动上传到云端 转写妙记 AppASR 自动转写 AI 智能总结 桥接Claude Code SonicNote MCP通过 MCP 协议读取录音数据 知识库NotebookLM文档理解 来源引用问答 内容生成️ 系统架构系统采用4 层架构每一层职责清晰核心组件组件角色说明️ SonicNote 录音卡硬件拾音器磁吸式智能录音一键录制自动上传☁️ 妙记 AppAI 处理引擎ASR 转写多语种 AI 智能总结 SonicNote MCP Server数据桥接层基于 MCP 协议的标准化中间件 Claude Code智能编排引擎通过 MCP 读取录音驱动整条流水线 NotebookLM智能知识库文档理解 来源引用问答 内容生成 Chrome Playwright认证通道自动提取 Google 登录态️ 环境准备你需要准备的工具工具版本要求用途Node.js≥ 18运行 MCP ServerClaude Code CLI最新AI 编排引擎可选也可手动操作Python≥ 3.10运行 notebooklm-pySonicNote 录音卡—硬件拾音妙记 App已登录录音转写检查现有环境node--version# ≥ 18python--version# ≥ 3.10pip--versiongit--version⚠️注意如果你的 Python 安装在含中文或空格的路径下Git Bash 调用python可能会报错。推荐使用 Python 虚拟环境解决。1️⃣ 安装 SonicNote MCPSonicNote 提供了标准的 MCP Server让 Claude Code 可以直接读取妙记中的录音数据。获取 API Key打开妙记 App →我的→MCP Key 管理→ 创建一个 Key格式: sk-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx配置到 Claude Codeclaude mcpaddsonicnote -- npx myshell-ai/sonicnote-mcp按提示输入 API Key 完成认证。验证是否成功在 Claude Code 中输入列出我的录音如果能返回录音列表说明 SonicNote MCP 配置成功。提示MCP 只需要配置一次后续所有会话都会自动加载。2️⃣ 安装 notebooklm-pynotebooklm-py是社区开发的 NotebookLM 命令行工具支持上传文档、提问、生成内容、下载结果是连接 Claude Code 和 NotebookLM 的桥梁。创建虚拟环境推荐# 创建虚拟环境python-mvenv notebooklm-env# macOS / Linux 激活sourcenotebooklm-env/bin/activate# Windows (Git Bash) 激活sourcenotebooklm-env/Scripts/activate安装# 安装 notebooklm-py包含浏览器认证支持pipinstallnotebooklm-py[cookies,browser]# 验证安装notebooklm--help如果显示命令列表说明安装成功。使用包装脚本可选项目提供了nb包装脚本无需手动激活虚拟环境cdsonicnote-notebooklm ./nb list以及use-venv.sh一键激活脚本sourceuse-venv.sh推荐Windows 用户遇到 Python 编码问题时优先使用nb包装器。初始配置# 设置默认语言为简体中文notebooklm languagesetzh_Hans# 验证语言设置notebooklm language get⚠️注意NotebookLM 的简体中文代码是zh_Hans不是zh-CN。3️⃣ NotebookLM 登录认证NotebookLM 需要 Google 账号登录notebooklm-py 通过 Playwright 自动打开浏览器完成认证。一键登录# 直接登录第一次需要交互notebooklm login执行后会自动打开 Chromium 浏览器窗口你只需要在浏览器中登录你的 Google 账号如果尚未登录然后授权即可。验证认证状态notebooklm auth check--test认证成功后输出应包含检查项状态Token fetch✅ ✓ passNotebooks✅ ✓ pass显示笔记本数量SID cookie✅ ✓ passAuthentication is valid✅创建笔记本# 创建你的录音知识库notebooklm create妙记录音库# 设置当前笔记本后续操作默认使用此笔记本notebooklm use笔记本ID# 查看当前状态notebooklm status持久化认证认证信息保存在~/.notebooklm/profiles/default/storage_state.json无需每次重新登录。只有当 Cookie 过期通常数周后才需要重新运行notebooklm login。4️⃣ 配置网络代理方式一环境变量# 设置代理Clash 默认端口exportHTTPS_PROXYhttp://127.0.0.1:7890exportHTTP_PROXYhttp://127.0.0.1:7890方式二使用项目脚本项目提供的nb和use-venv.sh脚本已内置代理设置# use-venv.sh 会自动设置代理sourceuse-venv.sh 如果使用其他代理工具请将脚本中的7890端口改为你的代理端口。5️⃣ 验证全链路完成上述配置后快速验证整个流程是否打通# 1. 确保已设置当前笔记本notebooklm status# 2. 创建测试文件echo这是一段测试录音转写内容。test-transcript.md# 3. 上传测试文档注意保存输出中的源IDnotebooklmsourceaddtest-transcript.md\--typefile\--title测试录音# 4. 等待处理完成将 源ID 替换为上一步输出的 IDnotebooklmsourcewait源ID# 5. 提问测试notebooklm ask这段录音讲了什么如果 NotebookLM 能正确回答并标注来源引用[1]说明全链路打通成功。快速环境检查清单步骤命令预期结果①python --version≥ 3.10②notebooklm --help显示命令列表③notebooklm auth check --testAll ✓ pass④notebooklm status显示笔记本信息⑤上传 提问AI 回答 来源引用 项目文件结构sonicnote-notebooklm/ ├── bridge.mjs # Gemini API 桥接脚本备用方案 ├── auto-pipeline.sh # 全自动流水线脚本 ├── nb # NotebookLM CLI 包装器 ├── use-venv.sh # 一键激活虚拟环境 ├── assets/ # 教程配图 │ ├── pipeline-overview.svg # 整体流程图 │ ├── architecture.svg # 系统架构图 │ ├── notebooklm-qa.svg # NotebookLM 问答界面 │ ├── auto-pipeline.svg # 自动化流水线 │ ├── use-cases.svg # 适用场景矩阵 │ └── Crime_Rates_Infographic.png # 真实生成案例图 ├── SonicNote_NotebookLM_Setup_Guide.md # 安装部署指南本文 ├── SonicNote_NotebookLM_Usage_Guide.md # 使用教程与优势分析 ├── .env # API Key 配置请勿提交到 Git ├── package.json # Node.js 项目配置 └── node_modules/ # Node.js 依赖❓ 常见安装问题Q1NotebookLM 提示认证过期现象执行操作时返回Authentication expired or invalid解决# 重新登录notebooklm login# 验证notebooklm auth check--testQ2Playwright 找不到浏览器现象Executable doesnt exist at ... ms-playwright解决# 安装 Chromium 浏览器playwrightinstallchromiumQ3NotebookLM 有容量限制吗免费版每个笔记本最多50 个源文件每个源文件最多50 万字。对于日常录音来说绰绰有余。Q4笔记本电脑上 Playwright 浏览器窗口看不到可能被最小化到任务栏或后台。确保没有安全软件拦截浏览器弹出。✅ 安装完成恭喜你已经完成了全套环境的安装和配置。现在你可以✅ SonicNote MCP — 已配置可以读取录音✅ notebooklm-py — 已安装可以操作 NotebookLM✅ 账号认证 — 已完成API 可用✅ 网络畅通 — 已配置网络畅通✅ 全链路 — 已验证可正常上传和问答妙记 App 下载http://www.sonicnote.cnSonicNote-skills 下载https://www.skillhub.cn/skills/sonicnoteNotebookLM-py下载https://github.com/teng-lin/notebooklm-py