Unofficial Python API and agentic skill for Google Gemini Notebook. Full programmatic access to Gemini Notebook's features—including capabilities the web UI doesn't expose—via Python, CLI, and AI agents like Claude Code, Codex, and OpenClaw.

notebooklm-py

그것은 무엇인가 – Google의 Gemini Notebook(이전 Notebook LM)용 비공식 Python 클라이언트, CLI 및 서버. 노트북 서비스를 프로그래밍 방식으로 구동할 수 있습니다 – 소스 추가, 질문, 다양한 AI 생성 아티팩트(오디오, 비디오, 슬라이드, 퀴즈, 플래시카드, 마인드맵 등) 생성 – 모두 Python 코드, 명령줄 도구 또는 Claude Code나 Codex와 같은 LLM 에이전트가 호출할 수 있는 MCP/REST 서버를 통해 가능합니다.

왜 중요한가

제로 토큰 연구 – Gemini가 수십 개의 문서를 무거운 읽기를 하게 하고, 최종 다듬는 단계에서만 모델 토큰을 사용합니다.
에이전트를 위한 접지된 메모리 – 노트북은 지속적이고 인용이 뒷받침되는 지식 기반으로 작동하여 에이전트가 자체 벡터 저장소를 구축하는 대신 쿼리할 수 있습니다.
일괄, 스크립트 가능한 내보내기 – 오디오, 비디오, PDF, JSON 퀴즈, 마인드맵 트리, CSV 테이블 등을 한 명령으로 다운로드 – 웹 UI로는 불가능합니다.
에이전트 준비 스킬 – 즉시 설치 가능한 Claude Code 스킬(SKILL.md)이 포함되어 에이전트가 Notebook LM 작업을 직접 호출할 수 있습니다.

핵심 기능(README에 설명됨)

영역	할 수 있는 일
노트북 관리	노트북 생성, 복사, 나열, 이름 변경, 삭제, 활성 노트북 전환.
소스 수집	URL, PDF, Word, EPUB, 오디오/비디오, 이미지, YouTube 링크, Google Drive 파일 또는 원시 텍스트 추가. 일괄 가져오기 및 자동 새로 고침 지원.
채팅 / Q&A	노트북의 소스에 대해 Gemini 기반 질문을 하고, 대화 기록을 유지하고, 사용자 지정 페르소나를 사용하고, 답변을 노트로 저장.
콘텐츠 생성	오디오 개요, 비디오 개요, 슬라이드 덱(PDF/PPTX), 인포그래픽, 퀴즈, 플래시카드, 보고서, 데이터 테이블(CSV), 마인드맵(JSON) 생성.
내보내기 / 다운로드	모든 아티팩트 유형을 일괄 다운로드하고 형식(MP3, MP4, PNG, JSON, Markdown, HTML, CSV, PPTX) 선택.
공유 및 권한	공개/비공개 링크 생성, 뷰어/편집자 권한 설정.
자동화 훅	CLI, Python API, MCP 서버(Claude Code/Codex용), 헤드리스 스크립트용 경량 REST 서버.
백엔드	기본 웹 RPC(`batchexecute`) 및 마스터 토큰을 통한 토큰 없는 인증을 위한 선택적 Android gRPC 백엔드.

일반적인 워크플로(README의 CLI 예제)

# 1. 인증(브라우저 또는 마스터 토큰)
notebooklm login

# 2. 노트북 생성 및 자료 추가
notebooklm create "My Research"
notebooklm use <notebook_id>
notebooklm source add "https://en.wikipedia.org/wiki/Artificial_intelligence"
notebooklm source add "paper.pdf"

# 3. 접지된 질문하기
notebooklm ask "What are the key themes?"

# 4. 아티팩트 생성(예: 팟캐스트)
notebooklm generate audio "make it engaging" --wait

# 5. 결과 다운로드
notebooklm download audio ./podcast.m4a

동일한 단계는 Python의 NotebookLMClient를 통해 수행하거나 MCP/REST 서버를 통해 LLM 에이전트가 호출할 수 있습니다.

누가 사용할까?

연구자와 작가 – 많은 문서를 수집하고 Gemini가 요약한 다음 게시 가능한 미디어를 내보내려는 사람.
LLM 에이전트 개발자(Claude Code, Codex, OpenClaw 등) – 접지된 지식 기반과 에이전트가 호출할 수 있는 도구 작업 세트가 필요한 사람.
자동화 엔지니어 – 일괄 콘텐츠 생성이 필요한 CI/CD 파이프라인, 정기 브리핑 또는 인시던트 런북 생성기를 구축하는 사람.
파워 유저 – 일괄 다운로드, 사용자 지정 형식 또는 Obsidian과 같은 개인 지식 그래프 도구와의 통합을 원하는 사람.

제한 사항 및 주의 사항(README 경고)

비공식 및 문서화되지 않음 – Google의 내부 API와 통신합니다. 예고 없이 변경될 수 있습니다.
속도 제한 및 할당량 – 과도하거나 자동화된 사용은 Google에 의해 제한될 수 있습니다.
인증 복잡성 – Playwright 기반 브라우저 로그인 또는 마스터 토큰이 필요합니다. Android 백엔드는 지속적인 마스터 토큰이 필요합니다.
벡터 DB의 대체가 아님 – 접지된 리콜을 제공하지만 Google의 서비스 가용성에 의존합니다.

빠른 시작 체크리스트

CLI 설치(권장: uv tool install "notebooklm-py[browser]" 또는 pipx).
notebooklm login 실행(헤드리스 사용의 경우 마스터 토큰 로그인).
위의 CLI 워크플로를 따르거나 Python에서 NotebookLMClient를 가져옵니다.
선택 사항: notebooklm skill install 또는 npx skills add teng-lin/notebooklm-py로 Claude Code 스킬 설치.

모든 정보는 저장소의 README에서 직접 가져온 것입니다. 추가 기능은 추측하지 않습니다.

teng-lin/notebooklm-py