teng-lin/notebooklm-py

해결하는 문제

notebooklm-py는 Google의 NotebookLM (현재 Gemini Notebook)에 대한 프로그래밍 방식의 액세스를 제공하여, 사용자가 웹 UI를 거치지 않고 리서치, 콘텐츠 생성 및 지식 관리를 자동화할 수 있도록 합니다. NotebookLM의 근거 기반 AI 기능을 AI 에이전트(Claude Code 또는 Codex 등), 셸 스크립트 및 커스텀 Python 파이프라인에 통합할 수 있게 하여, 이 서비스를 다른 LLM을 위한 스크립트 가능한 "메모리 레이어" 또는 합성 엔진으로 효과적으로 변환합니다.

작동 방식

이 라이브러리는 문서화되지 않은 Google API를 래핑하는 비공식 Python API 및 CLI 역할을 합니다. 대화형 브라우저 로그인, 기존 브라우저의 쿠키 가져오기, 헤드리스 서버 환경을 위한 마스터 토큰 시스템을 포함한 다양한 인증 방법을 지원합니다. NotebookLM과 상호 작용하여 노트북을 관리하고, 다양한 소스 유형(URL, PDF, YouTube 동영상, Google Drive 파일)을 업로드하며, 인용된 답변 및 멀티미디어 결과물 생성을 트리거할 수 있습니다.

대상 사용자

• AI 에이전트 개발자: 자체 벡터 데이터베이스를 관리하지 않고도 에이전트에 지속적이고 근거 있는 메모리 또는 "프로젝트 브레인"을 부여하고자 하는 개발자.
• 연구자 및 학생: 소스의 대량 가져오기와 퀴즈, 플래시카드, 팟캐스트와 같은 학습 보조 도구 생성을 자동화해야 하는 사용자.
• 자동화 엔지니어: 예정된 오디오 브리핑 또는 자동 인시던트 런북 생성을 위한 헤드리스 파이프라인을 구축하는 사람들.
• 지식 관리자: NotebookLM의 합성된 출력을 Obsidian과 같은 도구로 동기화하는 사용자.

주요 특징

• 전체 기능 커버리지: 노트북, 소스, 채팅, 노트 및 공유 권한에 대한 프로그래밍 방식의 제어.
• 다양한 결과물 생성: 오디오 개요(팟캐스트), 비디오, 슬라이드 덱, 인포그래픽, 퀴즈, 플래시카드, 보고서 및 데이터 테이블 생성.
• 확장된 기능: 결과물의 일괄 다운로드 및 퀴즈와 마인드 맵을 위한 구조화된 내보내기(JSON, CSV, Markdown)와 같이 웹 UI에서 찾을 수 없는 기능 제공.
• 에이전트 준비 완료: Claude Code 및 Codex를 위한 내장 기술과 Claude Desktop 및 ChatGPT와의 통합을 위한 MCP 서버 포함.
• 유연한 인증: 멀티 계정 프로필과 무인 헤드리스 운영을 위한 마스터 토큰 시스템 지원.