# 클로드 코드를 위한 노트북LM 에이전트 스킬

> 구글의 노트북LM을 클로드 코드에 직접 통합하여 업로드한 문서에서 제공되는, 출처에 기반하고 인용이 뒷받침되는 답변을 얻어 환각 현상을 획기적으로 줄입니다. 몇 초 만에 코딩 워크플로우를 향상시키세요.

- Canonical: https://nanoskill.ai/ko/skills/notebooklm-skill
- Markdown: https://nanoskill.ai/ko/skills/notebooklm-skill.md
- Author: PleasePrompto
- Published: 2026-06-01T07:12:40.837Z
- Updated: 2026-07-23T03:32:43.424Z
- Language: ko
- 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

클로드 코드를 위한 노트북LM 스킬은 구글의 강력한 노트북LM을 로컬 클로드 코드 환경에 직접 통합하여, 업로드한 문서에서 출처에 기반하고 인용이 뒷받침되는 답변을 제공합니다. 이 스킬은 모든 응답이 오직 지정된 지식 베이스에서만 도출되도록 보장함으로써 AI 환각이라는 흔한 문제를 없앱니다. 클로드가 노트북에 프로그래밍 방식으로 쿼리하고, 정보를 종합하며, 수동으로 복사하여 붙여넣기 할 필요 없이 정확한 결과를 제공할 수 있게 하여 작업 흐름을 간소화합니다.

효율성을 위해 설계된 이 스킬은 스마트 라이브러리 관리와 같은 기능을 제공하며, 노트북LM 링크를 메타데이터와 함께 저장하여 클로드가 작업에 가장 적합한 소스를 지능적으로 선택할 수 있도록 합니다. 한 번 설정하면 지속되는 자동 구글 인증을 포함하며, 스킬 폴더 내에 자체 완비된 격리된 파이썬 환경에서 작동하여 깔끔한 설치와 다른 시스템 종속성과의 충돌이 없도록 보장합니다.

특정 기술 세부 사항을 위해 워크샵 매뉴얼을 쿼리하든, 내부 문서를 기반으로 복잡한 코드 워크플로우를 구축하든, API 사양을 연구하든, 노트북LM 스킬은 클로드 코드가 매우 박식한 어시스턴트 역할을 할 수 있도록 지원합니다. 문서와 상호 작용하는 방식을 변화시켜, 클로드가 포괄적인 질문을 하고, 더 많은 세부 사항을 후속 질문하며, 완전한 답변을 종합할 수 있게 하여 보다 정확한 코드와 연구 결과로 이어집니다.

## Key features

- **소스 기반 응답**: 업로드된 문서에서만 답변을 제공하여 AI 환각을 크게 줄이고 정보가 없을 때는 불확실성을 표시합니다.
- **직접적인 Claude Code 통합**: 브라우저와 편집기 간의 수동 복사-붙여넣기가 필요 없어지며, Claude가 프로그래밍 방식으로 질문하고 답변을 받을 수 있습니다.
- **스마트 라이브러리 관리**: NotebookLM 링크를 태그와 설명과 함께 저장하여 Claude가 작업에 가장 관련성 높은 노트북을 자동으로 선택하게 합니다.
- **자동 인증**: 일회성 Google 로그인을 수행하면 인증이 세션 간에 유지되어 나중에 원활하게 사용할 수 있습니다.
- **자체 포함 및 격리**: 격리된 Python 환경으로 Skill 폴더 내에서만 완전히 실행되므로 전역 설치나 충돌이 없습니다.

## Use cases

- **워크숍 매뉴얼 쿼리**: 수동 검색 없이 업로드된 워크숍 매뉴얼에서 브레이크 액 종류, 엔진 오일 사양, 토크 값과 같은 특정 세부 정보를 빠르게 찾을 수 있습니다.
- **근거 기반 정보로 코드 구축**: 문서를 기반으로 복잡한 워크플로나 코드를 개발하여 NotebookLM의 종합된 답변을 활용해 정확성을 보장하고 환각을 방지합니다.
- **기술 문서 조사**: API 문서, 사내 위키 또는 프로젝트 문서에 대해 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과 직접 대화하여 업로드한 문서에 기반한 출처 있는 답변을 받아보세요.**

> 이 스킬을 사용하면 클로드 코드에서 바로 Google NotebookLM 노트북에 질문하여 Gemini가 제공하는 출처와 인용이 포함된 답변을 얻을 수 있습니다. 브라우저 자동화, 라이브러리 관리, 인증 유지. 환각(hallucination) 현상이 획기적으로 줄어듭니다 - 오직 업로드한 문서에서만 답변합니다.

[설치](#installation) • [빠른 시작](#quick-start) • [NotebookLM을 써야 하는 이유](#why-notebooklm-not-local-rag) • [작동 방식](#how-it-works) • [MCP 대안](https://github.com/PleasePrompto/notebooklm-mcp)

---

## ⚠️ 중요: 로컬 클로드 코드 전용

**이 스킬은 로컬 [Claude Code](https://github.com/anthropics/claude-code) 설치 환경에서만 작동하며, 웹 UI에서는 사용할 수 없습니다.**

웹 UI는 네트워크 접근이 제한된 샌드박스에서 스킬을 실행하지만, 이 스킬은 브라우저 자동화를 위해 네트워크 접근이 필요합니다. 반드시 로컬 머신에서 [Claude Code](https://github.com/anthropics/claude-code)를 사용해야 합니다.

---

## 문제점

클로드 코드에 "로컬 문서를 검색해줘"라고 하면 다음과 같은 일이 벌어집니다:
- **엄청난 토큰 소비**: 문서 검색이 여러 파일을 반복해서 읽는 것을 의미
- **부정확한 검색**: 키워드로만 검색하고 문맥과 문서 간 연결을 놓침
- **환각** : 무언가 찾지 못하면 그럴듯한 API를 지어냄
- **수동 복붙**: 노트북LM 화면과 에디터를 계속 오가며 복사 붙여넣기

## 해결책

이 클로드 코드 스킬은 [**NotebookLM**](https://notebooklm.google/) — Gemini 2.5 기반의 Google **소스 기반 지식 베이스** — 과 직접 대화하게 해줍니다. 오직 업로드한 문서만을 바탕으로 지능적으로 종합된 답변을 제공합니다.

```
작업 → Claude가 NotebookLM에 질문 → Gemini가 답변 종합 → Claude가 올바른 코드 작성
```

**더 이상 복붙 댄스가 필요 없습니다**: Claude가 직접 질문하고 CLI에서 바로 답변을 받습니다. 자동 후속 질문을 통해 깊은 이해를 쌓으며 구체적인 구현 세부 사항, 엣지 케이스, 모범 사례까지 파악합니다.

---

## 왜 NotebookLM인가, 로컬 RAG가 아닌?

| 접근 방식 | 토큰 비용 | 설정 시간 | 환각 | 답변 품질 |
|----------|------------|------------|----------------|----------------|
| **문서를 Claude에 직접 제공** | 🔴 매우 높음 (여러 파일 읽기) | 즉시 | 있음 - 빈틈을 메움 | 가변적 검색 |
| **웹 검색** | 🟡 중간 | 즉시 | 높음 - 신뢰할 수 없는 출처 | 들쑥날쑥 |
| **로컬 RAG** | 🟡 중간~높음 | 수 시간 (임베딩, 청킹) | 중간 - 검색 공백 | 설정에 따라 다름 |
| **NotebookLM 스킬** | 🟢 최소 | 5분 | **최소** - 소스 기반 답변만 | 전문가 수준 종합 |

### NotebookLM이 뛰어난 이유

1. **Gemini 사전 처리**: 문서를 한 번 업로드하면 즉시 전문가 지식을 얻음
2. **자연어 질의응답**: 단순 검색이 아닌 실제 이해와 종합
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. 끝! 클로드 코드를 열고 말하세요:
"내 스킬은 뭐가 있어?"
```

처음 스킬을 사용하면 자동으로:
- 격리된 Python 환경(`.venv`)을 생성합니다
- **Google Chrome**을 포함한 모든 의존성을 설치합니다
- 최대한의 안정성을 위해 크로미움 대신 Chrome으로 브라우저 자동화를 설정합니다
- 모든 것이 스킬 폴더 안에 격리되어 유지됩니다

**참고:** 크로미움 대신 실제 Chrome을 사용하는 이유는 크로스 플랫폼 안정성, 일관된 브라우저 지문, 향상된 안티 디텍션 기능 때문입니다.

---

## 빠른 시작

### 1. 스킬 확인

클로드 코드에서 말하세요:
```
"내 스킬은 뭐가 있어?"
```

클로드가 NotebookLM을 포함한 사용 가능한 스킬 목록을 보여줍니다.

### 2. Google 인증 (1회)

```
"NotebookLM 인증 설정해줘"
```
*Chrome 창이 열리고 → Google 계정으로 로그인*

### 3. 지식 베이스 만들기

[notebooklm.google.com](https://notebooklm.google.com)으로 이동 → 노트북 만들기 → 문서 업로드:
- 📄 PDF, Google Docs, 마크다운 파일
- 🔗 웹사이트, GitHub 저장소
- 🎥 YouTube 동영상
- 📚 하나의 노트북에 여러 소스

공유: **⚙️ 공유 → 링크 있는 모든 사용자 → 복사**

### 4. 라이브러리에 추가

**방법 A: Claude가 파악하도록 하기 (스마트 추가)**
```
"이 노트북의 내용에 대해 질문하고 내 라이브러리에 추가해줘: [링크]"
```
Claude가 자동으로 노트북 내용을 파악하기 위해 질문한 후 적절한 메타데이터와 함께 추가합니다.

**방법 B: 수동 추가**
```
"이 NotebookLM을 내 라이브러리에 추가해줘: [링크]"
```
Claude가 이름과 주제를 물어본 후 나중에 사용할 수 있도록 저장합니다.

### 5. 연구 시작

```
"내 React 문서에서 훅에 대해 뭐라고 돼 있어?"
```

Claude가 자동으로 알맞은 노트북을 선택하고 NotebookLM에서 바로 답변을 가져옵니다.

---

## 작동 방식

이것은 **Claude Code 스킬**입니다 - 필요한 경우 클로드 코드가 사용할 수 있는 명령어와 스크립트가 포함된 로컬 폴더입니다. [MCP 서버 버전](https://github.com/PleasePrompto/notebooklm-mcp)과 달리 별도의 서버 없이 클로드 코드에서 직접 실행됩니다.

### MCP 서버와의 주요 차이점

| 기능 | 이 스킬 | MCP 서버 |
|---------|------------|------------|
| **프로토콜** | Claude Skills | Model Context Protocol |
| **설치** | `~/.claude/skills`에 클론 | `claude mcp add ...` |
| **세션** | 질문마다 새로운 브라우저 | 영구 채팅 세션 |
| **호환성** | 클로드 코드 전용 (로컬) | 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 인증 설정해줘"* | Chrome을 열어 Google 로그인을 진행 |
| *"[링크]를 내 NotebookLM 라이브러리에 추가해줘"* | 메타데이터와 함께 노트북 저장 |
| *"내 NotebookLM 노트북 보여줘"* | 저장된 모든 노트북 나열 |
| *"내 API 문서에서 [주제]에 대해 물어봐"* | 관련 노트북에 질문 |
| *"React 노트북 사용해"* | 활성 노트북 설정 |
| *"NotebookLM 데이터 지워줘"* | 새로 시작 (라이브러리는 유지) |

---

## 실제 사례

### 사례 1: 워크샵 매뉴얼 질문

**사용자**: "내 Suzuki GSR 600 워크샵 매뉴얼에서 브레이크 액 종류, 엔진 오일 사양, 리어 액슬 토크를 확인해줘."

**Claude 자동 수행**:
- NotebookLM 인증
- 각 사양에 대해 포괄적인 질문
- "이게 알아야 할 전부입니까?"라는 프롬프트를 받으면 후속 질문
- 정확한 사양 제공: DOT 4 브레이크 액, SAE 10W-40 오일, 리어 액슬 토크 100 N·m

![NotebookLM Chat Example](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/     - 브라우저 쿠키 및 세션 데이터
```

**중요 보안 참고 사항:**
- `data/` 디렉터리에는 민감한 인증 데이터와 개인 노트북이 포함됩니다.
- `.gitignore`를 통해 git에서 자동 제외됩니다.
- 절대 `data/` 디렉터리의 내용을 수동으로 커밋하거나 공유하지 마세요.

### 세션 모델

MCP 서버와 달리 이 스킬은 **상태 비저장 모델**을 사용합니다:
- 각 질문마다 새 브라우저를 엽니다.
- 질문을 하고 답변을 받습니다.
- Claude가 더 많은 질문을 하도록 유도하는 후속 프롬프트를 추가합니다.
- 브라우저를 즉시 닫습니다.

즉:
- 영구적인 채팅 컨텍스트가 없습니다.
- 각 질문은 독립적입니다.
- 하지만 노트북 라이브러리는 지속됩니다.
- **후속 메커니즘**: 각 답변에는 "이게 알아야 할 전부입니까?"라는 메시지가 포함되어 Claude가 포괄적인 후속 질문을 하도록 유도합니다.

다단계 연구 시 Claude는 필요할 때 자동으로 후속 질문을 합니다.

---

## 제한 사항

### 스킬 자체 제한
- **로컬 클로드 코드 전용** - 웹 UI에서는 작동하지 않음 (샌드박스 제한)
- **세션 지속성 없음** - 각 질문은 독립적
- **후속 컨텍스트 없음** - "이전 답변"을 참조할 수 없음

### NotebookLM 제한
- **속도 제한** - 무료 티어는 일일 질의 제한 있음
- **수동 업로드** - 먼저 NotebookLM에 문서를 업로드해야 함
- **공유 요구사항** - 노트북을 공개적으로 공유해야 함

---

## 자주 묻는 질문

**클로드 웹 UI에서 작동하지 않는 이유는?**
웹 UI는 네트워크 접근이 없는 샌드박스에서 스킬을 실행합니다. 브라우저 자동화는 NotebookLM에 도달하기 위해 네트워크 접근이 필요합니다.

**MCP 서버와 어떻게 다른가요?**
이것은 Claude Skill로 직접 실행되는 더 간단한 Python 기반 구현입니다. MCP 서버는 영구 세션과 더 풍부한 기능을 갖추고 있으며 여러 도구(Codex, Cursor 등)와 연동됩니다.

**이 스킬과 MCP 서버를 함께 사용할 수 있나요?**
네! 서로 다른 목적을 수행합니다. 빠른 클로드 코드 통합에는 스킬을, 영구 세션과 다중 도구 지원이 필요하면 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 계정을 사용하는 것이 좋습니다 — 웹 스크래핑처럼: 아마 괜찮겠지만, 조심해서 나쁠 건 없으니까요!

**CLI 도구와 AI 에이전트에 관해:**
Claude Code, Codex 같은 CLI 도구와 AI 기반 어시스턴트는 엄청나게 강력하지만 실수할 수 있습니다. 주의를 기울여 사용하세요:
- 커밋이나 배포 전에 변경 사항을 항상 검토하세요.
- 먼저 안전한 환경에서 테스트하세요.
- 중요한 작업은 백업을 유지하세요.
- 기억하세요: AI 에이전트는 조수일 뿐, 무오류의 신탁이 아닙니다.

저는 NotebookLM과 에디터를 오가며 복사 붙여넣기 하는 데 지겨워서 이 도구를 만들었습니다. 다른 분들에게도 도움이 되길 바라는 마음으로 공유하지만, 발생할 수 있는 문제, 데이터 손실, 계정 문제에 대해 책임을 질 수는 없습니다. 자신의 판단과 책임 하에 사용해 주세요.

물론, 문제가 생기거나 질문이 있다면 GitHub에 이슈를 열어주세요. 문제 해결을 도와드리겠습니다!

---

## 크레딧

이 스킬은 제 [**NotebookLM MCP 서버**](https://github.com/PleasePrompto/notebooklm-mcp)에서 영감을 받아 Claude Code Skill로 구현한 대안입니다:
- 두 버전 모두 Patchright를 브라우저 자동화에 사용합니다 (MCP는 TypeScript, Skill은 Python).
- Skill 버전은 MCP 프로토콜 없이 Claude Code에서 직접 실행됩니다.
- 스킬 아키텍처에 최적화된 상태 비저장 설계.

필요에 따라 선택하세요:
- **영구 세션** → [MCP 서버](https://github.com/PleasePrompto/notebooklm-mcp) 사용
- **다중 도구 지원** (Codex, Cursor) → [MCP 서버](https://github.com/PleasePrompto/notebooklm-mcp) 사용
- **빠른 Claude Code 통합** → 이 스킬 사용

---

## 핵심 요약

**이 스킬 없이**: NotebookLM을 브라우저에서 열고 → 답변 복사 → Claude에 붙여넣기 → 다음 질문 복사 → 다시 브라우저로...

**이 스킬과 함께**: Claude가 직접 조사 → 즉시 답변 획득 → 올바른 코드 작성

복사 붙여넣기 댄스를 멈추고, 클로드 코드에서 직접 정확하고 근거 있는 답변을 받아보세요.

```bash
# 30초 만에 시작하기
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# 클로드 코드 열고: "내 스킬은 뭐가 있어?"
```

---

이것은 제 [NotebookLM MCP 서버](https://github.com/PleasePrompto/notebooklm-mcp)의 클로드 코드 스킬 버전입니다.

클로드 코드 안에서 직접 소스 기반, 문서 기반 연구를 위해

## FAQ

### Claude Code용 NotebookLM Skill이란 무엇인가요?

NotebookLM Skill은 Claude Code가 Google의 NotebookLM과 직접 상호 작용할 수 있게 합니다. NotebookLM은 소스 기반 지식 베이스로, 업로드한 문서에서만 답변을 얻을 수 있어 환각을 줄이고 정확도를 향상시킵니다.

### 이 NotebookLM Skill이 로컬 Claude Code 설치에서만 작동하는 이유는 무엇인가요?

이 Skill은 NotebookLM과 상호 작용하기 위해 브라우저 자동화를 위한 네트워크 액세스가 필요합니다. Claude 웹 UI는 네트워크 액세스가 없는 샌드박스 환경에서 Skill을 실행하므로 이 Skill이 그곳에서 작동하지 않습니다. 로컬 Claude Code 설치를 사용해야 합니다.

### 이 Skill이 문서를 Claude에 직접 제공하는 것보다 어떻게 환각을 줄이나요?

원시 문서를 제공하는 대신 이 Skill은 NotebookLM을 활용합니다. NotebookLM은 Gemini를 사용하여 문서를 전처리합니다. NotebookLM은 자연어 Q&A와 다중 소스 상관관계를 제공하여, 업로드한 콘텐츠에만 기반하고 인용으로 뒷받침되는 전문가 수준의 답변을 종합합니다.

### 이 Skill을 사용할 때 내 Google 계정은 안전한가요?

네, Chrome은 사용자의 컴퓨터에서 로컬로 실행되며 자격 증명이 컴퓨터를 떠나지 않습니다. 보안이 우려된다면 웹 스크래핑 모범 사례와 유사하게 자동화 전용 Google 계정을 사용하는 것이 좋습니다.

### 이 Skill과 NotebookLM MCP 서버의 주요 차이점은 무엇인가요?

이 Skill은 Claude Code와 빠르게 통합되도록 설계된 더 간단한 Python 기반 구현으로, 상태 비저장 모델을 사용하여 Claude Skill로 직접 실행됩니다. MCP 서버는 TypeScript를 사용하여 지속적인 세션과 여러 도구 지원(예: Codex, Cursor)을 제공하는 더 기능이 풍부한 버전입니다.

### 이 Skill을 사용하여 내 라이브러리에 NotebookLM을 어떻게 추가하나요?

"이 NotebookLM을 내 라이브러리에 추가: \[your-link\]" 또는 "이 노트북의 콘텐츠에 대해 질문하고 내 라이브러리에 추가: \[your-link\]"와 같은 명령을 사용하여 Claude가 자동으로 NotebookLM 소스를 추가하고 분류하도록 할 수 있습니다.