notebooklm-py의 개요
notebooklm-py로 Google NotebookLM을 스크립트로 다룰 수 있습니다. Google은 2026년 7월 NotebookLM의 이름을 Gemini Notebook으로 바꿨으며, README는 라이브러리가 같은 서비스를 다루므로 그대로 동작한다고 말합니다. 노트북을 만들고, URL, YouTube, 파일, Drive에서 소스를 추가하고, 그와 대화하고, Deep Research를 실행하고, 오디오 개요, 영상, 슬라이드 덱, 퀴즈, 플래시카드, 보고서, 마인드맵을 생성할 수 있습니다.
Python 라이브러리, CLI, MCP 서버(stdio로 로컬 실행하거나 원격 커넥터로 자체 호스팅), 에이전트 스킬로 제공됩니다. notebooklm skill install은 스킬을 Claude Code의 skills 폴더에 넣습니다. 비공식이며, 웹 앱이 쓰는 것과 같은 문서화되지 않은 내부 API를 호출해 동작합니다.
notebooklm-py, 쓸 만한 가치가 있습니까?
notebooklm-py는 코드로 NotebookLM을 다루는 가장 폭넓은 방법이자 가장 보장이 약한 방법입니다. GitHub 스타는 약 19,900개이고, 2026년 10월 12일 v0.8.5를 냈으며, 열린 이슈는 19개뿐입니다. 관리자가 Google의 변경에 뒤처지지 않고 따라가고 있다는 뜻으로 보입니다.
기능 범위는 웹 앱을 넘어섭니다. 한 유형의 모든 산출물 일괄 다운로드, JSON 마인드맵, JSON이나 Markdown 퀴즈와 플래시카드, CSV 데이터 표, 편집 가능한 PPTX 슬라이드 덱을 제공합니다. README가 밀어붙이는 패턴은 비용 전가입니다. Gemini가 서버 쪽에서 문서 30개를 읽고 에이전트는 최종 답변에만 자기 토큰을 쓰므로, 청구서가 API 계정에서 Google 구독으로 옮겨 갑니다.
약점은 인증입니다. 기본 경로는 Playwright 브라우저 로그인(첫 실행 때 약 170 MB의 Chromium을 내려받음)이나 Chrome에서 빼낸 쿠키입니다. 서버와 CI용으로는 사람 없이 새 쿠키를 발급하는 마스터 토큰 로그인이 있는데, README는 이를 "강력한 전체 계정 자격 증명"이라고 부르며 전용 Google 계정을 권합니다. 그 토큰을 가진 에이전트나 원격 MCP 커넥터는 NotebookLM뿐 아니라 Google 전반에서 사용자 행세를 할 수 있습니다.
용량은 라이브러리가 아니라 Google이 정합니다. 무료 계정은 소스 50개짜리 노트북 100개, Google AI Pro는 소스 300개짜리 노트북 500개이며, Google은 모든 한도가 바뀔 수 있다고 표시합니다. README는 과도하게 쓰면 속도가 제한될 수 있다고 경고하며, 자체 학습 세트 예제도 이를 피하려고 요청 속도를 일부러 조절합니다. 브라우저를 자동화하고 2025년 11월 이후 릴리스가 없는 PleasePrompto/notebooklm-skill과 비교하면 이쪽이 더 유능하고 더 활발히 유지되는 경로입니다. 다만 둘 다 Google이 프런트엔드를 바꾸면 깨집니다.
제 역할을 하는 곳
Google AI Pro 요금제로 Claude Code를 쓰는 1인 연구자
논문 30편을 읽는 데 Claude 토큰을 쓰지 않고 종합하기
에이전트가 노트북을 만들고 소스를 추가한 뒤 NotebookLM에 질문합니다. 읽기는 Pro 요금제의 소스 300개 한도 안에서 Gemini가 하고, Claude는 인용이 달린 답만 정리합니다.
30명 규모 스타트업의 플랫폼 엔지니어
사내 RFC와 아키텍처 문서에 대해 코딩 에이전트에 인용 가능한 답변 출처 주기
문서를 담은 노트북을 MCP 서버로 노출하면 벡터 데이터베이스가 필요 없습니다. Google 로그인 하나로 돌아가므로 마스터 토큰보다 전용 계정과 수명이 짧은 쿠키 세션이 안전합니다.
200명 규모 회사의 교육 책임자
온보딩 자료를 주제별 팟캐스트, 퀴즈, 플래시카드로 바꾸기
스크립트가 주제마다 노트북을 하나씩 만들고 퀴즈는 JSON, 오디오는 MP3로 일괄 내보냅니다. 생성은 계정의 일일 할당량에 포함되며, 속도 제한을 피하려면 요청 간격을 조절해야 합니다.
도입 전 확인할 점
- 설정
- uv tool install "notebooklm-py[browser]" 후 notebooklm login을 실행하면 첫 실행 때 Google 로그인용으로 약 170 MB의 Chromium을 내려받습니다. Python 3.10 이상. Playwright 없이 라이브러리만 넣으려면 평범한 pip install이면 됩니다.
- 연동
- Python 비동기 API, CLI, Claude Desktop, Claude Code, Codex용 MCP 서버, claude.ai와 ChatGPT용 자체 호스팅 원격 커넥터, notebooklm skill install이나 npx skills add로 설치하는 스킬.
- 데이터와 개인정보
- MIT 라이선스이며 README에 텔레메트리 언급은 없습니다. 소스와 대화는 사용자 계정으로 Google에 갑니다. Google은 피드백을 제출하지 않는 한 개인 계정의 NotebookLM 콘텐츠로 모델을 학습하지 않는다고 말하며, Workspace 계정은 더 강한 조건을 적용받습니다. 쿠키나 마스터 토큰은 로컬 프로필에 저장됩니다.
- 대규모 사용 시 비용
- 라이브러리는 무료이고 용량은 Google 요금제가 정합니다. 무료 계정은 소스 50개짜리 노트북 100개, Google AI Plus는 100개짜리 200개, Google AI Pro는 300개짜리 500개, Ultra는 노트북당 소스 최대 600개입니다.
- 제한
- Google과 무관하며 엔드포인트는 예고 없이 바뀔 수 있습니다. 과도하게 쓰면 속도가 제한될 수 있습니다. 확인 시점 기준 열린 이슈 19개.
좋은 점
- 웹 앱에 없 는 내보내기 제공: 일괄 다운로드, 마인드맵 JSON, PPTX 슬라이드
- 라이브러리, CLI, MCP 서버, Claude Code 스킬을 한 패키지에
- 잦은 릴리스와 짧은 이슈 목록
아쉬운 점
- 문서화되지 않은 Google API는 예고 없이 바뀔 수 있음
- 마스터 토큰 로그인은 Google 계정 전체 자격 증명
- 과도한 사용 시 속도 제한, 노트북과 소스 한도는 Google 등급이 정함
추천 대상
Claude Code가 NotebookLM 노트북을 만들고 질의하게 하려는 연구자.
notebooklm-py 대안
notebooklm-py: 자주 묻는 질문
- notebooklm-py, 쓸 만한 가치가 있습니까?
- NotebookLM의 전체 기능을 에이전트 손에 쥐여 주지만, 문서화되지 않은 Google 엔드포인트와 가볍게 넘 겨서는 안 될 로그인으로 지탱됩니다. 평점은 5점 만점에 3.8점입니다.
- notebooklm-py의 가격은 얼마입니까?
- MIT의 무료 오픈소스입니다. NotebookLM 한도는 Google 계정 등급에 따라 다릅니다.
- notebooklm-py의 단점은 무엇입니까?
- 문서화되지 않은 Google API는 예고 없이 바뀔 수 있음; 마스터 토큰 로그인은 Google 계정 전체 자격 증명; 과도한 사용 시 속도 제한, 노트북과 소스 한도는 Google 등급이 정함.
- notebooklm-py에 적합한 사람은 누구입니까?
- Claude Code가 NotebookLM 노트북을 만들고 질의하게 하려는 연구자.
- 팀이나 프로덕션 환경에서 notebooklm-py의 비용은 얼마입니까?
- 라이브러리는 무료이고 용량은 Google 요금제가 정합니다. 무료 계정은 소스 50개짜리 노트북 100개, Google AI Plus는 100개짜리 200개, Google AI Pro는 300개짜리 500개, Ultra는 노트북당 소스 최대 600개입니다.
- notebooklm-py에 회사 데이터를 맡겨도 안전합니까?
- MIT 라이선스이며 README에 텔레메트리 언급은 없습니다. 소스와 대화는 사용자 계정으로 Google에 갑니다. Google은 피드백을 제출하지 않는 한 개인 계정의 NotebookLM 콘텐츠로 모델을 학습하지 않는다고 말하며, Workspace 계정은 더 강한 조건을 적용받습니다. 쿠키나 마스터 토큰은 로컬 프로필에 저장됩니다.
- notebooklm-py의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 claude-obsidian 및 claude-mem입니다.
답변 확인일: 2026년 10월 23일.