NotebookLM Claude Code スキル
Claude Code を NotebookLM と直接会話させ、アップロードしたドキュメントのみに基づいた根拠のある回答を得る
このスキルを使用すると、Claude Code から直接 Google NotebookLM ノートブックに問い合わせ、Gemini による根拠に基づいた引用付きの回答を得られます。ブラウザの自動化、ライブラリ管理、永続的な認証。幻覚を大幅に削減 — アップロードしたドキュメントからのみ回答します。
インストール • クイックスタート • なぜNotebookLMなのか • 仕組み • MCPの代替案
⚠️ 重要: ローカルのClaude Codeのみ対応
このスキルはローカルにインストールした Claude Code でのみ動作し、Web UIでは動作しません。
Web UIはネットワークアクセスのないサンドボックスでスキルを実行しますが、このスキルはブラウザ自動化のためにネットワークアクセスが必要です。必ずお使いのマシンにローカルで Claude Code をインストールしてお使いください。
問題点
Claude Code に「ローカルのドキュメントを検索して」と指示したとき、以下のような問題が起こります。
- 大量のトークン消費: ドキュメントを検索するために複数のファイルを繰り返し読み込む
- 不正確な検索: キーワードで検索するため、文脈やドキュメント間のつながりを見逃す
- 幻覚: 何か見つからないと、それらしいAPIを捏造してしまう
- 手動のコピー＆ペースト: NotebookLMのブラウザとエディタを絶えず行き来する
解決策
このClaude Codeスキルを使えば、Claude Code が NotebookLM と直接会話できます。NotebookLM は、Gemini 2.5 を搭載した Google の ソースベースの知識ベース で、アップロードしたドキュメントのみからインテリジェントに統合された回答を提供します。
あなたのタスク → ClaudeがNotebookLMに質問 → Geminiが回答を合成 → Claudeが正しいコードを書く
コピー＆ペーストの繰り返しから解放: Claudeが直接質問し、CLIに直接回答が返ってきます。自動的な追加質問を通じて深い理解を構築し、具体的な実装詳細、エッジケース、ベストプラクティスを取得します。
なぜNotebookLMなのか？ローカルRAGではないのか？
| アプローチ | トークンコスト | セットアップ時間 | 幻覚 | 回答の品質 |
|---|---|---|---|---|
| Claudeにドキュメントを直接与える | 🔴 非常に高い (複数ファイルの読み込み) | 即時 | あり - ギャップを埋める | 検索結果に依存 |
| Web検索 | 🟡 中程度 | 即時 | 高い - 信頼できないソース | 当たり外れあり |
| ローカルRAG | 🟡 中〜高 | 数時間 (埋め込み、チャンク化) | 中程度 - 検索のギャップ | セットアップに依存 |
| NotebookLMスキル | 🟢 最小限 | 5分 | 最小限 - ソースベースのみ | 専門的な合成 |
NotebookLMが優れている理由
- Geminiによる事前処理: ドキュメントを一度アップロードすれば、すぐに専門知識を取得可能
- 自然言語Q&A: 単なる検索ではなく、実際の理解と合成
- 複数ソースの相関付け: 50以上のドキュメントにわたる情報を結びつける
- 引用付き: すべての回答にソース参照が含まれる
- インフラ不要: ベクトルDB、埋め込み、チャンク戦略が不要
インストール
最もシンプルなインストール:
# 1. スキルディレクトリを作成（存在しない場合）
mkdir -p ~/.claude/skills
# 2. このリポジトリをクローン
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# 3. 以上！Claude Codeを開いてこう言うだけ:
"スキルは何がありますか？"
初回使用時に、自動的に以下を実行します:
- 独立したPython環境 (
.venv) を作成 - Google Chrome を含むすべての依存関係をインストール
- 最大の信頼性を得るために Chromium ではなく Chrome を使用してブラウザ自動化をセットアップ
- すべてはスキルフォルダ内に留まります
注意: クロスプラットフォームの信頼性、一貫したブラウザフィンガープリント、Googleサービスへの検出回避のために、Chromium ではなく実際の Chrome を使用します
クイックスタート
1. スキルを確認
Claude Codeでこう言います:
"何のスキルがありますか？"
ClaudeがNotebookLMを含む利用可能なスキル一覧を表示します。
2. Google認証（初回のみ）
"NotebookLM認証をセットアップ"
Chromeウィンドウが開く → Googleアカウントでログイン
3. 知識ベースを作成
notebooklm.google.com にアクセス → ノートブックを作成 → ドキュメントをアップロード:
- 📄 PDF、Googleドキュメント、Markdownファイル
- 🔗 ウェブサイト、GitHubリポジトリ
- 🎥 YouTube動画
- 📚 ノートブックあたり複数のソース
共有: ⚙️ 共有 → リンクを知っている人全員 → コピー
4. ライブラリに追加
オプションA: Claudeに任せる (スマート追加)
"このノートブックの内容を問い合わせてライブラリに追加: [あなたのリンク]"
Claudeが自動的にノートブックに問い合わせて内容を把握し、適切なメタデータとともに追加します。
オプションB: 手動追加
"このNotebookLMをライブラリに追加: [あなたのリンク]"
Claudeが名前とトピックを尋ね、将来の使用に備えて保存します。
5. 調査開始
"Reactドキュメントにフックについて何て書いてある？"
Claudeが自動的に適切なノートブックを選択し、NotebookLMから直接回答を取得します。
仕組み
これは Claude Codeスキル です — ローカルフォルダにClaude Codeが必要に応じて使用できる指示書とスクリプトが含まれています。MCPサーバーバージョン とは異なり、別途サーバーを必要とせず、Claude Code内で直接動作します。
MCPサーバーとの主な違い
| 機能 | このスキル | MCPサーバー |
|---|---|---|
| プロトコル | Claude Skills | Model Context Protocol |
| インストール | ~/.claude/skills にクローン | claude mcp add ... |
| セッション | 各質問ごとに新しいブラウザ | 永続的なチャットセッション |
| 互換性 | Claude Code のみ (ローカル) | Claude Code, Codex, Cursor など |
| 言語 | Python | TypeScript |
| 配布 | Gitクローン | npmパッケージ |
アーキテクチャ
~/.claude/skills/notebooklm/
├── SKILL.md # Claudeへの指示
├── scripts/ # Python自動化スクリプト
│ ├── ask_question.py # NotebookLMへの問い合わせ
│ ├── notebook_manager.py # ライブラリ管理
│ └── auth_manager.py # Google認証
├── .venv/ # 分離されたPython環境 (自動生成)
└── data/ # ローカルノートブックライブラリ
NotebookLMに言及したりノートブックURLを送ると、Claudeは:
- スキルの指示を読み込む
- 適切なPythonスクリプトを実行
- ブラウザを開き、質問を投げかける
- 回答を直接ユーザーに返す
- その知識をタスクの支援に活用
コア機能
ソースに根ざした応答
NotebookLMはアップロードされたドキュメントのみから回答することで幻覚を大幅に削減します。情報がない場合は、でっち上げるのではなく不確実性を示します。
直接統合
ブラウザとエディタ間のコピー＆ペーストが不要。Claudeがプログラム的に質問し、回答を受け取ります。
スマートライブラリ管理
タグや説明とともにNotebookLMリンクを保存。Claudeがタスクに最適なノートブックを自動選択します。
自動認証
初回のGoogleログイン後、認証情報はセッションを超えて持続します。
自己完結型
すべてがスキルフォルダ内の分離されたPython環境で実行。グローバルなインストール不要。
人間らしい自動化
検出を避けるため、リアルなタイピング速度やインタラクションパターンを使用。
よく使うコマンド
| 言うこと | 起こること |
|---|---|
| "NotebookLM認証をセットアップ" | Googleログイン用にChromeを開く |
| "[リンク] をNotebookLMライブラリに追加" | メタデータ付きでノートブックを保存 |
| "NotebookLMノートブックを表示" | 保存された全ノートブックを一覧表示 |
| "APIドキュメントに [トピック] について質問して" | 関連ノートブックに問い合わせ |
| "Reactノートブックを使う" | アクティブなノートブックを設定 |
| "NotebookLMデータをクリア" | 初期化（ライブラリは保持） |
実際の例
例1: ワークショップマニュアルの問い合わせ
ユーザーの依頼: "スズキ GSR 600 のワークショップマニュアルで、ブレーキフルードの種類、エンジンオイルの規格、リアアクスルのトルクを調べて"
Claudeが自動的に:
- NotebookLMで認証
- 各仕様について包括的な質問を行う
- "それで全てですか？" という追加質問に促された際にフォローアップ
- 正確な仕様を提供: DOT 4 ブレーキフルード、SAE 10W-40 オイル、リアアクスルトルク 100 N·m
例2: 幻覚なしで構築
あなた: "Gmailスパムフィルタ用のn8nワークフローを構築する必要がある。n8nノートブックを使って"
Claudeの内部プロセス:
→ NotebookLMスキルをロード
→ n8nノートブックをアクティブ化
→ フォローアップを含む包括的な質問をする
→ 複数の問い合わせから完全な回答を合成
結果: 一発で動作するワークフロー。幻覚APIのデバッグ不要。
技術詳細
コアテクノロジー
- Patchright: ブラウザ自動化ライブラリ (Playwrightベース)
- Python: このスキルの実装言語
- ステルス技術: 人間らしいタイピングとインタラクションパターン
注: MCPサーバーは同じPatchrightライブラリを使用しますが、TypeScript/npmエコシステム経由です。
依存関係
- patchright==1.55.2: ブラウザ自動化
- python-dotenv==1.0.0: 環境設定
- 初回使用時に
.venvに自動インストール
データストレージ
すべてのデータはスキルディレクトリ内にローカル保存されます:
~/.claude/skills/notebooklm/data/
├── library.json - メタデータ付きのノートブックライブラリ
├── auth_info.json - 認証ステータス情報
└── browser_state/ - ブラウザのCookieとセッションデータ
重要なセキュリティ注意事項:
data/ディレクトリには機密の認証データと個人のノートブックが含まれます.gitignoreによりGitから自動的に除外されますdata/ディレクトリの内容を手動でコミットしたり共有したりしないでください
セッションモデル
MCPサーバーとは異なり、このスキルは ステートレスモデル を使用します:
- 各質問ごとに新しいブラウザを開く
- 質問をし、回答を得る
- Claudeにさらなる質問を促すフォローアッププロンプトを追加
- 即座にブラウザを閉じる
これが意味すること:
- 永続的なチャットコンテキストはない
- 各質問は独立している
- しかしノートブックライブラリは持続する
- フォローアップメカニズム: 各回答には "それで全てですか？" を含め、Claudeに包括的なフォローアップを促す
複数ステップのリサーチでは、必要に応じてClaudeが自動的に追加質問を行います。
制限事項
スキル固有の制限
- ローカルClaude Codeのみ - Web UIでは動作しません（サンドボックス制限）
- セッション持続性なし - 各質問は独立している
- フォローアップコンテキストなし - 前回の回答を参照できない
NotebookLM
- レート制限 - 無料枠には1日の問い合わせ制限あり
- 手動アップロード - 最初にNotebookLMにドキュメントをアップロードする必要あり
- 共有要件 - ノートブックは公開共有されている必要あり
FAQ
Claude Web UIで動作しないのはなぜですか？ Web UIはネットワークアクセスのないサンドボックスでスキルを実行します。ブラウザ自動化はNotebookLMに到達するためにネットワークアクセスが必要です。
MCPサーバーとどう違いますか？ これはよりシンプルなPythonベースの実装で、Claudeスキルとして直接動作します。MCPサーバーは永続的セッションなどの機能が豊富で、複数のツール（Codex、Cursorなど）で動作します。
このスキルとMCPサーバーの両方を使えますか？ はい！ 異なる目的に使用します。スキルは手軽なClaude Code統合用、MCPサーバーは永続的セッションとマルチツールサポート用です。
Chromeがクラッシュしたら？
実行: "NotebookLMブラウザデータをクリア" して再試行してください。
Googleアカウントは安全ですか？ Chromeはお使いのマシン上でローカルに実行されます。認証情報がお使いのコンピュータを離れることはありません。心配な場合は専用のGoogleアカウントを使用してください。
トラブルシューティング
スキルが見つからない
# 正しい場所にあるか確認
ls ~/.claude/skills/notebooklm/
# SKILL.md、scripts/ などが表示されるはず
認証の問題
こう言う: "NotebookLM認証をリセット"
ブラウザのクラッシュ
こう言う: "NotebookLMブラウザデータをクリア"
依存関係の問題
# 必要に応じて手動再インストール
cd ~/.claude/skills/notebooklm
rm -rf .venv
python -m venv .venv
source .venv/bin/activate # Windowsでは .venv\Scripts\activate
pip install -r requirements.txt
免責事項
このツールはNotebookLMとのブラウザインタラクションを自動化し、ワークフローを効率化します。ただし、いくつかの注意点:
ブラウザ自動化について: 自動化をより自然に見せるためにヒューマナイゼーション機能（リアルなタイピング速度、自然な遅延、マウスの動き）を組み込んでいますが、Googleが自動化された使用を検出またはフラグ付けしないことを保証するものではありません。メインのアカウントではなく、自動化用に専用のGoogleアカウントを使用することをお勧めします。Webスクレイピングと同様に、おそらく大丈夫ですが、安全側に倒すのが賢明です！
CLIツールとAIエージェントについて: Claude Code、CodexなどのCLIツールや同様のAIアシスタントは非常に強力ですが、ミスを犯す可能性があります。注意と認識を持って使用してください:
- コミットやデプロイの前に必ず変更を確認する
- 最初に安全な環境でテストする
- 重要な作業のバックアップを取る
- 覚えておいてください: AIエージェントはアシスタントであり、絶対確実な託宣ではありません
このツールは、NotebookLMとエディタの間でのコピー＆ペーストの繰り返しにうんざりして自分用に作りました。他の人にも役立つことを願って共有していますが、問題、データ損失、アカウントトラブルなどが発生しても責任は負いかねます。ご自身の判断と裁量でご使用ください。
いずれにせよ、問題が発生したり質問があれば、GitHubでIssueを遠慮なく開いてください。トラブルシューティングのお手伝いを喜んでします！
クレジット
このスキルは私の NotebookLM MCPサーバー に触発されており、Claude Codeスキルとしての代替実装を提供します:
- 両方ともブラウザ自動化にPatchrightを使用（MCPはTypeScript、SkillはPython）
- スキルバージョンはMCPプロトコルを介さずClaude Code内で直接実行
- スキルアーキテクチャに最適化されたステートレス設計
必要なもの:
- 永続的セッション → MCPサーバー を使用
- 複数ツールサポート (Codex, Cursor) → MCPサーバー を使用
- 迅速なClaude Code統合 → このスキルを使用
結論
このスキルなし: NotebookLMをブラウザで開く → 回答をコピー → Claudeに貼り付け → 次の質問をコピー → ブラウザに戻る...
このスキルあり: Claudeが直接調査 → 即座に回答を取得 → 正しいコードを書く
コピー＆ペーストの繰り返しをやめましょう。正確で根拠のある回答をClaude Code内で直接取得し始めましょう。
# 30秒で開始
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# Claude Codeを開いて: "スキルは何がありますか？"
私の NotebookLM MCP Server をClaude Codeスキルにアダプトして構築
Claude Codeで直接、ソースに基づいたドキュメントベースの調査を実現