Youtube Summary

Step 0: URL 소스 결정

$ARGUMENTS에서 URL 존재 여부를 확인한다.

분기 로직:

• URL 인수가 있는 경우 → Step 1로 진행 (기존 동작, 변경 없음)
• URL 인수가 없는 경우 → DB에서 pending URL 조회:

  python3 scripts/db_manager.py pending --limit 1
  

  • pending URL이 있으면 → 해당 URL의 clean_url을 사용하여 Step 1로 진행
    • 먼저 processing 상태로 변경:

      python3 scripts/db_manager.py processing --video-id {video_id}
      

  • pending URL이 없으면 → "처리할 URL이 없습니다. URL을 직접 전달하거나 /telegram-youtube-fetch로 수집하세요." 안내 후 종료

DB 소스 플래그: DB에서 가져온 URL인 경우 _from_db=true, _video_id={video_id}를 내부적으로 추적한다. Step 5(Git 커밋) 이후에 DB 상태를 업데이트하기 위함.

Step 1: 입력 파싱

$ARGUMENTS에서 "제목 - URL" 쌍을 추출한다.

파싱 규칙:

• 제목 - URL 형식: 제목과 URL을 분리
• URL만 있는 경우: WebFetch로 oEmbed API에서 제목 추출
  • https://www.youtube.com/oembed?url=URL&format=json
• 여러 줄이면 줄별로 파싱 (각각 별도 영상)
• -f FORMAT 옵션 추출 (기본값: blog)
• -t TOPIC 옵션 추출 (없으면 자동 분류)

Step 2: NotebookLM 노트북 생성 + 소스 추가 (URL별 개별)

Backend: nlm CLI (notebooklm-mcp-cli, uv tool install로 설치) Wrapper: .claude/skills/youtube-summary/scripts/nlm_wrapper.py (nlm CLI를 subprocess로 호출)

URL마다 별도 노트북을 생성한다. 8개 URL → 8개 노트북.

# 2-1. 인증 확인
nlm login --check
# 실패 시 → "! nlm login" 안내 (브라우저 로그인 필요)

# 2-2. URL별 반복: 노트북 생성 + 소스 추가
for each URL:
  nlm create notebook "YouTube 요약 - {해당 영상 제목}"
  # 중요: --youtube 플래그 + --wait로 인덱싱 대기 포함
  nlm source add {notebook_id} --youtube "{해당 URL}" --wait

주의사항:

• nlm add url은 YouTube URL에서 파싱 버그 있음 → 반드시 nlm source add --youtube 사용
• --wait 플래그로 인덱싱 완료까지 자동 대기 (최대 600초)

에러 처리:

• 인증 실패 → "! nlm login 실행 필요" 안내
• 소스 추가 실패 → 해당 URL 스킵, 성공한 것만 계속 진행

Step 3: NotebookLM 보고서 생성 + 다운로드 (URL별 개별)

URL마다 보고서를 생성하고 다운로드한다.

# URL별 반복 (index = 0, 1, 2, ...)
for each URL (index):
  # 3-1. 보고서 생성 시작
  nlm report create {notebook_id} -f "Blog Post" -y --language ko
  # custom 포맷인 경우:
  nlm report create {notebook_id} -f "Create Your Own" --prompt "..." -y --language ko

  # 3-2. 3분 대기 후 다운로드 시도
  sleep 180
  nlm download report {notebook_id} -o /tmp/nlm_report_{index}.md

  # 다운로드 실패 시: nlm studio status {notebook_id} 로 상태 확인 후 재시도
  # 8분 초과 시 해당 영상 스킵 (NotebookLM 서버 이슈)

다운로드된 /tmp/nlm_report_{index}.md를 각각 Read 도구로 읽는다.

Step 4: Obsidian 노트 생성 (Obsidian CLI 활용)

4a. 주제 폴더 결정

기존 주제 폴더 확인 (Obsidian CLI):

# 04.YouTube 하위 폴더 목록 조회
obsidian folders path="10.InBox/13.YouTube"

-t 옵션 지정 시: 그대로 사용

10.InBox/13.YouTube/{지정된 주제}/

미지정 시 자동 분류:

1. obsidian folders 결과에서 기존 주제 폴더 목록 확인
2. 영상 제목 + 보고서 내용에서 핵심 키워드 추출
3. 기존 폴더와 매칭 시도 → 매칭되면 기존 폴더 사용
4. 매칭 안 되면 새 폴더명 결정 (짧고 명확한 영문)

분류 키워드 매핑:

• "Claude Code", "클로드 코드", "Claude" → Technology/Claude Code/
• "AI Agent", "에이전트", "Agent", "Agentic" → Technology/AI Agent/
• "AI", "인공지능", "LLM", "GPT", "ChatGPT" → Technology/AI Industry/
• "Obsidian", "노트", "PKM" → Technology/Obsidian/
• "개발", "코딩", "프로그래밍", "Development" → Technology/Development/
• "데이터", "Databricks", "Data Engineering", "ETL", "RAG" → Professional/Data Engineering/
• "DevOps", "인프라", "클라우드", "AWS", "K8s" → Professional/DevOps/
• "거버넌스", "메타데이터", "데이터품질" → Professional/Governance/
• "보안", "Security", "해킹" → Professional/Security/
• "투자", "주식", "부동산", "경제", "환율", "금융" → Business/Investment/
• "정부지원", "바우처", "보조금" → Business/Government/
• "디자인", "UI", "피그마", "Figma" → Creative/
• "건강", "Health", "운동", "식단" → Personal/Health/
• 분류 어려우면 사용자에게 질문

4b. 노트 생성 (Obsidian CLI 우선, Write 폴백)

파일명 규칙: YYYY-MM-DD_{제목_언더스코어}.md

• 제목에서 특수문자 제거, 공백→언더스코어
• 제목이 너무 길면 40자 내로 자르기

방법 A: Obsidian CLI (Obsidian 실행 중일 때)

# 4b-1. 노트 생성 (보고서 내용 포함)
obsidian create path="10.InBox/13.YouTube/{주제폴더}/YYYY-MM-DD_{제목}.md" content="{보고서 내용}" silent

# 4b-2. YAML 프로퍼티 일괄 설정
FILE="10.InBox/13.YouTube/{주제폴더}/YYYY-MM-DD_{제목}.md"
obsidian property:set path="$FILE" name=title value="{영상 제목}"
obsidian property:set path="$FILE" name=type value=youtube-summary
obsidian property:set path="$FILE" name=area value=education
obsidian property:set path="$FILE" name=domain value="[[YouTube Content]]"
obsidian property:set path="$FILE" name=source value=youtube
obsidian property:set path="$FILE" name=video_url value="{URL}"
obsidian property:set path="$FILE" name=channel value="{채널명}"
obsidian property:set path="$FILE" name=created value={YYYY-MM-DD}
obsidian property:set path="$FILE" name=updated value={YYYY-MM-DD}
obsidian property:set path="$FILE" name=report_format value={format}
obsidian property:set path="$FILE" name=notebooklm_id value="{notebook_id}"
obsidian property:set path="$FILE" name=status value=Completed
obsidian property:set path="$FILE" name=tags value="youtube,summary,{주제태그}"
obsidian property:set path="$FILE" name=author value="[[frindle]]"

# 4b-3. Obsidian에서 열기
obsidian open path="$FILE"

방법 B: Write 도구 폴백 (Obsidian 미실행 시)

Obsidian CLI 연결 실패(Unable to connect to main process) 시 Write 도구로 직접 파일 생성. YAML frontmatter(2 spaces 들여쓰기) + 보고서 내용을 결합하여 저장 경로에 Write.

---