notebooklm-py

제미나이 노트북을 코드로 다루는 비공식 파이썬 API 이자 에이전트 스킬

pip install notebooklm-py

구글이 제미나이 노트북으로 이름을 바꾼 노트북LM 을 파이썬과 CLI, 에이전트에서 그대로 다루게 해 줍니다. 웹 화면에서 못 하는 일까지 열어 둔 것이 핵심입니다. 자료를 한꺼번에 넣고, 오디오 요약과 영상, 슬라이드, 퀴즈, 마인드맵을 만들고, 결과물을 파일로 내려받습니다. 웹 화면은 일괄 내려받기와 퀴즈 내보내기, 마인드맵 구조 추출을 제공하지 않습니다. 스킬 파일을 함께 실어서 코딩 에이전트에 바로 붙습니다. 다만 문서화되지 않은 구글 내부 API 를 쓰기 때문에 예고 없이 끊길 수 있습니다. 저장소도 시제품과 연구, 개인 작업을 권합니다.

판단

이럴 때 씁니다

  • 자료 묶음을 넣고 요약과 팟캐스트를 반복 생산해야 할 때
  • 웹 화면이 막아 둔 일괄 내려받기나 마인드맵 구조가 필요할 때
  • 코딩 에이전트에 근거 기반 요약 계층을 붙이고 싶을 때

이럴 땐 쓰지 마세요

  • 끊기면 안 되는 업무 파이프라인에는 부적합합니다
  • 구글 공식 지원을 받아야 하는 환경에서는 못 씁니다
  • 많이 부르면 속도 제한이 걸립니다

차별점

  • 웹 화면이 제공하지 않는 일괄 내려받기와 퀴즈 내보내기, 마인드맵 구조 추출을 엽니다.
  • 파이썬과 CLI, MCP 서버, REST 서버를 한 패키지에 담았습니다.
  • 에이전트가 바로 쓰는 스킬 파일을 함께 싣습니다.
  • 무거운 읽기를 제미나이에 맡기고 에이전트는 조율만 하는 사용법을 안내합니다.

워크플로

  1. 01패키지를 설치하고 구글 계정으로 인증합니다.
  2. 02노트북을 만들고 자료를 넣습니다.
  3. 03질문을 던져 근거가 붙은 답을 받습니다.
  4. 04필요한 산출물을 생성합니다.
  5. 05결과물을 파일로 내려받거나 문서로 내보냅니다.

주요 명령

명령설명
pip install notebooklm-py설치합니다.
notebooklm skill install클로드 코드나 스킬 디렉터리에 스킬을 깝니다.
pip install 'notebooklm-py[android]'모바일 백엔드를 쓸 때 추가로 설치합니다.

함정

설치 전에 확인하세요

  • 문서화되지 않은 구글 내부 API 를 씁니다. 예고 없이 끊길 수 있고 저장소도 그렇게 밝힙니다.
  • 구글과 무관한 커뮤니티 프로젝트입니다. 공식 지원이 없습니다.
  • 많이 부르면 속도 제한이 걸립니다.
  • 노트북LM 이 제미나이 노트북으로 이름을 바꿨지만 패키지 이름은 그대로입니다. 문서를 찾을 때 헷갈립니다.

비교

노트북LM 을 다루는 다른 경로는 대부분 화면 자동화라 깨지기 쉽습니다. 이쪽은 내부 API 를 직접 호출해 속도와 기능 범위가 다릅니다. 대신 그 API 가 바뀌면 같이 멈춘다는 위험을 같이 집니다.

최근 변경

안드로이드 백엔드가 들어갔습니다. 파이썬 SDK 와 CLI, MCP 서버, REST 서버가 웹 대신 네이티브 모바일 API 를 쓸 수 있고 추가 설치와 인자, 환경 변수 중 하나로 고릅니다.

공식 변경 내역