Google NotebookLMをPythonで完全操作！Web画面にない機能まで使い倒せる非公式API — notebooklm-py

アーキテクチャ・仕組み

• Googleの**非公式・非公開API（undocumented RPC）**を利用してNotebookLMの全機能にアクセスする
• 非同期（async）PythonクライアントでNotebookLMのバックエンドと通信
• 認証はPlaywrightブラウザ経由でGoogleアカウントにログインし、認証情報をローカルに保存する仕組み

対応環境

• Python: 3.10 / 3.11 / 3.12 / 3.13 / 3.14
• OS: macOS（主要開発環境）、Linux、Windows（CI でテスト済み）
• ブラウザ自動化: Playwright + Chromium（初回ログイン時に使用）

主要な機能一覧

ノートブック管理

• 作成、一覧、名前変更、削除

ソース管理

• URL、YouTube、ファイル（PDF、テキスト、Markdown、Word、音声、動画、画像）、Googleドライブ、ペーストテキスト
• ソースの更新、ガイド取得、全文テキスト取得

チャット・リサーチ

• 質問応答、会話履歴、カスタムペルソナ設定
• Webリサーチ／Driveリサーチエージェント（fast / deep モード）、自動インポート

コンテンツ生成

共有管理

• 公開/非公開リンク、ユーザー権限（閲覧者/編集者）、閲覧レベル制御

Web UIにはない独自機能

• 全アーティファクトの一括ダウンロード
• クイズ/フラッシュカードの構造化エクスポート（JSON, Markdown, HTML）
• マインドマップの階層JSON出力
• データテーブルのCSVダウンロード
• スライドのPPTX形式ダウンロード
• 個別スライドの自然言語による修正
• レポートテンプレートへのカスタム指示追加
• チャット回答をノートとして保存
• ソースの全文テキスト取得
• プログラムによる共有権限管理

AIエージェント連携

• Claude Code向けのスキルを notebooklm skill install で導入可能
• OpenClaw、Codexなど他のLLMエージェントからも利用想定
• 自然言語で「ポッドキャストを作って」のように指示できる

制約・注意点

• 非公式ライブラリ: Googleとは無関係のコミュニティプロジェクト
• 非公開APIを利用しているため、Google側の変更で突然動かなくなる可能性がある
• 大量利用時はレート制限（速度制限）を受ける場合がある
• プロトタイプ、研究、個人プロジェクト向けが推奨

ライセンス

• MITライセンス: 商用利用を含め自由に利用可能

# 基本インストール
pip install notebooklm-py

# ブラウザログイン機能付き（初回セットアップ時に必要）
pip install "notebooklm-py[browser]"
playwright install chromium

初回認証（ブラウザが開きます）:

notebooklm login

クイックスタート:

# ノートブック作成とソース追加
notebooklm create "My Research"
notebooklm use <notebook_id>
notebooklm source add "https://en.wikipedia.org/wiki/Artificial_intelligence"

# AIに質問
notebooklm ask "What are the key themes?"

# コンテンツ生成
notebooklm generate audio "make it engaging" --wait
notebooklm download audio ./podcast.mp3