>_ DevTrendsja

言語

ホーム

言語

セクション

フロントエンド バックエンド モバイル DevOps AI / ML ゲーム開発 ブロックチェーン 組み込み セキュリティ
Python

TerminalからGoogle NotebookLMに直接接続してClaudeやCursorと連携する方法

Gemini Notebook MCP Header

Google NotebookLMサービス(最近Gemini Notebookに改名)は、大量のドキュメント、長いPDF、YouTube動画を手軽に扱えます。ソースへの引用付きで首尾一貫した回答を生成し、2人のバーチャルホストが楽しいオーディオポッドキャストを作成することもできます。

このサービスの面倒な点は、公式の公開APIがまだないことです。

ターミナルからノートブックにリンクのバッチをアップロードしたり、生成された素材をエクスポートしたり、CursorのAIエージェントに個人のナレッジベースを検索させたりしたい場合は、ブラウザをクリックし続けるしか方法がありません。開発者のjacob-bdはこの問題を解決し、gemini-notebook-mcp-cliをリリースしました。コマンドラインインターフェースnlmを提供し、コードエディタへの接続用のローカルMCPサーバーを起動します。

このユーティリティできること

このリポジトリは2つのツールを組み合わせています:クラシックなCLI(bashスクリプト用)とMCP(Model Context Protocol)サーバーです。

ターミナルコマンドnlmを通じて、ブラウザタブを開かずにノートブックを管理できます。利用可能な操作には、メモの作成、ソースのアップロード、データベースへのクエリ、アーティファクトのエクスポートが含まれます:

# Создаем блокнот под ресерч
nlm notebook create "Архитектура проекта"

# Добавляем ссылки и документы
nlm source add <notebook-id> --url "https://habr.com/..."

# Запускаем генерацию аудиообзора
nlm audio create <notebook-id> --confirm

# Скачиваем все созданные материалы в папку
nlm download all <notebook-id> -d ./exports

最も興味深い部分は、MCPのセットアップ時に始まります。このパッケージは популярныеツール(Claude Code、Claude Desktop、Cursor、Gemini CLI、Windsurf、Cline)の設定ファイルに自動的に自身を登録できます。

クイックセットアップコマンド:

nlm setup add cursor
nlm setup add claude-code

その後、アシスタントチャットでプレーンテキストで記述できます:「分散トランザクションについてのノートブックを作成し、このプルリクエストを追加して、簡単なサマリーを生成してください。」アシスタントは舞台裏で必要な関数を呼び出します。

隠されたスタジオ機能

通常のテキスト回答に加えて、このツールはGemini Notebookのコンテンツジェネレーターへのアクセスを提供します。CLIとMCPを通じて、以下を実行できます:

  1. ポッドキャスト作成(2人のスピーカーによるトピックの詳細な議論)。
  2. さまざまな長さやビジュアルスタイルのビデオ概要生成。
  3. フラッシュカードと学習ガイドの組み立て。
  4. アップロードしたソースに基づくインフォグラフィックとマインドマップ。
  5. プレゼンテーションスライドの作成と編集。

嬉しいボーナス:コンソールまたはコードエディタから送信されたすべてのリクエストは、GoogleのWebインターフェース履歴に保存されます。ターミナルでクエリを開始し、夜に電話でブラウザから回答を読み続けることができます。

内部での認証のしくみ

公式APIがないため、このプロジェクトはGoogleの内部エンドポイントを通じて動作します。認証済みセッションからの有効なCookieが必要です。

プロジェクト開発者はこのプロセスを自動化しました。次のコマンドを実行します:

nlm login

ユーティリティは別のブラウザプロファイル(Chrome、Brave、Arc、Edge、Chromium、Firefoxがサポートされています)を開き、Googleアカウントにログインすると、スクリプトが必要なトークンを傍受してローカルに保存します。

このツールは、--profile workまたは--profile personalフラグ 통해複数のプロファイルでの作業をサポートしています。CSRFトークンはリクエストが失敗したときに自動的に更新され、Cookie自体は2〜4週間有効です。

正直な作成物語とコミュニティサポート

プロジェクト作者はREADMEで、深いPythonの経験なしにAIアシスタントを積極的に活用して最初のバージョン написал坦白了。

コードは即座のニーズを解決しましたが、理想的からは程遠いものでした。作者はそれを避けず、直接コミュニティにリファクタリングとコードレビューで助けを求めました。

オープンソースは意図通りに機能しました。数十人の開発者がプロジェクトに参加しました。彼らは接続プール、適切なエラー処理、WSL2サポート、Google Drive同期、バッチ操作、ログへの認証情報の漏洩を防ぐセキュリティ監査を追加しました。その結果は、GitHubでほぼ6000個のスターを獲得した信頼性の高いツールです。

注意点

ユーティリティをパイプラインに統合する前に、いくつかの制限に注意してください。

第一に、文書化されていないAPIの使用には破損のリスクが伴います。Googleはいつでもリクエスト形式やレスポンス構造を変更でき、スクリプトはパッチがリリースされるまで動作しなくなります。

第二に、免费アカウントには1日あたり約50リクエストの制限があります。バッチスクリプトで一度に100件のドキュメントを実行したい場合は、その上限に達します。

第三に、サーバーは43個の個別のMCPツールを公開しています。この数の関数は、Claude CodeやCursorのコンテキストウィンドウを заметно埋めます。現在ノートブックを扱っていない場合は、設定でサーバーを一時的に無効にするか、必要なメソッドのみを選択的にエクスポートするように構成することをお勧めします。

インストール

ユーティリティをインストールする最も簡単な方法は、uvパッケージマネージャーを使用することです:

uv tool install notebooklm-mcp-cli

標準的なPythonを使用している場合、pipxまたは通常のpipが動作します:

pipx install notebooklm-mcp-cli

永続的なインストールなしで実行する(uvxを使用)も利用可能です:

uvx --from notebooklm-mcp-cli nlm --help

誰が役立つのか

このプロジェクトは、Gemini Notebookを大規模なテキスト、技術ドキュメント、講義の分析に積極的に使用しているが、ブラウザのルーティンに厌倦している人々にアピールします。このユーティリティは、資料収集の自動化、サマリーエクスポートスクリプトの作成、Google DriveからのコンテキストをAIアシスタントとの作業チャットに直接統合するのに最適です。

関連プロジェクト