NotebookLM 비공식 파이썬 API 'notebooklm-py' 깃허브 공개

개발자 teng-lin이 구글의 AI 노트 도구 NotebookLM을 프로그래밍 방식으로 다룰 수 있게 해 주는 비공식 파이썬 라이브러리 'notebooklm-py'를 깃허브에 공개했다. 파이썬과 CLI, 그리고 Claude Code와 Codex, OpenClaw 같은 AI 에이전트를 통해 NotebookLM의 기능에 접근할 수 있으며, 웹 인터페이스가 노출하지 않는 기능까지 다룬다.

다만 이 라이브러리는 비공식 프로젝트로, 문서화되지 않은 구글 내부 API를 사용한다. 개발 측은 구글과 무관한 커뮤니티 프로젝트이며 구글이 내부 엔드포인트를 언제든 바꿀 수 있어 작동이 깨질 수 있고, 사용량이 많으면 호출 제한이 걸린다고 안내한다. 시제품과 연구, 개인 프로젝트에 적합하다는 설명이다.

AI 에이전트 연동 측면에서 notebooklm-py는 깃허브용 루트 NotebookLM 스킬과 'npx skills add' 방식의 탐색 기능을 제공한다. Claude Code와 .agents 스킬 디렉터리를 위한 로컬 스킬 설치를 지원하고, Codex용 안내는 AGENTS.md 파일에 담았다.

연구 자동화 기능으로는 URL과 PDF, 유튜브, 구글 드라이브 등 여러 출처를 한꺼번에 가져오고, 웹과 드라이브를 대상으로 한 리서치 질의를 실행해 결과를 자동으로 불러올 수 있다. 이를 통해 반복 가능한 리서치 파이프라인을 구성할 수 있다.

콘텐츠 생성 기능은 오디오 개요(팟캐스트)와 영상, 슬라이드 덱, 퀴즈, 플래시카드, 인포그래픽, 데이터 표, 마인드맵, 학습 가이드를 아우른다. 오디오 개요는 심층 분석·브리핑·비평·토론 4가지 형식과 3가지 길이, 50개가 넘는 언어를 지원하며, 영상 개요는 설명·브리핑·시네마틱 3가지 형식과 9가지 비주얼 스타일을 제공한다.

생성된 결과물은 MP3, MP4, PDF, PNG, CSV, JSON, 마크다운 형식으로 로컬에 내려받거나 구글 문서와 시트로 내보낼 수 있다. 특히 결과물 일괄 다운로드, 퀴즈와 플래시카드의 구조화된 내보내기, 마인드맵 JSON 추출, 슬라이드 덱의 PPTX 저장 등은 NotebookLM 웹 UI에서는 제공하지 않는 기능이다.

설치는 Playwright를 포함한 'notebooklm-py[browser]' 패키지를 내려받은 뒤 약 170MB 크기의 크로미움을 설치하는 방식이 기본이다. 애플리케이션에 그대로 끼워 넣어 쓸 때는 Playwright와 크로미움 없이 약 10MB 크기의 핵심 라이브러리만 설치할 수도 있다.

CLI에서는 노트북 생성과 출처 추가, 질문, 콘텐츠 생성, 다운로드를 명령어 한 줄로 처리할 수 있다. 여러 구글 계정 프로필을 전환하거나 이미 로그인된 브라우저 세션의 쿠키를 가져와 재인증 없이 쓰는 기능도 갖췄다.