作者 teng-lin · teng-lin/notebooklm-py
从 Claude 驱动 Google NotebookLM——创建笔记本、导入来源、生成音频概览，包含 Web 界面隐藏的功能。
notebooklm-py 是 NotebookLM 的非官方 Python API + Claude skill。它暴露了笔记本 CRUD、来源导入（PDF、URL、YouTube）以及音频概览 / 思维导图 / FAQ 生成功能。包含 CLI 和 agent skill，让你可以说「把这些 PDF 加载到笔记本并给我音频概览」，而无需打开 notebooklm.google.com。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"notebooklm-py-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/teng-lin/notebooklm-py",
"~/.claude/skills/notebooklm-py"
],
"_inferred": true
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"notebooklm-py-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/teng-lin/notebooklm-py",
"~/.claude/skills/notebooklm-py"
],
"_inferred": true
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"notebooklm-py-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/teng-lin/notebooklm-py",
"~/.claude/skills/notebooklm-py"
],
"_inferred": true
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"notebooklm-py-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/teng-lin/notebooklm-py",
"~/.claude/skills/notebooklm-py"
],
"_inferred": true
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "notebooklm-py-skill",
"command": "git",
"args": [
"clone",
"https://github.com/teng-lin/notebooklm-py",
"~/.claude/skills/notebooklm-py"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"notebooklm-py-skill": {
"command": {
"path": "git",
"args": [
"clone",
"https://github.com/teng-lin/notebooklm-py",
"~/.claude/skills/notebooklm-py"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add notebooklm-py-skill -- git clone https://github.com/teng-lin/notebooklm-py ~/.claude/skills/notebooklm-py一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 收件箱里来了 10 篇论文；你想快速得到一个综合摘要。
结果： 10 篇论文转化为 20 分钟可读的摘要，或一段散步时能听的音频。
何时使用： 你有文档，需要给用户一份 FAQ。
结果： 可以直接发布的 FAQ。
ARIS 负责自主研究发现，NotebookLM 负责综合消化
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| create_notebook | title | 新项目 | 1 NotebookLM op |
| add_source | notebook_id, source: pdf|url|youtube | 构建来源集 | 1 op + ingestion time |
| generate_audio | notebook_id, style? | 音频概览 | 1 op + render |
| generate_mind_map | notebook_id | 可视化来源结构 | 1 op |
| ask | notebook_id, question | 基于来源的问答 | 1 op |
Google auth for NotebookLMOAuth scopes you don't needAuth flow stuck清除本地 token 缓存并重新认证
Source ingestion fails for big PDFs拆分为更小的块；NotebookLM 对单个来源有大小限制
Audio generation queued foreverNotebookLM 的音频队列有时较慢；稍后重试
| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| NotebookLM web UI | 手动、一次性使用 | 无自动化；缺少编程化功能 |
| Custom RAG pipeline | 需要完全控制底层模型 | 大量工程投入，而 NotebookLM 功能是免费的 |