@yeongjaeyou/claude-code-config 0.16.0 → 0.17.0

package/.claude/skills/youtube-collector/scripts/fetch_videos.py

@@ -0,0 +1,229 @@
+#!/usr/bin/env python3
+"""
+YouTube 채널의 최신 영상 목록을 가져오는 스크립트
+
+Usage:
+    python fetch_videos.py --channel-id UC... [--api-key YOUR_API_KEY] [--max-results 10]
+    python fetch_videos.py --channel-handle @channelname
+
+API 키는 다음 위치에서 자동으로 로드됩니다:
+    - macOS/Linux: ~/.config/youtube-collector/config.yaml
+    - Windows: %APPDATA%\\youtube-collector\\config.yaml
+
+Output:
+    JSON 형식으로 영상 목록 출력
+
+Requirements:
+    pip install google-api-python-client pyyaml
+"""
+
+import argparse
+import json
+import os
+import platform
+import sys
+from datetime import datetime
+
+try:
+    from googleapiclient.discovery import build
+    from googleapiclient.errors import HttpError
+except ImportError:
+    print(json.dumps({
+        "error": "google-api-python-client가 설치되어 있지 않습니다.",
+        "install": "pip install google-api-python-client"
+    }))
+    sys.exit(1)
+
+try:
+    import yaml
+except ImportError:
+    print(json.dumps({
+        "error": "pyyaml이 설치되어 있지 않습니다.",
+        "install": "pip install pyyaml"
+    }))
+    sys.exit(1)
+
+
+def get_api_key_config_path() -> str:
+    """OS별 API 키 설정 파일 경로 반환"""
+    system = platform.system()
+    if system == "Windows":
+        base = os.environ.get("APPDATA", os.path.expanduser("~"))
+        return os.path.join(base, "youtube-collector", "config.yaml")
+    else:  # macOS, Linux
+        xdg_config = os.environ.get("XDG_CONFIG_HOME", os.path.expanduser("~/.config"))
+        return os.path.join(xdg_config, "youtube-collector", "config.yaml")
+
+
+def load_api_key() -> str:
+    """설정 파일에서 API 키 로드"""
+    config_path = get_api_key_config_path()
+
+    if not os.path.exists(config_path):
+        return None
+
+    try:
+        with open(config_path, 'r', encoding='utf-8') as f:
+            config = yaml.safe_load(f)
+            return config.get('api_key') if config else None
+    except Exception:
+        return None
+
+
+def get_channel_id_from_handle(youtube, handle: str) -> str:
+    """채널 핸들(@username)로 채널 ID 조회"""
+    # @를 제거
+    handle = handle.lstrip('@')
+
+    try:
+        response = youtube.search().list(
+            part="snippet",
+            q=f"@{handle}",
+            type="channel",
+            maxResults=1
+        ).execute()
+
+        if response.get('items'):
+            return response['items'][0]['snippet']['channelId']
+        return None
+    except HttpError as e:
+        return None
+
+
+def get_channel_uploads_playlist_id(youtube, channel_id: str) -> str:
+    """채널의 업로드 재생목록 ID 조회 (UC... -> UU...)"""
+    try:
+        response = youtube.channels().list(
+            part="contentDetails",
+            id=channel_id
+        ).execute()
+
+        if response.get('items'):
+            return response['items'][0]['contentDetails']['relatedPlaylists']['uploads']
+        return None
+    except HttpError:
+        return None
+
+
+def fetch_videos(youtube, channel_id: str, max_results: int = 10) -> list:
+    """채널의 최신 영상 목록 조회"""
+    videos = []
+
+    # 업로드 재생목록 ID 가져오기
+    uploads_playlist_id = get_channel_uploads_playlist_id(youtube, channel_id)
+    if not uploads_playlist_id:
+        return videos
+
+    try:
+        # 재생목록에서 영상 ID 목록 가져오기
+        response = youtube.playlistItems().list(
+            part="snippet,contentDetails",
+            playlistId=uploads_playlist_id,
+            maxResults=min(max_results, 50)
+        ).execute()
+
+        video_ids = [item['contentDetails']['videoId'] for item in response.get('items', [])]
+
+        if not video_ids:
+            return videos
+
+        # 영상 상세 정보 가져오기
+        videos_response = youtube.videos().list(
+            part="snippet,contentDetails",
+            id=','.join(video_ids)
+        ).execute()
+
+        for item in videos_response.get('items', []):
+            snippet = item['snippet']
+            content_details = item['contentDetails']
+
+            # 썸네일 URL (최대 해상도 우선)
+            thumbnails = snippet.get('thumbnails', {})
+            thumbnail_url = (
+                thumbnails.get('maxres', {}).get('url') or
+                thumbnails.get('high', {}).get('url') or
+                thumbnails.get('medium', {}).get('url') or
+                thumbnails.get('default', {}).get('url', '')
+            )
+
+            videos.append({
+                'video_id': item['id'],
+                'title': snippet.get('title', ''),
+                'description': snippet.get('description', ''),
+                'published_at': snippet.get('publishedAt', ''),
+                'channel_id': snippet.get('channelId', ''),
+                'channel_title': snippet.get('channelTitle', ''),
+                'thumbnail': thumbnail_url,
+                'duration': content_details.get('duration', ''),
+                'url': f"https://youtube.com/watch?v={item['id']}"
+            })
+
+        return videos
+
+    except HttpError as e:
+        print(json.dumps({
+            "error": f"YouTube API 오류: {e.resp.status}",
+            "message": str(e)
+        }), file=sys.stderr)
+        return videos
+
+
+def main():
+    parser = argparse.ArgumentParser(description='YouTube 채널의 최신 영상 목록 조회')
+    parser.add_argument('--channel-id', help='채널 ID (UC...)')
+    parser.add_argument('--channel-handle', help='채널 핸들 (@username)')
+    parser.add_argument('--api-key', help='YouTube Data API 키 (미지정시 설정 파일에서 로드)')
+    parser.add_argument('--max-results', type=int, default=10, help='최대 결과 수 (기본: 10)')
+
+    args = parser.parse_args()
+
+    if not args.channel_id and not args.channel_handle:
+        print(json.dumps({
+            "error": "--channel-id 또는 --channel-handle 중 하나를 지정해야 합니다."
+        }))
+        sys.exit(1)
+
+    # API 키 결정: 인자 > 설정 파일
+    api_key = args.api_key or load_api_key()
+
+    if not api_key:
+        config_path = get_api_key_config_path()
+        print(json.dumps({
+            "error": "YouTube Data API 키가 설정되지 않았습니다.",
+            "help": f"다음 명령으로 API 키를 설정하세요: python3 setup_api_key.py",
+            "config_path": config_path
+        }))
+        sys.exit(1)
+
+    try:
+        youtube = build('youtube', 'v3', developerKey=api_key)
+    except Exception as e:
+        print(json.dumps({
+            "error": "YouTube API 초기화 실패",
+            "message": str(e)
+        }))
+        sys.exit(1)
+
+    # 채널 ID 결정
+    channel_id = args.channel_id
+    if not channel_id and args.channel_handle:
+        channel_id = get_channel_id_from_handle(youtube, args.channel_handle)
+        if not channel_id:
+            print(json.dumps({
+                "error": f"채널을 찾을 수 없습니다: {args.channel_handle}"
+            }))
+            sys.exit(1)
+
+    # 영상 목록 조회
+    videos = fetch_videos(youtube, channel_id, args.max_results)
+
+    print(json.dumps({
+        "channel_id": channel_id,
+        "fetched_at": datetime.utcnow().isoformat() + "Z",
+        "count": len(videos),
+        "videos": videos
+    }, ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/.claude/skills/youtube-collector/scripts/register_channel.py

@@ -0,0 +1,247 @@
+#!/usr/bin/env python3
+"""
+YouTube 채널을 channels.yaml에 등록하는 스크립트
+
+Usage:
+    python register_channel.py --channel-handle @channelname --output-dir .reference/
+    python register_channel.py --channel-url https://youtube.com/@channelname --output-dir .reference/
+
+Output:
+    JSON 형식으로 등록 결과 출력
+
+Requirements:
+    pip install google-api-python-client pyyaml
+"""
+
+import argparse
+import json
+import os
+import re
+import sys
+from datetime import datetime
+from pathlib import Path
+from urllib.parse import urlparse, unquote
+
+# 같은 디렉토리의 모듈 import
+script_dir = Path(__file__).parent
+sys.path.insert(0, str(script_dir))
+
+try:
+    from fetch_videos import (
+        load_api_key,
+        get_channel_id_from_handle,
+    )
+    from googleapiclient.discovery import build
+except ImportError as e:
+    print(json.dumps({
+        "error": "필요한 모듈을 import할 수 없습니다.",
+        "detail": str(e),
+        "install": "pip install google-api-python-client pyyaml"
+    }))
+    sys.exit(1)
+
+try:
+    import yaml
+except ImportError:
+    print(json.dumps({
+        "error": "pyyaml이 설치되어 있지 않습니다.",
+        "install": "pip install pyyaml"
+    }))
+    sys.exit(1)
+
+
+def extract_handle_from_url(url: str) -> str:
+    """YouTube URL에서 채널 핸들 추출"""
+    # URL 디코딩
+    url = unquote(url)
+
+    # URL 파싱
+    parsed = urlparse(url)
+    path = parsed.path
+
+    # @username 형식 (예: youtube.com/@channelname)
+    match = re.match(r'^/@([^/]+)', path)
+    if match:
+        return '@' + match.group(1)
+
+    # /channel/UC... 형식
+    match = re.match(r'^/channel/(UC[a-zA-Z0-9_-]+)', path)
+    if match:
+        return match.group(1)  # 채널 ID 반환
+
+    # /c/customname 형식
+    match = re.match(r'^/c/([^/]+)', path)
+    if match:
+        return '@' + match.group(1)
+
+    # /user/username 형식
+    match = re.match(r'^/user/([^/]+)', path)
+    if match:
+        return '@' + match.group(1)
+
+    return None
+
+
+def get_channel_info(youtube, channel_id: str) -> dict:
+    """채널 ID로 채널 상세 정보 조회"""
+    try:
+        response = youtube.channels().list(
+            part="snippet",
+            id=channel_id
+        ).execute()
+
+        if response.get('items'):
+            snippet = response['items'][0]['snippet']
+            return {
+                'id': channel_id,
+                'name': snippet.get('title', ''),
+                'description': snippet.get('description', ''),
+                'custom_url': snippet.get('customUrl', '')
+            }
+        return None
+    except Exception:
+        return None
+
+
+def load_channels(channels_file: Path) -> dict:
+    """channels.yaml 로드"""
+    if not channels_file.exists():
+        return {'channels': []}
+
+    try:
+        with open(channels_file, 'r', encoding='utf-8') as f:
+            data = yaml.safe_load(f)
+            return data if data else {'channels': []}
+    except Exception:
+        return {'channels': []}
+
+
+def save_channels(channels_file: Path, data: dict):
+    """channels.yaml 저장"""
+    # 부모 폴더 생성
+    channels_file.parent.mkdir(parents=True, exist_ok=True)
+
+    with open(channels_file, 'w', encoding='utf-8') as f:
+        yaml.dump(data, f, allow_unicode=True, default_flow_style=False, sort_keys=False)
+
+
+def main():
+    parser = argparse.ArgumentParser(description='YouTube 채널 등록')
+    parser.add_argument('--channel-handle', help='채널 핸들 (@username)')
+    parser.add_argument('--channel-url', help='채널 URL')
+    parser.add_argument('--channel-id', help='채널 ID (UC...)')
+    parser.add_argument('--output-dir', default='.reference', help='저장 디렉토리 (기본: .reference)')
+    parser.add_argument('--api-key', help='YouTube Data API 키 (미지정시 설정 파일에서 로드)')
+
+    args = parser.parse_args()
+
+    # 옵션 검증
+    if not args.channel_handle and not args.channel_url and not args.channel_id:
+        print(json.dumps({
+            "error": "--channel-handle, --channel-url, --channel-id 중 하나를 지정해야 합니다."
+        }))
+        sys.exit(1)
+
+    # API 키 로드
+    api_key = args.api_key or load_api_key()
+    if not api_key:
+        print(json.dumps({
+            "error": "YouTube Data API 키가 설정되지 않았습니다.",
+            "help": "python3 scripts/setup_api_key.py로 설정해주세요."
+        }))
+        sys.exit(1)
+
+    # YouTube API 초기화
+    try:
+        youtube = build('youtube', 'v3', developerKey=api_key)
+    except Exception as e:
+        print(json.dumps({
+            "error": "YouTube API 초기화 실패",
+            "message": str(e)
+        }))
+        sys.exit(1)
+
+    # 채널 핸들/ID 결정
+    channel_handle = args.channel_handle
+    channel_id = args.channel_id
+
+    if args.channel_url:
+        extracted = extract_handle_from_url(args.channel_url)
+        if not extracted:
+            print(json.dumps({
+                "error": "URL에서 채널 정보를 추출할 수 없습니다.",
+                "url": args.channel_url
+            }))
+            sys.exit(1)
+
+        if extracted.startswith('UC'):
+            channel_id = extracted
+        else:
+            channel_handle = extracted
+
+    # 채널 ID 조회
+    if not channel_id and channel_handle:
+        channel_id = get_channel_id_from_handle(youtube, channel_handle)
+        if not channel_id:
+            print(json.dumps({
+                "error": f"채널을 찾을 수 없습니다: {channel_handle}"
+            }))
+            sys.exit(1)
+
+    # 채널 상세 정보 조회
+    channel_info = get_channel_info(youtube, channel_id)
+    if not channel_info:
+        print(json.dumps({
+            "error": f"채널 정보를 가져올 수 없습니다: {channel_id}"
+        }))
+        sys.exit(1)
+
+    # 핸들 결정 (없으면 custom_url 사용)
+    if not channel_handle:
+        custom_url = channel_info.get('custom_url', '')
+        if custom_url:
+            channel_handle = custom_url if custom_url.startswith('@') else '@' + custom_url
+        else:
+            channel_handle = '@' + channel_id  # fallback
+
+    # channels.yaml 로드
+    channels_file = Path(args.output_dir) / "channels.yaml"
+    data = load_channels(channels_file)
+
+    # 중복 체크
+    existing_ids = {ch.get('id') for ch in data.get('channels', [])}
+    if channel_id in existing_ids:
+        print(json.dumps({
+            "status": "already_registered",
+            "message": f"채널이 이미 등록되어 있습니다: {channel_info['name']}",
+            "channel": {
+                "id": channel_id,
+                "handle": channel_handle,
+                "name": channel_info['name']
+            }
+        }))
+        sys.exit(0)
+
+    # 채널 추가
+    new_channel = {
+        'id': channel_id,
+        'handle': channel_handle,
+        'name': channel_info['name'],
+        'added_at': datetime.now().strftime('%Y-%m-%d')
+    }
+
+    data['channels'].append(new_channel)
+
+    # 저장
+    save_channels(channels_file, data)
+
+    print(json.dumps({
+        "status": "registered",
+        "message": f"채널이 등록되었습니다: {channel_info['name']}",
+        "channel": new_channel,
+        "file": str(channels_file)
+    }, ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/.claude/skills/youtube-collector/scripts/setup_api_key.py

@@ -0,0 +1,151 @@
+#!/usr/bin/env python3
+"""
+YouTube Data API 키를 설정하는 스크립트
+
+사용자로부터 API 키를 입력받아 OS별 적절한 경로에 저장합니다.
+
+저장 경로:
+    - macOS/Linux: ~/.config/youtube-collector/config.yaml
+    - Windows: %APPDATA%\\youtube-collector\\config.yaml
+
+Usage:
+    python setup_api_key.py                    # 대화형 입력
+    python setup_api_key.py --api-key KEY      # 직접 지정
+    python setup_api_key.py --show             # 현재 설정 확인
+    python setup_api_key.py --path             # 설정 파일 경로 출력
+"""
+
+import argparse
+import os
+import platform
+import sys
+
+
+def get_config_path() -> str:
+    """OS별 설정 파일 경로 반환"""
+    system = platform.system()
+    if system == "Windows":
+        base = os.environ.get("APPDATA", os.path.expanduser("~"))
+        return os.path.join(base, "youtube-collector", "config.yaml")
+    else:  # macOS, Linux
+        xdg_config = os.environ.get("XDG_CONFIG_HOME", os.path.expanduser("~/.config"))
+        return os.path.join(xdg_config, "youtube-collector", "config.yaml")
+
+
+def load_config(config_path: str) -> dict:
+    """기존 설정 로드"""
+    if not os.path.exists(config_path):
+        return {}
+
+    try:
+        import yaml
+        with open(config_path, 'r', encoding='utf-8') as f:
+            return yaml.safe_load(f) or {}
+    except ImportError:
+        # yaml 없으면 간단히 파싱
+        config = {}
+        with open(config_path, 'r', encoding='utf-8') as f:
+            for line in f:
+                line = line.strip()
+                if line and not line.startswith('#') and ':' in line:
+                    key, value = line.split(':', 1)
+                    config[key.strip()] = value.strip().strip('"\'')
+        return config
+    except Exception:
+        return {}
+
+
+def save_config(config_path: str, config: dict):
+    """설정 저장"""
+    # 디렉토리 생성
+    config_dir = os.path.dirname(config_path)
+    os.makedirs(config_dir, exist_ok=True)
+
+    try:
+        import yaml
+        with open(config_path, 'w', encoding='utf-8') as f:
+            f.write("# YouTube Collector API 설정\n")
+            f.write("# 이 파일은 자동 생성되었습니다.\n\n")
+            yaml.dump(config, f, default_flow_style=False, allow_unicode=True)
+    except ImportError:
+        # yaml 없으면 수동 작성
+        with open(config_path, 'w', encoding='utf-8') as f:
+            f.write("# YouTube Collector API 설정\n")
+            f.write("# 이 파일은 자동 생성되었습니다.\n\n")
+            for key, value in config.items():
+                f.write(f'{key}: "{value}"\n')
+
+
+def mask_api_key(key: str) -> str:
+    """API 키 마스킹 (앞 8자, 뒤 4자만 표시)"""
+    if not key or len(key) < 16:
+        return "***"
+    return f"{key[:8]}...{key[-4:]}"
+
+
+def main():
+    parser = argparse.ArgumentParser(description='YouTube Data API 키 설정')
+    parser.add_argument('--api-key', help='설정할 API 키')
+    parser.add_argument('--show', action='store_true', help='현재 설정 확인')
+    parser.add_argument('--path', action='store_true', help='설정 파일 경로 출력')
+
+    args = parser.parse_args()
+
+    config_path = get_config_path()
+
+    # 경로만 출력
+    if args.path:
+        print(config_path)
+        return
+
+    # 현재 설정 확인
+    if args.show:
+        if os.path.exists(config_path):
+            config = load_config(config_path)
+            api_key = config.get('api_key', '')
+            print(f"설정 파일: {config_path}")
+            print(f"API 키: {mask_api_key(api_key) if api_key else '(설정되지 않음)'}")
+        else:
+            print(f"설정 파일이 없습니다: {config_path}")
+        return
+
+    # API 키 설정
+    api_key = args.api_key
+
+    if not api_key:
+        # 대화형 입력
+        print("YouTube Data API 키 설정")
+        print("-" * 40)
+        print(f"설정 파일 경로: {config_path}")
+        print()
+        print("API 키 발급 방법:")
+        print("1. https://console.cloud.google.com/ 접속")
+        print("2. 프로젝트 생성/선택")
+        print("3. YouTube Data API v3 활성화")
+        print("4. 사용자 인증 정보 > API 키 생성")
+        print()
+
+        try:
+            api_key = input("API 키를 입력하세요: ").strip()
+        except (KeyboardInterrupt, EOFError):
+            print("\n취소되었습니다.")
+            sys.exit(1)
+
+    if not api_key:
+        print("API 키가 입력되지 않았습니다.")
+        sys.exit(1)
+
+    # 기존 설정 로드 및 업데이트
+    config = load_config(config_path)
+    config['api_key'] = api_key
+
+    # 저장
+    save_config(config_path, config)
+
+    print()
+    print(f"API 키가 저장되었습니다: {config_path}")
+    print(f"저장된 키: {mask_api_key(api_key)}")
+
+
+if __name__ == "__main__":
+    main()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeongjaeyou/claude-code-config",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Claude Code CLI custom commands, agents, and skills",
   "bin": {
     "claude-code-config": "./bin/cli.js"