teng-lin/notebooklm-py

解決的問題

notebooklm-py 提供對 Google NotebookLM（現為 Gemini Notebook）的程式化存取，允許使用者繞過 Web UI 來實現研究、內容生成和知識管理的自動化。它能夠將 NotebookLM 的基於事實的 AI 能力整合到 AI Agent（如 Claude Code 或 Codex）、Shell 腳本和自定義 Python 流水線中，有效地將該服務轉變為其他 LLM 的可腳本化「記憶層」或綜合引擎。

工作原理

該函式庫作為一個非官方的 Python API 和 CLI 封裝器，封裝了未公開的 Google API。它支援多種身分驗證方法，包括互動式瀏覽器登入、從現有瀏覽器匯入 Cookie，以及用於無頭伺服器環境的主權杖 (master-token) 系統。它可以與 NotebookLM 互動以管理筆記本、上傳各種類型的來源（URL、PDF、YouTube 影片、Google Drive 檔案），並觸發引用式回答和多媒體內容的生成。

適用對象

• AI Agent 開發者：希望在不管理自身向量資料庫的情況下，為 Agent 提供持久、基於事實的記憶或「專案大腦」的人員。
• 研究人員和學生：需要自動批量匯入來源並生成測驗、抽認卡和播客等學習輔助工具的使用者。
• 自動化工程師：正在構建用於定時音訊簡報或自動事件執行手冊生成的無頭流水線的人員。
• 知識管理人員：需要將 NotebookLM 的綜合輸出同步到 Obsidian 等工具的使用者。

亮點

• 全功能覆蓋：對筆記本、來源、聊天、筆記和共享權限進行程式化控制。
• 多樣化的內容生成：生成音訊概覽（播客）、影片、投影片、資訊圖表、測驗、抽認卡、報告和數據表。
• 擴展功能：提供 Web UI 中沒有的功能，例如內容的批量下載，以及測驗和心智圖的結構化匯出（JSON、CSV、Markdown）。
• Agent 就緒：包含為 Claude Code 和 Codex 提供的內建技能，以及用於與 Claude Desktop 和 ChatGPT 整合的 MCP 伺服器。
• 靈活的身分驗證：支援多帳號設定檔和用於無人值守、無頭運行的主權杖系統。