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

NotebookLM Claude Code 스킬

클로드 코드(Claude Code)가 NotebookLM과 직접 대화하여 업로드한 문서에 기반한 출처 있는 답변을 받아보세요.

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

설치 • 빠른 시작 • NotebookLM을 써야 하는 이유 • 작동 방식 • MCP 대안

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

이 스킬은 로컬 Claude Code 설치 환경에서만 작동하며, 웹 UI에서는 사용할 수 없습니다.

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

문제점

클로드 코드에 "로컬 문서를 검색해줘"라고 하면 다음과 같은 일이 벌어집니다:

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

해결책

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

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

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

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

NotebookLM이 뛰어난 이유

1. Gemini 사전 처리: 문서를 한 번 업로드하면 즉시 전문가 지식을 얻음
2. 자연어 질의응답: 단순 검색이 아닌 실제 이해와 종합
3. 다중 소스 연계: 50개 이상의 문서에 걸친 정보 연결
4. 인용 포함: 모든 답변에 출처 표시
5. 인프라 불필요: 벡터 DB, 임베딩, 청킹 전략 필요 없음

설치

가장 간단한 설치 방법:

# 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으로 이동 → 노트북 만들기 → 문서 업로드:

• 📄 PDF, Google Docs, 마크다운 파일
• 🔗 웹사이트, GitHub 저장소
• 🎥 YouTube 동영상
• 📚 하나의 노트북에 여러 소스

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

4. 라이브러리에 추가

방법 A: Claude가 파악하도록 하기 (스마트 추가)

"이 노트북의 내용에 대해 질문하고 내 라이브러리에 추가해줘: [링크]"

Claude가 자동으로 노트북 내용을 파악하기 위해 질문한 후 적절한 메타데이터와 함께 추가합니다.

방법 B: 수동 추가

"이 NotebookLM을 내 라이브러리에 추가해줘: [링크]"

Claude가 이름과 주제를 물어본 후 나중에 사용할 수 있도록 저장합니다.

5. 연구 시작

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

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

작동 방식

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

MCP 서버와의 주요 차이점

아키텍처

~/.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 환경과 함께 스킬 폴더 안에서 실행됩니다. 전역 설치가 필요 없습니다.

사람 같은 자동화

탐지를 피하기 위해 실제와 같은 타이핑 속도와 상호 작용 패턴을 사용합니다.

자주 쓰는 명령어

실제 사례

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

사용자: "내 Suzuki 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/     - 브라우저 쿠키 및 세션 데이터

중요 보안 참고 사항:

• 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 계정을 사용하세요.

문제 해결

스킬을 찾을 수 없음

# 올바른 위치에 있는지 확인
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 계정을 사용하는 것이 좋습니다 — 웹 스크래핑처럼: 아마 괜찮겠지만, 조심해서 나쁠 건 없으니까요!

CLI 도구와 AI 에이전트에 관해: Claude Code, Codex 같은 CLI 도구와 AI 기반 어시스턴트는 엄청나게 강력하지만 실수할 수 있습니다. 주의를 기울여 사용하세요:

• 커밋이나 배포 전에 변경 사항을 항상 검토하세요.
• 먼저 안전한 환경에서 테스트하세요.
• 중요한 작업은 백업을 유지하세요.
• 기억하세요: AI 에이전트는 조수일 뿐, 무오류의 신탁이 아닙니다.

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

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

크레딧

이 스킬은 제 NotebookLM MCP 서버에서 영감을 받아 Claude Code Skill로 구현한 대안입니다:

• 두 버전 모두 Patchright를 브라우저 자동화에 사용합니다 (MCP는 TypeScript, Skill은 Python).
• Skill 버전은 MCP 프로토콜 없이 Claude Code에서 직접 실행됩니다.
• 스킬 아키텍처에 최적화된 상태 비저장 설계.

필요에 따라 선택하세요:

• 영구 세션 → MCP 서버 사용
• 다중 도구 지원 (Codex, Cursor) → MCP 서버 사용
• 빠른 Claude Code 통합 → 이 스킬 사용

핵심 요약

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

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

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

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

이것은 제 NotebookLM MCP 서버의 클로드 코드 스킬 버전입니다.

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