클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

NotebookLM 자동화 (notebooklm-py)

Gemini Notebook(NotebookLM)을 notebooklm-py CLI/파이썬 API로 인증·소스 관리·리서치·산출물 생성까지 안전하게 자동화하는 스킬.

자동화·워크플로고급★ 19,437⑂ 2,600AI 점수 9/10마지막 업데이트: 2026. 9. 23.

무엇을 해주나

  • notebooklm CLI(또는 타입 지정 async 파이썬 API)로 노트북 생성, 소스 추가, 준비 상태 대기, 근거 기반 채팅, 오디오·영상·슬라이드·마인드맵 등 산출물 생성/다운로드를 수행합니다.
  • 인증 체계를 정리해 줍니다: notebooklm auth check --test --json으로 실제 토큰 발급 여부 확인, headless/CI 환경에서는 쿠키 스냅샷 대신 프로필 기반 master token 사용 권장.
  • 자동화 불변 규칙을 강제합니다: 항상 --json 사용, 반환된 전체 UUID 보관, 모든 명령에 -n <notebook_id> 명시, 동시 실행 시 NOTEBOOKLM_PROFILE로 프로필 분리.
  • 권한 경계를 정의합니다: 삭제·공유 해제·로그아웃·언어 설정 변경·다운로드·노트 생성·리서치 임포트처럼 파괴적이거나 파일을 쓰는 작업은 사용자 확인 후 실행.
  • 실패 진단 루틴(읽기 전용 명령 → 종료 코드 분기 → 정확한 ID로 상태 조회)과 종료 코드 규칙까지 제공합니다.

이런 분께 추천

  • NotebookLM을 수동 클릭 대신 스크립트/에이전트로 굴리고 싶은 리서처, 데이터·콘텐츠 팀.
  • CI나 서버(헤드리스)에서 문서 요약·팟캐스트 생성 파이프라인을 만들려는 엔지니어.
  • 여러 에이전트를 동시에 돌려야 해서 자격증명·컨텍스트 충돌을 피해야 하는 사람.

활용 예시

  1. "이 URL 3개로 노트북 만들고 팟캐스트 오디오 만들어줘" → create → source add × 3 → source wait → generate audio → artifact wait → download audio ./podcast.m4a.
  2. "이 주제로 딥리서치 돌려놔" → source add-research "..." --mode deep --no-wait --json으로 비동기 시작, research_run_id 보관 후 승인 시에만 research wait --import-all로 임포트.
  3. "인증이 깨졌는데 왜?" → auth check --test --passive --json으로 읽기 전용 진단, checks.token_fetch가 false일 때만 재로그인 또는 auth refresh.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/teng-lin/notebooklm-py/HEAD/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 teng-lin/notebooklm-py 의 SKILL.m 폴더를 내 ~/.claude/skills/notebooklm/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

pip install "notebooklm-py[browser]" && notebooklm skill install

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 파이썬 3.10 이상인지 확인합니다: python3 --version.
  2. 기존(활성) 환경에 패키지를 설치합니다: pip install "notebooklm-py[browser]". CLI만 쓸 경우 uv tool install "notebooklm-py[browser]" 또는 pipx도 좋습니다. externally-managed-environment 오류가 나면 --break-system-packages를 쓰지 말고 uv/pipx나 가상환경을 사용하세요.
  3. 스킬을 에이전트에 설치합니다: notebooklm skill install (샌드박스 환경이면 notebooklm skill package로 아카이브 생성).
  4. 설치 상태를 확인합니다: notebooklm skill status --json.
  5. 로그인합니다: 화면이 있는 환경에서 notebooklm login, 헤드리스/무인 운영이면 pip install "notebooklm-py[headless]" 후 신뢰된 PC에서 notebooklm login --master-token --account <이메일>을 실행하고 생성된 master_token.json만 서버 프로필로 옮깁니다(권한 0600).
  6. 정상 동작을 검증합니다: notebooklm auth check --test --json 결과가 status == "ok", checks.token_fetch == true여야 합니다.
  7. Claude Code를 재시작하고 "NotebookLM에서 내 노트북 목록 보여줘"처럼 요청해 스킬이 발동하는지 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT