NotebookLM 자동화 (notebooklm-py)
Google NotebookLM을 명령줄로 완전 자동화해 노트북 생성부터 팟캐스트·영상·퀴즈 생성과 다운로드까지 처리하는 스킬.
자동화·워크플로중급★ 18,582⑂ 2,501AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
Google NotebookLM을 브라우저 클릭 없이 CLI로 조작합니다. 노트북 생성, URL·YouTube·PDF·오디오·영상·이미지 소스 추가, 소스 기반 채팅(인용 포함), 그리고 오디오 개요(팟캐스트)·영상·슬라이드 덱·인포그래픽·리포트·마인드맵·데이터 테이블·퀴즈·플래시카드 등 모든 산출물 생성과 다운로드를 지원합니다.
특히 웹 UI에서는 불가능한 기능들이 포함됩니다: 슬라이드 덱을 편집 가능한 .pptx로 내려받기, 퀴즈·플래시카드를 JSON/Markdown/HTML로 내보내기, 마인드맵 JSON 추출, 데이터 테이블 CSV, 개별 슬라이드 자연어 수정, 소스 원문(fulltext) 조회, 채팅 답변을 노트로 저장 등. 프로필 분리(NOTEBOOKLM_PROFILE), CI 환경변수 인증, 병렬 에이전트용 명시적 노트북 ID 사용 규칙까지 문서화되어 있습니다.
이런 분께 추천
- 리서치 자료를 정기적으로 요약·팟캐스트·학습자료로 변환하는 연구자, 뉴스레터 작성자
- 강의 자료에서 퀴즈·플래시카드를 대량 생성해야 하는 교육자
- NotebookLM 결과물을 다른 파이프라인(python-pptx, 시각화 도구)으로 넘기고 싶은 개발자
- Claude Code로 리서치 워크플로를 자동화하려는 에이전트 사용자
활용 예시
- URL 묶음 → 팟캐스트: "이 기사 5개로 팟캐스트 만들어줘" → 노트북 생성 →
source add반복 → 소스 READY 대기 →generate audio→download audio ./podcast.m4a - 시험 대비 학습팩: 강의 PDF를 올리고
generate quiz --difficulty hard,generate flashcards를 실행한 뒤download quiz --format markdown으로 노션·옵시디언에 바로 붙일 수 있는 파일 확보 - 모바일용 세로 슬라이드:
notebooklm generate slide-deck "9:16 세로 레이아웃으로 정확히 8페이지"후download slide-deck ./slides.pptx --format pptx로 편집 가능한 파일 확보
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 teng-lin/notebooklm-py 의 SKILL.m 폴더를 내 ~/.claude/skills/notebooklm/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
pip install "notebooklm-py[browser]" && notebooklm skill install⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- Python 3.10 이상이 설치되어 있는지 확인합니다:
python --version - 패키지를 설치합니다:
pip install "notebooklm-py[browser]"([browser]는 로그인 창을 띄우는 데 필요합니다) - 스킬을 Claude 스킬 폴더에 등록합니다:
notebooklm skill install(또는npx skills add teng-lin/notebooklm-py) - Google 계정으로 로그인합니다:
notebooklm login— 브라우저가 열리면 평소 쓰는 계정으로 로그인하세요. - 인증이 실제로 통하는지 확인합니다:
notebooklm auth check --test --json→"status": "ok"와checks.token_fetch: true가 모두 나와야 합니다. notebooklm list로 노트북 목록이 나오면 준비 완료입니다. Claude Code에서 "/notebooklm" 또는 "이 링크들로 팟캐스트 만들어줘"라고 요청하세요.- (선택) 서버·CI 환경이라면 데스크톱에서 만든
storage_state.json을 옮기고notebooklm --storage /경로/storage_state.json list로 사용합니다. 이 파일은 계정 접근 권한과 같으므로 권한을chmod 600으로 두고 절대 커밋하지 마세요.
GitHub에서 원본 보기 ↗라이선스: MIT