터미널과 AI 에이전트를 위한 Source 기반의 NotebookLM 자동화입니다.

繁體中文

notebooklm-skill는 인간과 MCP 클라이언트 모두에게 구글을 위한 일관된 인터페이스를 제공합니다 노트북 LM. URL, 원시 텍스트, 로컬 파일로 노트북을 생성합니다; Grounded를 묻습니다 인용 메타데이터가 포함된 질문; 빠른 또는 딥웹 조사를 완료; 그리고 생성 또는 NotebookLM 산토물을 다운로드할 수 있습니다.

이 프로젝트는 notebooklm-py 0.8.x와 FastMCP 4 (MCP Python SDK 2.x) 위에 구축되었습니다. 다음과 같은 것들이 포함됩니다:

• JSON 우선 코어 CLI;
• 5개의 종단 간 연구 파이프라인;
• 13개의 도구가 탑재된 FastMCP 서버;
• 프로필 인식 인증 및 스킬 설치 프로그램;
• 하나의 공유 호환성 계층으로, CLI, 파이프라인, MCP가 동일한 동작을 사용합니다.

이것은 NotebookLM의 웹 API와의 비공식 통합입니다. 구글은 서비스, 가용성, 할당량, 또는 알림 없이 > 아티팩트 동작을 할 수 있습니다.

요구 사항

• Python 3.10 또는 그 이후 (CI는 3.10부터 3.15까지 포함)
• NotebookLM에 접근할 수 있는 구글 계정
• 일회용 브라우저 로그인용 Chromium(./install.sh에서 설치), 또는 로컬 구글 크롬 또는 마이크로소프트 엣지
• 선택 사항: 추세 워크플로우용 trend-pulse 명령어와 ffmpeg 및 Poppler '스크립트/make_video 때문에.

notebooklm-skill

Source-grounded NotebookLM automation for terminals and AI agents.

繁體中文

notebooklm-skill gives humans and MCP clients one consistent interface for Google NotebookLM. It creates notebooks from URLs, raw text, and local files; asks grounded questions with citation metadata; completes fast or deep web research; and generates or downloads NotebookLM artifacts.

The project is built on notebooklm-py 0.8.x and FastMCP 4 (MCP Python SDK 2.x), and includes:

• a JSON-first core CLI;
• five end-to-end research pipelines;
• a 13-tool FastMCP server;
• profile-aware authentication and Skill installers;
• one shared compatibility layer, so CLI, pipelines, and MCP use the same behavior.

This is an unofficial integration with NotebookLM’s web API. Google can change the service, availability, quotas, or artifact behavior without notice.

Requirements

• Python 3.10 or newer (CI covers 3.10 through 3.15)
• a Google account with access to NotebookLM
• Chromium for the one-time browser login (installed by ./install.sh), or a local Google Chrome or Microsoft Edge
• optional: the trend-pulse command for trend workflows, and ffmpeg plus Poppler for scripts/make_video.sh

Quick start

Isolated source install

The installer creates a dedicated virtual environment, installs Chromium, links five commands into ~/.local/bin, and installs the Claude Code Skill using the standard directory layout.

git clone https://github.com/claude-world/notebooklm-skill.git
cd notebooklm-skill
./install.sh

notebooklm-auth setup
notebooklm-skill list

Ensure ~/.local/bin is on PATH.

PyPI or uvx

# Persistent virtual environment
python3 -m venv .venv
source .venv/bin/activate
python -m pip install notebooklm-skill
python -m playwright install chromium
notebooklm-auth setup

# Or run without a persistent install
uvx --from notebooklm-skill notebooklm-auth setup
uvx --from notebooklm-skill notebooklm-skill list

Direct upstream login is also available:

uvx --from notebooklm-py notebooklm login

Sessions are profile-aware. Select one with --profile NAME before a CLI subcommand, or set NOTEBOOKLM_PROFILE.

To use the locally installed Google Chrome instead of bundled Chromium:

notebooklm-auth setup --browser chrome --fresh

Core CLI

All successful commands print structured JSON to stdout. Diagnostics go to stderr; authentication errors return exit code 4 and argument errors return exit code 2.