Google NotebookLM 是一款强大的 AI 笔记助手,能基于你的文档自动生成摘要、问答和灵感,但它的官方 Web 界面功能有限、无法批量操作、更不支持自动化集成。而 notebooklm-py 正是为打破这些限制而生——它是一个开源的非官方 Python 工具包,让你用代码完全掌控 NotebookLM 的底层能力,甚至把它的“大脑”接入 Claude、OpenClaw 等 AI 编程智能体中,实现真正意义上的笔记自动化工作流。
核心功能
- 全功能 Python API:绕过网页限制,直接调用文档上传、笔记创建、话题提取、引用溯源、AI 提问等全部后端能力,连官方 UI 都没开放的「批量生成播客脚本」「跨笔记语义关联」等功能也能轻松调用。
- 开箱即用的 CLI 命令行工具:无需写代码,一条命令即可导入 PDF/Markdown、生成结构化笔记摘要、导出带引用的问答对,适合日常快速处理学习资料或会议纪要。
- Claude / Codex / OpenClaw 智能体技能(Agentic Skill):将 NotebookLM 封装为可插拔的 AI “技能模块”,让 Claude Code 或 OpenClaw 在编码时自动读取你的技术文档笔记,实时调用上下文生成注释、测试用例或故障排查建议。
- 播客内容一键生成器:基于你的知识库自动生成专业级播客提纲、主持人对话稿与嘉宾问答脚本,支持导出 MP3(通过集成 TTS 服务),知识工作者做音频专栏的效率提升 5 倍以上。
- 细粒度权限与版本控制:支持按文档粒度管理访问权限、查看操作历史、回滚到任意版本的笔记状态,满足团队协作与合规审计需求。
- 本地化增强与离线预处理:提供文档文本清洗、OCR 后处理、中文分词优化等实用工具,显著提升中文 PDF 和扫描件的解析准确率。
适合哪些人用
如果你是以下角色之一,notebooklm-py 极可能成为你知识管理的“隐藏开关”:
• 科研人员与学生:快速消化几十篇论文 PDF,自动生成文献综述草稿与答辩问答清单;
• 产品经理 & 技术作家:将 PRD、API 文档、用户反馈自动构建成可搜索、可引用的产品知识图谱;
• AIGC 创作者:把读书笔记、访谈录音转为系列短视频脚本或 Newsletter 内容;
• 开发者与 AI 工程师:在 LangChain / LlamaIndex 流程中嵌入 NotebookLM 作为专用“文档理解层”,或训练私有领域模型时构建高质量指令微调数据集。
快速上手
安装只需一行命令(推荐使用 Python 3.10+):
pip install notebooklm-py
首次使用前需登录 Google 账号获取临时 Cookie(项目提供交互式向导,全程图形化指引,3 分钟完成授权);之后即可运行:
# 上传文档并创建笔记
notebooklm upload ./research_papers/ --name "LLM-Survey-2024"
# 向笔记提问(支持自然语言)
notebooklm ask "对比 LLaMA-3 和 Qwen2 在中文推理任务上的优劣?请标注出处页码"
# 导出为 Markdown 格式的完整问答报告
notebooklm export --format md --output report.md
进阶用户还可参考官方示例仓库,5 分钟内将 NotebookLM 接入 Claude 3.5 的函数调用(Function Calling)流程,实现“你说话,它查文档,再写代码”的全自动闭环。
项目信息
Unofficial Python API and agentic skill for Google NotebookLM. Full programmatic access to NotebookLM’s features—including capabilities the web UI doe
14.3k
今日 +182 stars today
Stars
2.0k
Forks
Python
MIT
编程语言:Python|GitHub Star 数:14,263|开源协议:MIT|GitHub 项目地址
这是一个由社区驱动、持续活跃维护的高星项目,每周发布新特性,已通过 GitHub Actions 全流程自动化测试验证,兼容 Python 3.10 至 3.14 最新版。
它不是玩具,而是把 Google NotebookLM 从“演示产品”升级为“生产力引擎”的关键拼图——知识工作者值得拥有的下一代笔记操作系统内核。



