agentleFS
greatSuminigreatSumini/cc-system/.claude/skills/youtube-collector/SKILL.md

youtube-collector

Skill438 starsChanged 7 months agoMITView on GitHub

유튜브 채널을 등록하고 새 컨텐츠를 수집하여 자막 기반 요약을 생성하는 skill. 사용자가 (1) 유튜브 채널 등록/관리를 요청하거나, (2) 등록된 채널의 새 영상 수집을 요청하거나, (3) 유튜브 영상 요약을 요청할 때 사용. 데이터는 .reference/ 폴더에 YAML 형식으로 저장됨.

  • Reads credentials
  • Installs packages

The file

Files
SKILL.md

YouTube Collector

등록된 유튜브 채널의 새 컨텐츠를 수집하고 자막 기반 요약을 생성.

사전 요구사항

필수 패키지:

pip install google-api-python-client youtube-transcript-api pyyaml

API 키 설정: 보안을 위해 API 키는 사용자 홈 디렉토리에 저장됨.

# API 키 설정 (대화형)
python3 scripts/setup_api_key.py

# 또는 직접 지정
python3 scripts/setup_api_key.py --api-key YOUR_API_KEY

# 현재 설정 확인
python3 scripts/setup_api_key.py --show

설정 파일 경로:

  • macOS/Linux: ~/.config/youtube-collector/config.yaml
  • Windows: %APPDATA%\youtube-collector\config.yaml

워크플로우

1. 채널 등록

채널 URL 또는 핸들로 등록:

# 핸들로 등록
python3 scripts/register_channel.py --channel-handle @channelname --output-dir .reference/

# URL로 등록
python3 scripts/register_channel.py --channel-url "https://youtube.com/@channelname" --output-dir .reference/

결과: .reference/channels.yaml에 채널 정보가 추가됨.

2. 컨텐츠 수집

스크립트가 영상 목록 조회 + 자막 수집 + YAML 파일 저장을 자동으로 처리:

# 특정 채널 수집
python3 scripts/collect_videos.py --channel-handle @channelname --output-dir .reference/ --max-results 10

# 등록된 모든 채널 수집
python3 scripts/collect_videos.py --all --output-dir .reference/

결과: .reference/contents/{channel_handle}/{video_id}.yaml 파일들이 생성됨.

3. 요약 생성

수집 결과 JSON에서 새로 추가된 영상 확인 후, 각 영상의 YAML 파일에 summary 필드 추가:

summary:
  source: "transcript"  # 또는 "description" (자막 없을 때)
  content: |
    ## 서론
    - 문제 제기 또는 주제 소개
    - 영상의 목적/배경

    ## 본론
    - 핵심 내용 상세 설명
    - 해결책, 방법론, 예시 등
    - 주요 포인트별 정리

    ## 결론
    - 핵심 요약
    - 시사점 또는 다음 단계

요약 생성 기준:

  • transcript.available: true → 자막 기반 요약, summary.source: "transcript"
  • transcript.available: false → 설명 기반 요약, summary.source: "description"

4. 데이터 조회

수집된 컨텐츠 확인:

  • .reference/contents/ 폴더 구조 확인
  • 특정 채널/영상의 YAML 파일 읽어서 정보 제공

스크립트 옵션

register_channel.py

옵션설명
--channel-handle채널 핸들 (@username)
--channel-url채널 URL
--channel-id채널 ID (UC...)
--output-dir저장 디렉토리 (기본: .reference)

collect_videos.py

옵션설명
--channel-handle특정 채널 핸들
--channel-id특정 채널 ID
--allchannels.yaml의 모든 채널 처리
--output-dir저장 디렉토리 (기본: .reference)
--max-results채널당 최대 수집 개수 (기본: 10)
--language자막 우선 언어 (기본: ko)
--no-skip-existing기존 파일 덮어쓰기

데이터 구조

상세 스키마: references/data-schema.md

영상 데이터 예시

video_id: "abc123"
title: "영상 제목"
published_at: "2025-12-10T10:00:00Z"
url: "https://youtube.com/watch?v=abc123"
thumbnail: "https://..."
description: "영상 설명..."
duration: "PT10M30S"
collected_at: "2025-12-13T15:00:00Z"
transcript:
  available: true
  language: "ko"
  text: "자막 전체..."
summary:
  source: "transcript"
  content: |
    ## 서론
    - 영상의 배경 및 목적

    ## 본론
    - 핵심 내용 1
    - 핵심 내용 2

    ## 결론
    - 핵심 요약

에러 처리

상황안내 메시지
API 키 미설정"YouTube Data API 키가 필요합니다. python3 scripts/setup_api_key.py로 설정해주세요."
채널 미등록"등록된 채널이 없습니다. 먼저 채널을 등록해주세요."
패키지 미설치"필요한 패키지를 설치해주세요: pip install google-api-python-client youtube-transcript-api pyyaml"
API 할당량 초과"YouTube API 할당량이 초과되었습니다. 내일 다시 시도해주세요."

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.