# Claude Code用ノートブックLMエージェントスキル

> GoogleのノートブックLMをClaude Codeに直接統合し、アップロードしたドキュメントからソースに基づいた、引用付きの回答を得ることで、幻覚を大幅に削減します。数秒でコーディングワークフローの強化を始めましょう。

- Canonical: https://nanoskill.ai/ja/skills/notebooklm-skill
- Markdown: https://nanoskill.ai/ja/skills/notebooklm-skill.md
- Author: PleasePrompto
- Published: 2026-06-01T07:12:40.837Z
- Updated: 2026-07-23T03:32:43.424Z
- Language: ja
- Source type: github
- Popularity signal: 6754

## Sources

- https://github.com/PleasePrompto/notebooklm-skill

## Install

```shell
npx skills add https://github.com/PleasePrompto/notebooklm-skill
```

## About

Claude Code用ノートブックLMスキルは、Googleの強力なノートブックLMをローカルのClaude Code環境に直接統合し、アップロードしたドキュメントからソースに基づいた、引用付きの回答を提供します。このスキルは、すべての応答が指定されたナレッジベースからのみ導出されることを保証することで、AIの幻覚という一般的な問題を排除します。Claudeがプログラムでノートブックに質問し、情報を統合し、手動のコピー＆ペーストなしで正確な結果を提供できるようにすることで、ワークフローを効率化します。

効率性を追求して設計されたこのスキルは、ノートブックLMのリンクをメタデータ付きで保存できるスマートライブラリ管理などの機能を提供し、Claudeがタスクに最も関連性の高いソースをインテリジェントに選択できるようにします。一回限りのセットアップ後、自動的かつ永続的なGoogle認証が行われ、スキルフォルダ内の自己完結型の隔離されたPython環境で動作するため、クリーンなインストールと他のシステム依存関係との競合がないことを保証します。

ワークショップのマニュアルから特定の技術的詳細を照会する場合でも、内部ドキュメントに基づいて複雑なコードワークフローを構築する場合でも、API仕様を調査する場合でも、ノートブックLMスキルはClaude Codeを高度な情報を持つアシスタントとして機能させます。ドキュメントとの対話方法を変革し、Claudeが包括的な質問をし、さらに詳細を追求し、完全な回答を統合できるようにすることで、より正確なコードと研究成果につなげます。

## Key features

- **ソースに基づいた回答**: アップロードされたドキュメントのみから回答を提供し、情報が利用できない場合は不確実性を示すことで、AIの幻覚を大幅に削減します。
- **Claude Codeへの直接統合**: ブラウザとエディタ間の手動コピー＆ペーストの必要性を排除し、Claudeがプログラム的に質問し、回答を受け取ることができるようにします。
- **スマートライブラリ管理**: タグと説明付きでNotebookLMのリンクを保存し、Claudeが特定のタスクに最も関連性の高いノートブックを自動的に選択できるようにします。
- **自動認証**: 一度だけGoogleログインを行うと、セッションをまたいで認証が持続し、将来の使用がシームレスになります。
- **自己完結型・分離型**: 隔離されたPython環境で、スキルフォルダ内で完全に実行され、グローバルなインストールや競合が発生しません。

## Use cases

- **ワークショップマニュアルの問い合わせ**: アップロードされたワークショップマニュアルから、手動検索なしでブレーキ液の種類、エンジンオイルの仕様、トルク値などの特定の詳細をすばやく取得できます。
- **根拠のある情報でコードを構築**: ドキュメントに基づいて複雑なワークフローやコードを開発し、NotebookLMの合成された回答を活用することで、正確性を確保し、幻覚を回避します。
- **技術文書の調査**: APIドキュメント、内部Wiki、プロジェクトドキュメントについてClaude Codeに手間なく質問し、正確で引用に裏付けられた回答を受け取ります。

## Result preview

「最高のエージェントスキル」に関するノートブックLMから直接生成された実際の洞察とマインドマップをご覧ください。

![the demo of NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-demo-1.jpg)

![the demo of NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-demo-2.jpg)

![the demo of NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-demo-3.jpg)

![the demo of NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-demo-4.jpg)

## Result walkthrough

### ステップ1：インストール

スキルをエージェントに追加します。

![a simple demonstration of the first step in using NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-step-1.jpg)

### ステップ2：ナレッジベースにクエリ

ノートブックLMのノートブックに質問したり、洞察をリクエストしたりします。

![a simple demonstration of the second step in using NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-step-2.jpg)

### ステップ3：結果を確認

回答とその裏付けとなる引用を確認します。

![a simple demonstration of the third step in using NotebookLM Agent Skill for Claude Code](https://file.nanoskill.ai/NotebookLM-step-3.jpg)

## Skill definition

# NotebookLM Claude Code スキル

**[Claude Code](https://github.com/anthropics/claude-code) を NotebookLM と直接会話させ、アップロードしたドキュメントのみに基づいた根拠のある回答を得る**

> このスキルを使用すると、Claude Code から直接 Google NotebookLM ノートブックに問い合わせ、Gemini による根拠に基づいた引用付きの回答を得られます。ブラウザの自動化、ライブラリ管理、永続的な認証。幻覚を大幅に削減 — アップロードしたドキュメントからのみ回答します。

[インストール](#インストール) • [クイックスタート](#クイックスタート) • [なぜNotebookLMなのか](#なぜNotebookLMなのかローカルRAGではないのか) • [仕組み](#仕組み) • [MCPの代替案](https://github.com/PleasePrompto/notebooklm-mcp)

---

## ⚠️ 重要: ローカルのClaude Codeのみ対応

**このスキルはローカルにインストールした [Claude Code](https://github.com/anthropics/claude-code) でのみ動作し、Web UIでは動作しません。**

Web UIはネットワークアクセスのないサンドボックスでスキルを実行しますが、このスキルはブラウザ自動化のためにネットワークアクセスが必要です。必ずお使いのマシンにローカルで [Claude Code](https://github.com/anthropics/claude-code) をインストールしてお使いください。

---

## 問題点

[Claude Code](https://github.com/anthropics/claude-code) に「ローカルのドキュメントを検索して」と指示したとき、以下のような問題が起こります。
- **大量のトークン消費**: ドキュメントを検索するために複数のファイルを繰り返し読み込む
- **不正確な検索**: キーワードで検索するため、文脈やドキュメント間のつながりを見逃す
- **幻覚**: 何か見つからないと、それらしいAPIを捏造してしまう
- **手動のコピー＆ペースト**: NotebookLMのブラウザとエディタを絶えず行き来する

## 解決策

このClaude Codeスキルを使えば、[Claude Code](https://github.com/anthropics/claude-code) が [**NotebookLM**](https://notebooklm.google/) と直接会話できます。NotebookLM は、Gemini 2.5 を搭載した Google の **ソースベースの知識ベース** で、アップロードしたドキュメントのみからインテリジェントに統合された回答を提供します。

```
あなたのタスク → ClaudeがNotebookLMに質問 → Geminiが回答を合成 → Claudeが正しいコードを書く
```

**コピー＆ペーストの繰り返しから解放**: Claudeが直接質問し、CLIに直接回答が返ってきます。自動的な追加質問を通じて深い理解を構築し、具体的な実装詳細、エッジケース、ベストプラクティスを取得します。

---

## なぜNotebookLMなのか？ローカルRAGではないのか？

| アプローチ | トークンコスト | セットアップ時間 | 幻覚 | 回答の品質 |
|----------|------------|------------|----------------|----------------|
| **Claudeにドキュメントを直接与える** | 🔴 非常に高い (複数ファイルの読み込み) | 即時 | あり - ギャップを埋める | 検索結果に依存 |
| **Web検索** | 🟡 中程度 | 即時 | 高い - 信頼できないソース | 当たり外れあり |
| **ローカルRAG** | 🟡 中〜高 | 数時間 (埋め込み、チャンク化) | 中程度 - 検索のギャップ | セットアップに依存 |
| **NotebookLMスキル** | 🟢 最小限 | 5分 | **最小限** - ソースベースのみ | 専門的な合成 |

### NotebookLMが優れている理由

1. **Geminiによる事前処理**: ドキュメントを一度アップロードすれば、すぐに専門知識を取得可能
2. **自然言語Q&A**: 単なる検索ではなく、実際の理解と合成
3. **複数ソースの相関付け**: 50以上のドキュメントにわたる情報を結びつける
4. **引用付き**: すべての回答にソース参照が含まれる
5. **インフラ不要**: ベクトルDB、埋め込み、チャンク戦略が不要

---

## インストール

### 最もシンプルなインストール:

```bash
# 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](https://notebooklm.google.com) にアクセス → ノートブックを作成 → ドキュメントをアップロード:
- 📄 PDF、Googleドキュメント、Markdownファイル
- 🔗 ウェブサイト、GitHubリポジトリ
- 🎥 YouTube動画
- 📚 ノートブックあたり複数のソース

共有: **⚙️ 共有 → リンクを知っている人全員 → コピー**

### 4. ライブラリに追加

**オプションA: Claudeに任せる (スマート追加)**
```
"このノートブックの内容を問い合わせてライブラリに追加: [あなたのリンク]"
```
Claudeが自動的にノートブックに問い合わせて内容を把握し、適切なメタデータとともに追加します。

**オプションB: 手動追加**
```
"このNotebookLMをライブラリに追加: [あなたのリンク]"
```
Claudeが名前とトピックを尋ね、将来の使用に備えて保存します。

### 5. 調査開始

```
"Reactドキュメントにフックについて何て書いてある？"
```

Claudeが自動的に適切なノートブックを選択し、NotebookLMから直接回答を取得します。

---

## 仕組み

これは **Claude Codeスキル** です — ローカルフォルダにClaude Codeが必要に応じて使用できる指示書とスクリプトが含まれています。[MCPサーバーバージョン](https://github.com/PleasePrompto/notebooklm-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は:
1. スキルの指示を読み込む
2. 適切なPythonスクリプトを実行
3. ブラウザを開き、質問を投げかける
4. 回答を直接ユーザーに返す
5. その知識をタスクの支援に活用

---

## コア機能

### **ソースに根ざした応答**
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

![NotebookLMチャット例](https://file.nanoskill.ai/example_notebookchat.png)

### 例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アカウントを使用してください。

---

## トラブルシューティング

### スキルが見つからない
```bash
# 正しい場所にあるか確認
ls ~/.claude/skills/notebooklm/
# SKILL.md、scripts/ などが表示されるはず
```

### 認証の問題
こう言う: `"NotebookLM認証をリセット"`

### ブラウザのクラッシュ
こう言う: `"NotebookLMブラウザデータをクリア"`

### 依存関係の問題
```bash
# 必要に応じて手動再インストール
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サーバー**](https://github.com/PleasePrompto/notebooklm-mcp) に触発されており、Claude Codeスキルとしての代替実装を提供します:
- 両方ともブラウザ自動化にPatchrightを使用（MCPはTypeScript、SkillはPython）
- スキルバージョンはMCPプロトコルを介さずClaude Code内で直接実行
- スキルアーキテクチャに最適化されたステートレス設計

必要なもの:
- **永続的セッション** → [MCPサーバー](https://github.com/PleasePrompto/notebooklm-mcp) を使用
- **複数ツールサポート** (Codex, Cursor) → [MCPサーバー](https://github.com/PleasePrompto/notebooklm-mcp) を使用
- **迅速なClaude Code統合** → このスキルを使用

---

## 結論

**このスキルなし**: NotebookLMをブラウザで開く → 回答をコピー → Claudeに貼り付け → 次の質問をコピー → ブラウザに戻る...

**このスキルあり**: Claudeが直接調査 → 即座に回答を取得 → 正しいコードを書く

コピー＆ペーストの繰り返しをやめましょう。正確で根拠のある回答をClaude Code内で直接取得し始めましょう。

```bash
# 30秒で開始
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# Claude Codeを開いて: "スキルは何がありますか？"
```

---

私の [NotebookLM MCP Server](https://github.com/PleasePrompto/notebooklm-mcp) をClaude Codeスキルにアダプトして構築

Claude Codeで直接、ソースに基づいたドキュメントベースの調査を実現

## FAQ

### Claude Code用のNotebookLMスキルとは何ですか？

NotebookLMスキルを使用すると、Claude CodeはGoogleのNotebookLM（ソースに基づいた知識ベース）と直接対話できます。それにより、Claudeはアップロードされたドキュメントのみから回答を取得し、幻覚を減らし、精度を向上させることができます。

### なぜこのNotebookLMスキルはローカルのClaude Codeインストールでのみ動作するのですか？

このスキルはブラウザ自動化によるNotebookLMとの対話のためにネットワークアクセスを必要とします。ClaudeのWeb UIはネットワークアクセスのないサンドボックス環境でスキルを実行するため、そこでこのスキルを動作させることはできません。ローカルのClaude Codeインストールを使用する必要があります。

### このスキルは、ドキュメントをClaudeに直接与える場合と比べて、どのように幻覚を減らすのですか？

生のドキュメントを渡す代わりに、このスキルはNotebookLMを活用します。NotebookLMはGeminiを使用してドキュメントを前処理し、自然言語によるQ&Aとマルチソースの相関関係を提供し、引用に裏付けられ、アップロードされたコンテンツのみに基づいた専門家の回答を合成します。

### このスキルを使用する際、Googleアカウントのセキュリティは保たれますか？

はい、Chromeはローカルマシン上で実行され、認証情報がコンピュータから出ることはありません。セキュリティ上の懸念がある場合は、Webスクレイピングのベストプラクティスと同様に、自動化用に専用のGoogleアカウントを使用することをお勧めします。

### このスキルとNotebookLM MCPサーバーの主な違いは何ですか？

このスキルは、迅速なClaude Code統合のために設計された、よりシンプルなPythonベースの実装であり、ステートレスモデルでClaudeスキルとして直接実行されます。MCPサーバーはより機能が豊富で、TypeScriptを使用して永続的なセッションとマルチツールサポート（例：Codex、Cursor）を提供します。

### このスキルを使用して、NotebookLMをライブラリに追加するにはどうすればよいですか？

「このNotebookLMをライブラリに追加：\[your-link\]」や「このノートブックの内容について質問し、ライブラリに追加：\[your-link\]」のようなコマンドを使用して、ClaudeにNotebookLMのソースを自動的に追加して分類させることができます。