NotebookLM Agent 研究与内容生成
让 Agent 调用 Gemini Notebook 的来源问答、研究、播客、幻灯片、报告和批量导出能力。
技能说明
notebooklm-py 是 Google NotebookLM（现称 Gemini Notebook）的非官方 Python API、命令行和 Agent Skill。它支持导入网页、YouTube、PDF、文档、音频、视频、图片和 Google Drive 内容，围绕资料进行带引用问答、研究查询，并生成播客、视频、幻灯片、报告、测验、闪卡、信息图、数据表和思维导图。README 和根目录 SKILL.md 明确提供 Claude Code、Codex、OpenClaw、MCP 和 npx skills 接入。使用前必须登录 Google 并做网络认证检查；storage_state.json 含会话 Cookie，必须按登录凭据保护。项目使用 MIT 许可证，但依赖 Google 未公开的内部接口，可能受接口变化、限流和账号策略影响。
关于此技能
notebooklm-py 提供 Google NotebookLM（现称 Gemini Notebook）的本地命令行、Python、MCP 和 Agent Skill 接入，让 Agent 以用户资料为依据进行问答、研究和内容生成。
核心能力
来源驱动问答
导入网页、YouTube、PDF、文档、音频、视频、图片或 Google Drive 内容，围绕已导入资料提问并保留引用。
研究和知识库流程
批量加入来源、执行研究查询、把 notebook 当作有来源依据的知识库或跨会话记忆层。
多种内容生成
生成播客音频、视频、幻灯片、报告、测验、闪卡、信息图、数据表和思维导图，并下载多种格式。
多种接入方式
同时提供 Python API、CLI、MCP、REST 和 Agent Skill；README 明确给出 Claude Code、Codex、OpenClaw 等接入方式。
账号与并行隔离
支持多账号 profile、显式 notebook ID 和独立配置目录，适合自动化或并行 Agent 工作流。
适用场景
把资料变成带引用的答案
将项目文档、研究资料或会议材料放入 notebook，让 Agent 先基于来源回答，再完成最终整理。
研究和内容再利用
从一组资料生成报告、播客、幻灯片、测验、闪卡或思维导图，批量下载到本地工作流。
项目知识库和记忆
维护一个资料库供编码 Agent 查询 RFC、架构、故障记录和历史决策，减少重复塞入上下文。
远程或定时任务
使用 MCP、REST 或定时刷新认证，构建后台研究、音频简报和内容生产流程。
使用步骤
- 01
安装包和技能
运行 pip install notebooklm-py[browser]，再运行 notebooklm skill install；也可用 npx skills add teng-lin/notebooklm-py 安装 SKILL.md。
- 02
完成登录
运行 notebooklm login 通过 Google 登录；脚本和自动化前必须用 notebooklm auth check --test --json 验证真实登录状态。
- 03
建立资料库
创建 notebook，导入网页、文档或 YouTube 等来源，等待来源处理完成后再提问或生成内容。
- 04
调用和导出
用 notebooklm ask、source add-research 或 generate 等命令完成问答和内容生成，再用 download 导出结果。
- 05
保护认证信息
把 storage_state.json 和 NOTEBOOKLM_AUTH_JSON 当作 Google 登录凭据，不提交代码库、不打印、不分享，并按文档要求限制权限。
常见问题
这是 Google 官方 SDK 吗？+
不是。README 明确标注为非官方 Python API，调用 Google 的内部接口，可能因接口变化、限流或账号策略而失效。
必须登录 Google 吗？+
是。使用前需要 notebooklm login，并用 auth check --test --json 验证；不同账号可用 profile 隔离。
支持哪些 Agent？+
README 和根目录 SKILL.md 明确支持 Claude Code、Codex、OpenClaw，并提供 MCP 接入；其他能使用 CLI、MCP 或 Agent Skills 的环境需自行适配。
认证文件安全吗？+
storage_state.json 含 Google 会话 Cookie，等同于登录凭据。应保持仅本人可读、加入忽略列表，泄露后立即撤销 Google 权限并重新登录。
生成内容是否有使用限制？+
音频、视频、测验、闪卡、信息图和幻灯片等生成能力可能受到 Google 限流和账号配额影响。
npx skills add teng-lin/notebooklm-py