notebooklm-py 教學：用 Python 解鎖 Google NotebookLM 隱藏功能，批次下載、自動化研究一次搞定

Google NotebookLM 已經是阿正老師心目中最強的 AI 研究工具之一——你只要把 PDF、YouTube 連結、網址丟進去，它就能幫你整理重點、產生 Podcast 音檔、做學習卡、出題目、畫心智圖⋯⋯功能多到嚇人。但用久了，你一定也踩過同一個坑：做出來的東西根本匯出不了！

學習卡只能用連結分享、心智圖只能存成 PNG 圖片、報告一關掉視窗就找不到⋯⋯這些限制讓很多人抓狂。就在大家以為只能忍著用的時候，一個叫做 notebooklm-py 的開源工具悄悄出現了，完全用 Python 打通 NotebookLM 的底層 API，把那些「網頁版做不到的事」全部變成可能。

這篇文章阿正老師就來好好介紹這個工具——從它能做什麼、怎麼安裝，到實際的指令操作，就算你不是工程師，也能看懂跟著做！

---

---

一、什麼是 notebooklm-py？

notebooklm-py 是由開發者 Teng Lin 在 2025 年 1 月發布的開源 Python 函式庫，目前已釋出 v0.5.0（2026 年 5 月），放在 PyPI 上隨時可以 pip 安裝。

簡單說，它就是一個「非官方的 NotebookLM 自動化工具」。它透過逆向工程的方式，呼叫 Google NotebookLM 沒有公開的內部 API，讓你可以用 Python 程式碼或命令列（CLI）的方式，完整操控 NotebookLM 的所有功能——包括網頁版沒有提供的進階功能。

支援三種使用方式：

• Python API：適合開發者寫程式整合，支援 async 非同步工作流程
• CLI 命令列：適合一般用戶輸入指令快速操作，不用寫程式
• AI Agent 整合：可搭配 Claude Code、OpenClaw（養龍蝦）等 AI 代理人自動執行研究任務

官方網站	github.com/teng-lin/notebooklm-py
最新版本	v0.5.0（2026 年 5 月 24 日）
支援系統	Windows、macOS、Linux（需 Python 3.10 以上）
費用	完全免費，MIT 授權開源
PyPI 頁面	pypi.org/project/notebooklm-py

---

二、它能做哪些網頁版做不到的事？

這是阿正老師覺得 notebooklm-py 最有價值的地方。以下這些功能，在 NotebookLM 網頁版根本做不到，但用這個工具就能輕鬆實現：

• 批次下載所有成果：一次把所有音頻、影片、投影片、學習卡全部下載到本機
• 學習卡 / 測驗題匯出：網頁版只能互動瀏覽，這裡可以匯出成 JSON、Markdown、HTML 檔案
• 心智圖 JSON 匯出：網頁版只能存 PNG 圖片，這裡可以拿到完整的階層式 JSON 資料，可以放進其他工具繼續編輯
• 投影片存成 PPTX：網頁版只能下載 PDF，這裡可以拿到可以用 PowerPoint 編輯的 .pptx 格式
• 資料表 CSV 匯出：把 NotebookLM 生成的結構化表格存成試算表
• 取得來源全文：讀取 NotebookLM 解析 PDF、YouTube、網頁後的索引文字內容
• 多帳號切換：支援設定多個 Google 帳號 Profile，不用每次重新登入
• 投影片個別修改：用自然語言指令修改特定一張投影片的內容
• 聊天記錄存成筆記：把 Q&A 對話自動儲存成筆記本內的備注

---

三、安裝方式：pip 一行搞定

安裝非常簡單，只要你電腦有裝 Python 3.10 以上版本，開終端機（Windows 用命令提示字元或 PowerShell，Mac 用終端機）輸入以下指令就好：

基本安裝（一般用戶）：

pip install notebooklm-py

含瀏覽器登入支援（首次使用必裝）：

pip install "notebooklm-py[browser]"
playwright install chromium

第一次使用一定要安裝 [browser] 版本，因為登入 Google 帳號需要跳出瀏覽器視窗做驗證，這部分是靠 Playwright（一個自動化瀏覽器工具）來處理的。

另外，如果你不想讓 Playwright 另外開瀏覽器，也可以直接從現有的 Chrome 或 Edge 複製 Cookie 來驗證：

pip install "notebooklm-py[cookies]"

---

四、登入驗證：讓工具連上你的 Google 帳號

安裝完成後，第一步就是登入你的 Google 帳號。輸入以下指令，它會自動開啟一個 Chromium 瀏覽器視窗，讓你完成 Google 帳號登入流程：

notebooklm login

如果你的公司或學校帳號需要用 Microsoft Edge 做 SSO 單一登入，可以改用：

notebooklm login --browser msedge

或者如果你想直接吃瀏覽器現有的登入 Cookie（最方便，不用另外開視窗）：

notebooklm login --browser-cookies chrome

阿正老師自己用的是這個方式，Chrome 已經登入 Google 帳號，直接讓工具讀取 Cookie 就行，超快！

---

五、基本操作：建立筆記本、加入資料來源、問問題

登入完成後，基本操作流程大概就這樣：先建立筆記本，再加入你的資料（網址、PDF、YouTube 等），然後就可以開問了。

先切換成正體(繁體)中文 （如果沒切換的話，生成的資料都是英文的）：

notebooklm language set zh_Hant

建立筆記本：

notebooklm create "我的研究筆記"

選定要操作的筆記本（用建立後回傳的 ID）：

notebooklm use <notebook_id>

加入資料來源（支援網址、PDF、YouTube 連結）：

notebooklm source add "https://zh.wikipedia.org/wiki/人工智慧"
notebooklm source add "./我的報告.pdf"
notebooklm source add "https://www.youtube.com/watch?v=xxxx"

直接在命令列問問題：

notebooklm ask "這份資料的主要論點是什麼？"

這樣就能在終端機直接拿到 NotebookLM 根據你的資料來源生成的回答，非常方便！

---

六、內容生成：音頻、影片、學習卡、心智圖都有

這是最精彩的部分！notebooklm generate 指令支援所有 NotebookLM 能生成的內容類型，而且選項比網頁版更多。

生成 Podcast 音頻（Audio Overview）：

notebooklm generate audio "請做成兩人對話深度討論的形式" --wait

生成影片概覽：

notebooklm generate video --style whiteboard --wait

生成測驗題（可設定難度）：

notebooklm generate quiz --difficulty hard

生成學習卡（Flashcards）：

notebooklm generate flashcards --quantity more

其他支援的生成類型：

---

七、下載匯出：把成果存到自己的電腦

生成完成後，用 notebooklm download 指令就能把檔案存到本機。以下是幾個常用的下載範例：

# 下載 Podcast 音頻
notebooklm download audio ./podcast.mp3

# 下載學習卡（存成 JSON 格式）
notebooklm download flashcards --format json ./cards.json

# 下載測驗題（存成 Markdown 格式）
notebooklm download quiz --format markdown ./quiz.md

# 下載投影片（存成 PPTX 可編輯格式）
notebooklm download slide-deck –format pptx ./slides.pptx

# 下載心智圖 JSON
notebooklm download mind-map ./mindmap.json

# 下載資料表 CSV
notebooklm download data-table ./data.csv

阿正老師在我的 AMD R7 5800x 桌機上測試，下載音頻和影片速度很快，幾秒鐘就完成了。整個流程跑起來比在網頁版手動操作快很多，尤其是要批次處理多個筆記本的時候，差距就更明顯。

---

八、注意事項：非官方工具，請這樣用才安全

notebooklm-py 本身非常好用，但有幾件事阿正老師一定要提醒大家：

• 不要用主要工作帳號冒險：建議用個人或測試用的 Google 帳號，避免對重要帳號造成風險
• 避免短時間內大量操作：頻繁呼叫可能觸發 Google 的速率限制，被暫時封鎖
• 隨時關注版本更新：如果工具突然失效，通常是 Google 改 API 了，可以到 GitHub 查看是否有新版修正
• 只從 PyPI 官方安裝：pip install notebooklm-py，不要從來路不明的第三方網站下載

---

九、阿正老師的總結

---