Qiaomu Anything-to-NotebookLM 详细部署教程

Qiaomu Anything-to-NotebookLM 是一个强大的 Claude Code Skill，能将任何内容（微信文章、网页、YouTube、PDF等）通过 Google NotebookLM 自动转换为播客、PPT、思维导图、Quiz等多种格式。本教程将引导你完成从安装到使用的完整流程。

一、准备工作

在开始安装前，请确保你的系统满足以下基本要求：

操作系统：macOS、Linux 或 Windows（建议使用 macOS/Linux，体验更顺畅）。
Python 环境：Python 3.9 或更高版本。在终端/命令行中运行 python3 --version 来检查。
Git：用于克隆仓库。
Claude Code：这是运行此 Skill 的 AI 助手环境。你需要安装并配置好 Claude Code。
Google 账号：用于登录和使用 NotebookLM。

注意：此 Skill 的核心功能依赖 Google NotebookLM 的 AI 能力，并且部分功能（如播客转写）可能需要额外的 API 密钥（如 Get笔记）。

二、安装步骤

第一步：将 Skill 安装到 Claude Code

打开终端，执行以下命令将仓库克隆到 Claude Code 的 Skill 目录中。

# 1. 进入 Claude Code 的 skills 目录
cd ~/.claude/skills/

# 2. 克隆仓库
git clone https://github.com/joeseesun/qiaomu-anything-to-notebooklm
cd qiaomu-anything-to-notebooklm

第二步：一键安装所有依赖

运行项目提供的安装脚本，它会自动处理所有 Python 依赖和环境配置。

1 2	# 在 skill 目录下执行 ./install.sh

对于 Windows 用户：如果无法直接运行 .sh 脚本，可以使用 Git Bash 或 WSL 环境执行。或者，你可以手动使用 pip install -r requirements.txt 安装 Python 依赖。

第三步：配置 MCP (Model Context Protocol)

此步骤对于获取微信公众号内容等功能至关重要。

安装脚本执行完毕后，请仔细阅读终端输出的提示，它会指导你如何将 MCP 服务器配置添加到 Claude Code 的配置文件中。
通常，你需要编辑 Claude Code 的配置文件（如 ~/.claude/settings.json），在 mcpServers 字段中添加关于 wexin-read-mcp 和 feishu-read-mcp 的条目。
保存配置文件后，重启 Claude Code 以使配置生效。

第四步：NotebookLM 认证

在使用 Skill 前，需要通过命令行完成 NotebookLM 的一次性认证。

1 2	# 在 skill 目录下执行 notebooklm login

执行后，终端会提供一个链接，请在浏览器中打开并使用你的 Google 账号登录授权。授权成功后，回到终端，你应该会看到登录成功的提示。可以通过以下命令验证：

1	notebooklm list

如果显示正常，说明认证成功。

三、配置可选功能

播客转写功能（用于小宇宙/喜马拉雅/B站）

如果你需要使用 Skill 将中文播客或视频转写为文本，需要配置 Get笔记 的 API 密钥：

前往 Get笔记官网注册并获取 API Key 和 Client ID。
在终端中设置环境变量（你也可以将其写入 ~/.bashrc 或 ~/.zshrc 文件以永久生效）：
1
2
export GETNOTE_API_KEY="你的_API_Key"
export GETNOTE_CLIENT_ID="你的_Client_ID"

四、使用 Skill 处理内容

安装和配置完成后，你就可以在 Claude Code 中直接通过自然语言与它交互了。

基本用法

在 Claude Code 的对话窗口中，像这样描述你的需求即可：

1	把这篇微信文章生成播客 https://mp.weixin.qq.com/s/abc123

或者

1	深度分析这本书 /Users/joe/Books/sapiens.epub，生成思维导图

支持的内容源与格式

输入类型	示例	输出示例
微信公众号	`https://mp.weixin.qq.com/s/...`	播客、PPT、思维导图
付费文章 (如 WSJ, NYT)	`https://www.wsj.com/...`	自动绕过付费墙后处理
YouTube 视频	`https://youtube.com/watch?v=...`	播客、总结
播客 (小宇宙等)	`https://xiaoyuzhoufm.com/episode/...`	PPT、思维导图
电子书 (EPUB/PDF)	`/path/to/book.epub`	深度分析报告、Quiz
X/Twitter 线程	`https://x.com/user/status/...`	思维导图、总结

高级用法示例

深度分析模式：生成 12 个递进式问题，形成结构化的分析报告。
1
python main.py https://example.com/article --deep-analysis
输出到飞书文档：处理完成后，自动将结果创建为飞书文档。
1
python main.py ./book.epub --deep-analysis --to-feishu

五、故障排查

环境检查：如果遇到问题，可以先运行内置的检查脚本，它会扫描 13 项关键配置。
1
./check_env.py
MCP 工具未找到：请重新检查 ~/.claude/settings.json 中的 MCP 配置是否正确，并确保已重启 Claude Code。如果问题依旧，可以尝试手动安装 MCP 服务器的依赖：
1
2
3
cd ~/.claude/skills/qiaomu-anything-to-notebooklm/wexin-read-mcp
pip install -r requirements.txt
playwright install chromium
NotebookLM 认证失败：重新执行 notebooklm login 进行授权。
付费墙绕过失败：部分硬付费墙（如 The Information）可能需要人工协助。脚本会提示你手动打开 archive.today 等存档页面完成验证。
权限问题 (Linux/macOS)：如果提示 Permission denied，请尝试为安装脚本添加执行权限：
1
chmod +x install.sh