NotebookLM Claude Code スキル

AI/ML

概要

NotebookLM Claude Code スキルは、Anthropic の Claude Code(スキル対応)から直接 Google NotebookLM にアクセスし、自分のノートを元に出典付きの回答を生成するための実装です。本リポジトリはブラウザ自動化を用いて NotebookLM を操作し、ノートの検索・取得・引用情報の抽出を行います。永続的な認証情報の管理や必要ライブラリのセットアップ、スキル定義ファイル(SKILL.md)を含み、Claude Code と連携して「ゼロ・ハルシネーション」を目指す設計になっています。導入は比較的シンプルで、個人のNotebookLMを知識ベースとして活用したい開発者や研究者に有用です。

GitHub

リポジトリの統計情報

  • スター数: 13
  • フォーク数: 2
  • ウォッチャー数: 13
  • コミット数: 2
  • ファイル数: 8
  • メインの言語: Python

主な特徴

  • Claude Code スキルとして動作し、Claude(またはスキル対応環境)から NotebookLM を直接参照可能
  • ブラウザ自動化による NotebookLM の検索・取得で API 非対応時にも利用可能
  • 永続認証(persistent auth)やライブラリ管理を考慮した運用設計
  • 取得したノートを出典付きで返すことでハルシネーションの抑止を支援

技術的なポイント

本プロジェクトは「スキル」インターフェースを提供することで、Claude Code から NotebookLM を呼び出して自分のノートを根拠に回答を作るフローを実現しています。技術的にはブラウザ自動化(Playwright や Selenium による操作を想定)により NotebookLM のウェブ UI をプログラム的に操作し、ノートの検索や本文取得、引用メタ情報のスクレイピングを行います。こうすることで、公式 API が存在しないか限定的な場合でもユーザーノートを知識ソースとして活用できます。

認証周りは実運用での重要点で、ログイン状態の永続化や Cookie/セッション管理、OTP・多要素認証への対応が課題になります。本リポジトリは「persistent auth」を謳っており、一度認証したブラウザ状態を保存して再利用する設計が含まれているため、都度の手動ログインを減らせます。さらに、取得したノート内容はスキル側で整形・メタ情報紐付け(出典 URL、ページやノート名、スニペット)を行い、Claude 側に渡すレスポンスは引用付きの根拠ベースとなるよう工夫されています。

実装上の注意点として、ブラウザ自動化は UI 変更や要素の変更に脆弱である点、NotebookLM 側の利用規約・自動化ポリシーやレート制限に留意する必要がある点が挙げられます。また、機密性の高いノートを扱う場合は認証情報や保存済みセッションの保護、データの暗号化やアクセス制御を適切に設計する必要があります。将来的には公式 API が提供されれば自動化パスを API ベースへ移行することで堅牢性・効率性が向上します。SKILL.md にスキル登録や呼び出し方法の記載があり、Claude Code のスキル仕様に沿った定義やレスポンス形式の例も含まれている点は導入を容易にします。

さらに、実運用での拡張案としては結果のキャッシュ、セマンティック検索との組み合わせ、取得コンテンツの段階的フィルタリング(メタ→要約→全文取得)やコンプライアンスログの出力などが考えられます。これにより応答速度やプライバシー管理を改善できます。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • LICENSE: file
  • README.md: file
  • SKILL.md: file
  • images: dir

…他 3 ファイル

まとめ

NotebookLM を知識ソースに据えて Claude Code から出典付き回答を出す実用的なスキル実装です。導入や拡張の余地があり実務活用に向くリポジトリです。

リポジトリ情報:

READMEの抜粋:

NotebookLM Claude Code Skill

Let Claude Code chat directly with NotebookLM for zero-hallucination answers based on your own notebooks

Python Claude Code Skill [Based on