NotebookLM CLI 도구 모음 (비공식)

NotebookLM 주변에는 비공식 CLI/SDK가 몇 갈래 있다. 그중 notebooklm-py는 Python API + CLI + 에이전트 연동까지 포함하는 쪽으로 범위가 가장 넓다.

주의: 이 계열은 Google의 문서화되지 않은 내부 API를 사용한다. Google 측 변경이나 rate limit에 따라 언제든 깨질 수 있다.

notebooklm-py

• GitHub: https://github.com/teng-lin/notebooklm-py
• PyPI: notebooklm-py v0.4.1
• License: MIT
• 지원 Python: 3.10+
• 지원 OS: macOS / Linux / Windows / WSL
• 포지션: “A Comprehensive NotebookLM Skill & Unofficial Python API”

강점

• Python API, CLI, 에이전트 스킬 설치를 한 저장소에서 제공
• NotebookLM의 notebook / source / chat / research / sharing / artifact 생성까지 폭넓게 자동화
• Claude Code, Codex, OpenClaw 같은 에이전트 하네스와의 연동을 명시

README 기준 핵심 기능

• Notebooks: create, list, rename, delete
• Sources: URL, YouTube, 파일(PDF, text, Markdown, Word, EPUB, audio, video, images), Google Drive, pasted text
• Chat: 질문, 대화 기록, custom persona
• Research: web / Drive research agents, auto-import
• Sharing: public/private links, viewer/editor permissions
• Artifacts:
  • Audio Overview
  • Video Overview
  • Slide deck
  • Infographic
  • Quiz / flashcards
  • Report
  • Data table
  • Mind map
• UI보다 더 잘 노출되는 기능:
  • batch download
  • quiz/flashcard를 JSON/Markdown/HTML로 export
  • mind map JSON export
  • slide deck PPTX download
  • source fulltext access
  • multi-account profiles
  • browser cookie import

Quick start

pip install "notebooklm-py[browser]"
playwright install chromium
notebooklm login
notebooklm auth check --test --json

Agent integration

notebooklm skill install
# 또는
npx skills add teng-lin/notebooklm-py

주의점

• 공식 프로젝트가 아니다.
• undocumented Google API를 사용하므로 안정성보다 자동화성에 초점이 있다.
• README가 권장하는 용도는 prototype / research / personal projects 쪽이다.

관련 도구들

notebooklm-mcp-cli

• GitHub: https://github.com/jacob-bd/notebooklm-mcp-cli
• 성격: 하나의 설치로
  • CLI: nlm
  • MCP server: notebooklm-mcp 를 함께 제공
• 포지션: “Programmatic access to Google NotebookLM — via CLI or MCP server”
• 예시(README 발췌 요약):
  • nlm notebook list
  • nlm notebook create "Research Project"
  • nlm source add <notebook> --url "https://..."
  • nlm audio create <notebook> --confirm
  • nlm download audio <notebook> <artifact-id>
  • nlm share public <notebook>

notebooklm-cli

• GitHub: https://github.com/jacob-bd/notebooklm-cli
• 상태: Deprecated
• 안내: notebooklm-mcp-cli로 통합되었으며, 더 이상 업데이트되지 않음

notebooklm-client

• GitHub: https://github.com/icebear0828/notebooklm-client
• 요구사항(README 기준): Node.js 20+ / Chrome(최초 로그인에 필요)
• 예시(README 발췌 요약):
  • npx notebooklm export-session
  • npx notebooklm list --transport auto
  • npx notebooklm audio --transport auto --url "..." -o ./output -l en
  • npx notebooklm analyze --transport auto --url "..." --question "..."

nblm-rs

• GitHub: https://github.com/K-dash/nblm-rs
• 설명: NotebookLM Enterprise API용 비공식 클라이언트(일반 NotebookLM/consumer용이 아닐 수 있음)

선택 가이드

• “Python으로 NotebookLM 자동화 파이프라인을 짜고 싶다” → notebooklm-py
• “에이전트 툴(MCP)로 붙이고 싶다” → notebooklm-mcp-cli
• “Node 환경에서 npx로 빠르게 돌리고 싶다” → notebooklm-client

메모

• 이 노트는 notebooklm-py 저장소를 기준으로 조사해 갱신했다.
• 설치 가이드는 README보다 docs/installation.md가 더 자세하다.
• PyPI 버전, 지원 OS/Python, agent install 경로는 2026-05-19 시점 기준 README/PyPI 확인값이다.