ytcollector 1.0.7__py3-none-any.whl → 1.0.9__py3-none-any.whl

ytcollector/downloader.py

@@ -1,466 +1,341 @@
-"""
-YouTube Video Downloader Module
-yt-dlp 기반 YouTube 영상 다운로드 및 특정 구간 추출
-"""
-from pathlib import Path
-from typing import Optional, Tuple, List, Dict
-import logging
-
-import yt_dlp
-from yt_dlp.utils import download_range_func
-
-from .config import (
-    VIDEO_FORMAT,
-    DOWNLOAD_RETRIES,
-    CLIP_DURATION_BEFORE,
-    CLIP_DURATION_AFTER,
-)
-from .utils import extract_video_id, get_clip_path
-
-logger = logging.getLogger(__name__)
-
-
-class LimitReachedError(Exception):
-    """다운로드 제한 도달 예외"""
-    pass
-
-
-class VideoDownloader:
-    """YouTube 영상 다운로더 클래스"""
-    
-    def __init__(self, task_type: str, base_dir: Path = None):
-        self.task_type = task_type
-        self.base_dir = base_dir or Path.cwd()
-    
-    def get_video_info(self, url: str) -> dict:
-        """영상 메타데이터 조회 (다운로드 없이)"""
-        ydl_opts = {
-            'quiet': True,
-            'no_warnings': True,
-            'extract_flat': False,
-        }
-        
-        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
-            info = ydl.extract_info(url, download=False)
-            return {
-                'id': info.get('id'),
-                'title': info.get('title'),
-                'duration': info.get('duration'),
-                'channel': info.get('channel'),
-                'upload_date': info.get('upload_date'),
-            }
-            
-    def search_youtube(self, query: str, max_results: int = 50) -> List[Dict]:
-        """YouTube 검색을 통해 상위 결과의 URL 목록 반환"""
-        ydl_opts = {
-            'quiet': True,
-            'no_warnings': True,
-            'extract_flat': True,
-            'force_generic_extractor': False,
-        }
-        
-        search_query = f"ytsearch{max_results}:{query}"
-        logger.info(f"Searching YouTube for: '{query}' (Max {max_results} results)")
-        
-        results = []
-        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+import os
+import time
+import random
+import shutil
+from concurrent.futures import ThreadPoolExecutor, as_completed
+
+from yt_dlp import YoutubeDL
+
+from .config import USER_AGENTS, CATEGORY_QUERIES, CATEGORY_NAMES, SKIP_ERRORS
+from .analyzer import VideoAnalyzer
+
+
+class YouTubeDownloader:
+    """YouTube 다운로더 클래스"""
+
+    def __init__(self, output_path, max_duration=180, proxy=None, fast_mode=False, workers=3):
+        self.output_path = output_path
+        self.max_duration = max_duration
+        self.proxy = proxy
+        self.fast_mode = fast_mode
+        self.workers = workers
+        self.analyzer = VideoAnalyzer()
+        self.query_index = {}
+
+        os.makedirs(output_path, exist_ok=True)
+
+    def _get_ua(self):
+        return random.choice(USER_AGENTS)
+
+    def _get_query(self, category):
+        """검색어 순환 반환"""
+        if category not in self.query_index:
+            self.query_index[category] = 0
+
+        queries = CATEGORY_QUERIES[category]
+        query = queries[self.query_index[category]]
+        self.query_index[category] = (self.query_index[category] + 1) % len(queries)
+        return query
+
+    def _format_duration(self, seconds):
+        if not seconds:
+            return "?"
+        return f"{int(seconds // 60)}:{int(seconds % 60):02d}"
+
+    def _download_one(self, url, quiet=False):
+        """단일 영상 다운로드"""
+        archive = os.path.join(self.output_path, '.archive.txt')
+        last_file = None
+
+        def hook(d):
+            nonlocal last_file
+            if d['status'] == 'finished':
+                last_file = d.get('filename')
+            elif d['status'] == 'downloading' and not quiet:
+                pct = d.get('_percent_str', '0%').strip()
+                spd = d.get('_speed_str', 'N/A').strip()
+                print(f"\r  다운로드: {pct} | {spd}", end='', flush=True)
+
+        max_retries = 1 if self.fast_mode else 3
+
+        for attempt in range(max_retries):
             try:
-                info = ydl.extract_info(search_query, download=False)
-                if 'entries' in info:
-                    for entry in info['entries']:
-                        if entry:
-                            results.append({
-                                'url': f"https://www.youtube.com/watch?v={entry['id']}",
-                                'title': entry.get('title'),
-                                'id': entry['id']
-                            })
+                opts = {
+                    'outtmpl': os.path.join(self.output_path, '%(title)s.%(ext)s'),
+                    'format': 'best[ext=mp4]/best',
+                    'progress_hooks': [hook],
+                    'quiet': True,
+                    'no_warnings': True,
+                    'download_archive': archive,
+                    'http_headers': {'User-Agent': self._get_ua()},
+                    'socket_timeout': 10 if self.fast_mode else 30,
+                }
+
+                if self.proxy:
+                    opts['proxy'] = self.proxy
+
+                if attempt > 0:
+                    time.sleep(min(2 ** attempt, 10))
+
+                with YoutubeDL(opts) as ydl:
+                    info = ydl.extract_info(url, download=True)
+                    if info is None:
+                        return "skipped", None, None
+
+                    title = info.get('title', 'Unknown')
+
+                    if last_file and os.path.exists(last_file):
+                        return "ok", last_file, title
+
+                    ext = info.get('ext', 'mp4')
+                    path = os.path.join(self.output_path, f"{title}.{ext}")
+                    if os.path.exists(path):
+                        return "ok", path, title
+
+                    return "ok", None, title
+
             except Exception as e:
-                logger.error(f"Search failed: {e}")
-                
-        return results
-    
-    def calculate_clip_range(
-        self, 
-        timestamp_sec: int, 
-        video_duration: int
-    ) -> Tuple[int, int]:
-        """타임스탬프 기준 ±1분 30초 클립 범위 계산"""
-        start = max(0, timestamp_sec - CLIP_DURATION_BEFORE)
-        end = min(video_duration, timestamp_sec + CLIP_DURATION_AFTER)
-        return start, end
-    
-    def download_segment(
-        self, 
-        url: str, 
-        start_sec: int, 
-        end_sec: int,
-        output_path: Optional[Path] = None
-    ) -> Path:
-        """특정 구간만 다운로드"""
-        video_id = extract_video_id(url)
-        
-        if output_path is None:
-            filename = f"{video_id}_{start_sec}-{end_sec}"
-            output_path = get_clip_path(self.base_dir, self.task_type, filename)
-        
-        output_template = str(output_path).replace('.mp4', '')
-        
-        ydl_opts = {
-            'format': VIDEO_FORMAT,
-            'outtmpl': f"{output_template}.%(ext)s",
-            'retries': DOWNLOAD_RETRIES,
-            'quiet': False,
-            'no_warnings': False,
-            'download_ranges': download_range_func(None, [(start_sec, end_sec)]),
-            'force_keyframes_at_cuts': True,
-        }
-
-        # Use ffmpeg from imageio-ffmpeg
-        try:
-            import imageio_ffmpeg
-            ffmpeg_path = imageio_ffmpeg.get_ffmpeg_exe()
-            ydl_opts['ffmpeg_location'] = ffmpeg_path
-            logger.debug(f"Using ffmpeg from: {ffmpeg_path}")
-        except ImportError:
-            logger.warning("imageio-ffmpeg not found, relying on system ffmpeg")
-        
-        logger.info(f"Downloading segment [{start_sec}s - {end_sec}s] from: {url}")
-        
-        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
-            ydl.download([url])
-        
-        return output_path
-    
-    def get_saved_video_count(self) -> int:
-        """현재 태스크 폴더에 저장된 영상 개수 확인"""
-        from .utils import get_task_video_count
-        return get_task_video_count(self.base_dir, self.task_type)
-
-    def _get_history_key(self, url: str, timestamp_min: int, timestamp_sec: int) -> str:
-        """히스토리 키 생성"""
-        video_id = extract_video_id(url)
-        return f"{self.task_type}_{video_id}_{timestamp_min}_{timestamp_sec}"
-
-    def download_clip_at_timestamp(
-        self, 
-        url: str, 
-        timestamp_min: int, 
-        timestamp_sec: int
-    ) -> Tuple[Optional[Path], Optional[dict]]:
-        """
-        특정 타임스탬프 기준으로 ±1:30 클립 다운로드
-        1. 임시 폴더에 다운로드
-        2. YOLO 검증 (타겟 객체 유무 확인)
-        3. 검증 통과 시 최종 경로로 이동 (task_xxxx.mp4)
-        """
-        from .config import MAX_VIDEOS_PER_TASK
-        from .utils import load_history, save_history, get_clip_path, ensure_dir
-        from .verifier import verify_clip
-        import shutil
-        
-        target_sec = timestamp_min * 60 + timestamp_sec
-        history_key = self._get_history_key(url, timestamp_min, timestamp_sec)
-        
-        # 1. 히스토리 기반 중복 확인
-        history = load_history(self.base_dir)
-        if history_key in history:
-            saved_path = history[history_key].get('output_path', 'unknown')
-            # 파일이 실제로 존재하는지도 확인하면 좋음
-            if Path(saved_path).exists():
-                logger.info(f"Skipping download (already in history): {saved_path}")
-                return Path(saved_path), {'cached': True, 'output_path': saved_path}
-
-        # 2. 개수 제한 확인
-        current_count = self.get_saved_video_count()
-        if current_count >= MAX_VIDEOS_PER_TASK:
-            msg = f"Task limit reached ({current_count}/{MAX_VIDEOS_PER_TASK}). Stopping download."
-            logger.warning(msg)
-            raise LimitReachedError(msg)
-        
-        # 3. 영상 정보 조회
-        try:
-            info = self.get_video_info(url)
-        except Exception as e:
-            logger.error(f"Failed to get video info: {e}")
-            raise
-
-        video_duration = info.get('duration', 0)
-        
-        if video_duration == 0:
-            raise ValueError(f"Cannot get video duration for: {url}")
-        
-        start_sec, end_sec = self.calculate_clip_range(target_sec, video_duration)
-        clip_duration = end_sec - start_sec
-        
-        logger.info(
-            f"Target: {timestamp_min}:{timestamp_sec:02d}, "
-            f"Clip range: {start_sec}s - {end_sec}s (duration: {clip_duration}s)"
-        )
-        
-        # 4. 임시 파일 다운로드
-        # temp 폴더 생성
-        temp_dir = ensure_dir(self.base_dir / "temp")
-        video_id = extract_video_id(url)
-        temp_filename = f"temp_{video_id}_{timestamp_min}_{timestamp_sec}.mp4"
-        temp_path = temp_dir / temp_filename
-        
+                err = str(e).lower()
+
+                if "already" in err or "recorded" in err:
+                    return "skipped", None, None
+
+                if any(s in err for s in SKIP_ERRORS):
+                    return "unavailable", None, None
+
+        return "failed", None, None
+
+    def _search(self, query, count=10):
+        """영상 검색"""
         try:
-            self.download_segment(url, start_sec, end_sec, temp_path)
-            
-            # 5. YOLO 검증
-            logger.info(f"Verifying content for task: {self.task_type}...")
-            # verifier 모듈 사용하여 검증
-            verify_result = verify_clip(temp_path, self.task_type, self.base_dir)
-            
-            if not verify_result.get('is_valid', False):
-                logger.warning(f"Verification failed: No {self.task_type} detected. Deleting...")
-                if temp_path.exists():
-                    temp_path.unlink()
-                return None, None
-            
-            # 6. 검증 통과 -> 최종 저장 (순차적 파일명 생성)
-            final_path = get_clip_path(self.base_dir, self.task_type, filename=None)
-            
-            # 이동 (네트워크 드라이브면 shutil.move 사용)
-            shutil.move(str(temp_path), str(final_path))
-            logger.info(f"Saved verified video to: {final_path}")
-            
-            metadata = {
-                **info,
-                'target_timestamp_sec': target_sec,
-                'clip_start_sec': start_sec,
-                'clip_end_sec': end_sec,
-                'clip_duration': clip_duration,
-                'output_path': str(final_path),
-                'timestamp': timestamp_min * 60 + timestamp_sec,
-                'verification': verify_result
+            opts = {
+                'quiet': True,
+                'no_warnings': True,
+                'extract_flat': 'in_playlist',
+                'http_headers': {'User-Agent': self._get_ua()},
+                'socket_timeout': 10,
             }
-            
-            # 7. 히스토리 업데이트
-            history = load_history(self.base_dir)
-            history[history_key] = metadata
-            save_history(self.base_dir, history)
-            
-            return final_path, metadata
-            
-        except Exception as e:
-            logger.error(f"Error during processing: {e}")
-            # 에러 발생 시 임시 파일 정리
-            if temp_path.exists():
-                temp_path.unlink()
-            raise
-
-
-def parse_txt_line(line: str) -> Optional[Dict]:
-    """
-    텍스트 파일 한 줄 파싱
-    형식: task_type,url,timestamp_min,timestamp_sec,description
-    """
-    parts = [p.strip() for p in line.split(',')]
-    if len(parts) < 4:
-        return None
-    
-    # 헤더 체크
-    if parts[0] == 'task_type' and parts[2] == 'timestamp_min':
-        return None
-        
-    try:
-        return {
-            'task_type': parts[0],
-            'url': parts[1],
-            'timestamp_min': int(parts[2]),
-            'timestamp_sec': int(parts[3]),
-            'description': parts[4] if len(parts) > 4 else ''
-        }
-    except ValueError:
-        return None
-
-
-def download_from_txt(txt_path: Path, task_type: str, base_dir: Path = None, max_count: int = None) -> list:
-    """TXT 파일에서 다운로드 실행 (순차)"""
-    # 기존 로직을 process_single_item 함수로 분리하여 재사용할 수 있으면 좋겠지만,
-    # 코드 구조상 일단 순차 실행 유지하고 parallel 함수 별도 구현
-    return _process_download_loop(txt_path, task_type, base_dir, parallel=False, max_count=max_count)
-
-
-def download_from_txt_parallel(txt_path: Path, task_type: str, base_dir: Path = None, max_count: int = None) -> list:
-    """TXT 파일에서 병렬 다운로드 실행 (Fast Mode)"""
-    return _process_download_loop(txt_path, task_type, base_dir, parallel=True, max_count=max_count)
-
-
-def _process_download_loop(txt_path: Path, task_type: str, base_dir: Path = None, parallel: bool = False, max_count: int = None) -> list:
-    from .config import MAX_VIDEOS_PER_TASK, MAX_WORKERS, REQUEST_DELAY_MIN, REQUEST_DELAY_MAX
-    import time
-    import random
-    from concurrent.futures import ThreadPoolExecutor, as_completed
-    
-    # max_count가 없으면 config의 기본값 사용
-    limit = max_count if max_count is not None else MAX_VIDEOS_PER_TASK
-
-    results = []
-    downloader = VideoDownloader(task_type, base_dir)
-    
-    # 시작 전 개수 확인
-    initial_count = downloader.get_saved_video_count()
-    if initial_count >= limit:
-        logger.warning(f"Task '{task_type}' already has {initial_count} videos (Limit: {limit}). Skipping.")
-        return results
-    
-    if not txt_path.exists():
-        logger.error(f"File not found: {txt_path}")
-        return results
-
-    lines = txt_path.read_text(encoding='utf-8').splitlines()
-    items = []
-    
-    for line in lines:
-        if not line.strip() or line.startswith('#'):
-            continue
-        data = parse_txt_line(line)
-        if data and data['task_type'] == task_type:
-            items.append(data)
-
-    if not items:
-        return results
-
-    logger.info(f"Found {len(items)} URLs. Target: {limit} videos (Current: {initial_count}). Starting {'parallel' if parallel else 'sequential'} download...")
-
-    def process_item(data):
-        # 현재 개수 체크 (루프 도중 목표 달성 시 중단 위함)
-        # 주의: 병렬 처리 시 정확한 count 동기화는 Lock이 필요하지만, 여기선 대략적인 체크로 충분
-        current = downloader.get_saved_video_count()
-        if current >= limit:
-            raise LimitReachedError("Target count reached")
-
-        # 방화벽 우회용 랜덤 딜레이 (병렬 모드에서도 적용하여 동시 요청 폭주 완화)
-        if parallel:
-            time.sleep(random.uniform(REQUEST_DELAY_MIN, REQUEST_DELAY_MAX))
-            
-        try:
-            # VideoDownloader 내부의 limit 체크는 config 값을 쓰므로, 
-            # 여기서는 외부에서 주입된 limit을 강제할 방법이 필요하거나, 
-            # 단순히 루프 레벨에서 제어하면 됨.
-            # download_clip_at_timestamp 메서드는 내부적으로 MAX_VIDEOS_PER_TASK를 체크하므로,
-            # 이를 우회하거나 단순 루프 제어로 처리.
-            
-            output_path, metadata = downloader.download_clip_at_timestamp(
-                url=data['url'],
-                timestamp_min=data['timestamp_min'],
-                timestamp_sec=data['timestamp_sec']
-            )
-            
-            if output_path is None:
-                return {
-                    'success': False,
-                    'url': data['url'],
-                    'error': 'Verification failed',
-                    'status': 'skipped'
-                }
+            if self.proxy:
+                opts['proxy'] = self.proxy
 
-            if metadata and metadata.get('cached'):
-                return {
-                    'success': True,
-                    'output_path': str(output_path),
-                    'metadata': metadata,
-                    'status': 'cached'
-                }
-                
-            return {
-                'success': True,
-                'output_path': str(output_path),
-                'metadata': metadata,
-                'status': 'downloaded'
-            }
-            
-        except LimitReachedError:
-            # 내부에서 발생한 LimitReachedError도 처리
-            return {'success': False, 'error': 'Limit reached', 'status': 'limit_reached'}
-            
+            with YoutubeDL(opts) as ydl:
+                result = ydl.extract_info(f"ytsearch{count}:{query}", download=False)
+
+            return list(result.get('entries', [])) if result else []
         except Exception as e:
-            # "에러가 나면 pass" -> 로그만 남기고 실패 결과 반환
-            logger.warning(f"Error processing {data['url']}: {e}")
-            return {
-                'success': False,
-                'url': data['url'],
-                'error': str(e),
-                'status': 'error'
+            print(f"  검색 에러: {e}")
+            return []
+
+    def _get_duration(self, video_id):
+        """영상 길이 조회"""
+        try:
+            url = f"https://www.youtube.com/watch?v={video_id}"
+            opts = {
+                'quiet': True,
+                'no_warnings': True,
+                'http_headers': {'User-Agent': self._get_ua()},
+                'socket_timeout': 5,
             }
+            if self.proxy:
+                opts['proxy'] = self.proxy
+
+            with YoutubeDL(opts) as ydl:
+                info = ydl.extract_info(url, download=False)
+                return info.get('duration')
+        except:
+            return None
+
+    def _process_video(self, entry, category, cat_name):
+        """단일 영상 처리 (다운로드 + 분석)"""
+        vid = entry.get('id')
+        url = f"https://www.youtube.com/watch?v={vid}"
+        title = entry.get('title', '?')[:45]
+
+        status, filepath, _ = self._download_one(url, quiet=True)
 
-    # --- 1단계: youtube_url.txt 파일 목록 처리 ---
-    if items:
-        if parallel:
-            with ThreadPoolExecutor(max_workers=MAX_WORKERS) as executor:
-                futures = [executor.submit(process_item, item) for item in items]
-                
-                # 진행 상황 표시
-                from tqdm import tqdm
-                for future in tqdm(as_completed(futures), total=len(items), desc="Fast Download"):
+        result_info = {'title': title, 'status': status, 'saved': False}
+
+        if status == "ok" and filepath:
+            analysis = self.analyzer.analyze(filepath)
+
+            detected = []
+            if analysis['face']:
+                detected.append(f"얼굴({analysis['face_count']})")
+            if analysis['text']:
+                detected.append("텍스트")
+            if analysis['license_plate']:
+                detected.append("번호판")
+            if analysis['tattoo']:
+                detected.append("타투")
+
+            result_info['detected'] = detected
+
+            if analysis.get(category):
+                dest_dir = os.path.join(self.output_path, cat_name)
+                os.makedirs(dest_dir, exist_ok=True)
+                dest = os.path.join(dest_dir, os.path.basename(filepath))
+                if not os.path.exists(dest):
+                    shutil.move(filepath, dest)
+                result_info['saved'] = True
+            else:
+                if category == 'license_plate':
+                    dest_dir = os.path.join(self.output_path, "번호판_미감지")
+                    os.makedirs(dest_dir, exist_ok=True)
+                    dest = os.path.join(dest_dir, os.path.basename(filepath))
+                    if not os.path.exists(dest):
+                        shutil.move(filepath, dest)
+                    result_info['undetected_saved'] = True
+                else:
                     try:
-                        res = future.result()
-                        results.append(res)
-                        if res.get('status') == 'limit_reached' or downloader.get_saved_video_count() >= limit:
-                            logger.info(f"Download limit ({limit}) reached. Stopping.")
-                            executor.shutdown(wait=False, cancel_futures=True)
-                            break
-                    except Exception:
-                        continue
-        else:
-            # 순차 실행
-            for item in items:
-                if downloader.get_saved_video_count() >= limit:
-                    break
-                res = process_item(item)
-                results.append(res)
-                if res.get('status') == 'limit_reached':
+                        os.remove(filepath)
+                    except:
+                        pass
+
+        return result_info
+
+    def collect(self, category, max_videos=5):
+        """카테고리별 영상 수집"""
+        cat_name = CATEGORY_NAMES[category]
+        query = self._get_query(category)
+
+        print(f"\n{'='*60}")
+        print(f"[{cat_name}] 검색: {query}")
+        mode = "⚡ 고속" if self.fast_mode else "일반"
+        print(f"목표: {max_videos}개 | 최대길이: {self._format_duration(self.max_duration)} | {mode}")
+        print('='*60)
+
+        # 검색
+        entries = self._search(query, max_videos * 3)
+        if not entries:
+            print("검색 결과 없음")
+            return 0
+
+        print(f"검색됨: {len(entries)}개")
+
+        # 길이 필터링
+        filtered = []
+        for entry in entries:
+            if not entry:
+                continue
+
+            vid = entry.get('id')
+            title = entry.get('title', '?')[:40]
+            dur = entry.get('duration') or self._get_duration(vid)
+
+            if dur and dur < self.max_duration:
+                filtered.append(entry)
+                print(f"  ✓ [{self._format_duration(dur)}] {title}")
+                if len(filtered) >= max_videos:
                     break
+            elif dur:
+                print(f"  ✗ [{self._format_duration(dur)}] {title}")
+
+            if not self.fast_mode:
+                time.sleep(0.3)
+
+        if not filtered:
+            print("조건 맞는 영상 없음")
+            return 0
+
+        print(f"\n다운로드: {len(filtered)}개" + (" (병렬)" if self.fast_mode else ""))
+        success = 0
+
+        if self.fast_mode and self.workers > 1:
+            # 병렬 다운로드
+            with ThreadPoolExecutor(max_workers=self.workers) as executor:
+                futures = {
+                    executor.submit(self._process_video, entry, category, cat_name): entry
+                    for entry in filtered
+                }
+
+                for i, future in enumerate(as_completed(futures)):
+                    entry = futures[future]
+                    title = entry.get('title', '?')[:45]
 
-    # --- 2단계: 목표 수량을 못 채웠을 경우 YouTube 검색Fallback ---
-    current_count = downloader.get_saved_video_count()
-    if current_count < limit:
-        remaining = limit - current_count
-        logger.info(f"\nTarget not reached ({current_count}/{limit}). Starting YouTube Search fallback for '{task_type}'...")
-        
-        # 검색어: 태스크 이름 (필요시 config에서 태스크별 검색어 별도 지정 가능)
-        search_results = downloader.search_youtube(task_type, max_results=remaining * 2)
-        
-        if not search_results:
-            logger.warning("No search results found.")
-            return results
-        
-        # 검색 결과는 타임스탬프 정보가 없으므로, 기본적으로 영상의 1:00 지점 혹은 0:00 지점을 시도
-        # 여기서는 영상의 대략 1분 지점(영상이 짧으면 0)을 타겟으로 시도해봄
-        search_items = []
-        for entry in search_results:
-            search_items.append({
-                'task_type': task_type,
-                'url': entry['url'],
-                'timestamp_min': 1,  # 1분 지점 샘플링 시도
-                'timestamp_sec': 0,
-                'description': f"Auto-searched: {entry['title']}"
-            })
-            
-        logger.info(f"Processing {len(search_items)} search results...")
-        
-        if parallel:
-            with ThreadPoolExecutor(max_workers=MAX_WORKERS) as executor:
-                futures = [executor.submit(process_item, item) for item in search_items]
-                from tqdm import tqdm
-                for future in tqdm(as_completed(futures), total=len(search_items), desc="Search Fallback"):
                     try:
-                        res = future.result()
-                        results.append(res)
-                        if res.get('status') == 'limit_reached' or downloader.get_saved_video_count() >= limit:
-                            executor.shutdown(wait=False, cancel_futures=True)
-                            break
-                    except Exception:
-                        continue
+                        result = future.result()
+                        print(f"\n[{i+1}/{len(filtered)}] {title}")
+
+                        if result['status'] == "ok":
+                            if result.get('detected'):
+                                print(f"  감지: {', '.join(result['detected'])}")
+                            if result['saved']:
+                                print(f"  ✅ 저장: {cat_name}/")
+                                success += 1
+                            elif result.get('undetected_saved'):
+                                print("  📁 미감지 보관")
+                            else:
+                                print("  ❌ 미감지 삭제")
+                        elif result['status'] == "skipped":
+                            print("  ⏭ 이미 있음")
+                        elif result['status'] == "unavailable":
+                            print("  ⏭ 사용불가")
+                        else:
+                            print("  ✗ 실패")
+                    except Exception as e:
+                        print(f"\n[{i+1}/{len(filtered)}] {title}")
+                        print(f"  ✗ 에러: {e}")
         else:
-            for item in search_items:
-                if downloader.get_saved_video_count() >= limit:
-                    break
-                res = process_item(item)
-                results.append(res)
-                if res.get('status') == 'limit_reached':
-                    break
-    
-    return results
+            # 순차 다운로드
+            for i, entry in enumerate(filtered):
+                vid = entry.get('id')
+                url = f"https://www.youtube.com/watch?v={vid}"
+                title = entry.get('title', '?')[:45]
+
+                print(f"\n[{i+1}/{len(filtered)}] {title}")
+
+                status, filepath, _ = self._download_one(url)
+                if not self.fast_mode:
+                    print()
+
+                if status == "ok" and filepath:
+                    print("  🔍 분석...")
+                    result = self.analyzer.analyze(filepath)
+
+                    detected = []
+                    if result['face']:
+                        detected.append(f"얼굴({result['face_count']})")
+                    if result['text']:
+                        detected.append("텍스트")
+                    if result['license_plate']:
+                        detected.append("번호판")
+                    if result['tattoo']:
+                        detected.append("타투")
+
+                    if detected:
+                        print(f"  감지: {', '.join(detected)}")
+
+                    if result.get(category):
+                        dest_dir = os.path.join(self.output_path, cat_name)
+                        os.makedirs(dest_dir, exist_ok=True)
+                        dest = os.path.join(dest_dir, os.path.basename(filepath))
+                        if not os.path.exists(dest):
+                            shutil.move(filepath, dest)
+                        print(f"  ✅ 저장: {cat_name}/")
+                        success += 1
+                    else:
+                        if category == 'license_plate':
+                            dest_dir = os.path.join(self.output_path, "번호판_미감지")
+                            os.makedirs(dest_dir, exist_ok=True)
+                            dest = os.path.join(dest_dir, os.path.basename(filepath))
+                            if not os.path.exists(dest):
+                                shutil.move(filepath, dest)
+                            print("  📁 미감지 보관")
+                        else:
+                            try:
+                                os.remove(filepath)
+                            except:
+                                pass
+                            print("  ❌ 미감지 삭제")
+
+                elif status == "skipped":
+                    print("  ⏭ 이미 있음")
+                elif status == "unavailable":
+                    print("  ⏭ 사용불가")
+                else:
+                    print("  ✗ 실패")
+
+                if not self.fast_mode:
+                    time.sleep(random.uniform(0.5, 1.5))
+
+        return success