feat: v3.2 나머지 미완성 기능 구현

[Instagram Reels] Phase 2 완성
- instagram_bot.py: publish_reels() 추가 (MP4 → Reels API)
  - upload_video_container(), wait_for_video_ready() 구현
  - 로컬 경로 → 공개 URL 자동 변환 (image_host.get_public_video_url())
- scheduler.py: job_distribute_instagram_reels() 추가 (10:30)
- image_host.py: get_public_video_url() + 로컬 비디오 서버 추가
  - VIDEO_HOST_BASE_URL 환경변수 지원 (Tailscale/CDN)

[writer_bot.py] 신규 — 독립 실행형 글쓰기 봇
- api_content.py manual-write 엔드포인트에서 subprocess 호출 가능
- run_pending(): 오늘 날짜 미처리 글감 자동 처리
- run_from_topic(): 직접 주제 지정
- run_from_file(): JSON 파일 지정
- CLI: python bots/writer_bot.py [--topic "..." | --file path.json | --limit N]

[보조 시스템 신규] v3.1 CLI + Assist 모드
- blog.cmd: venv Python 경유 Windows 런처
- blog_runtime.py + runtime_guard.py: 실행 진입점 + venv 검증
- blog_engine_cli.py: 대시보드 API 기반 CLI (blog status, blog review 등)
- bots/assist_bot.py: URL 기반 수동 어시스트 파이프라인
- dashboard/backend/api_assist.py + frontend/Assist.jsx: 수동모드 탭

[engine_loader.py] v3.1 개선
- OpenClawWriter: --json 플래그 + payloads 파싱 + plain text 폴백
- ClaudeWebWriter: Playwright 쿠키 세션 (Cloudflare 차단으로 현재 비활성)
- GeminiWebWriter: gemini-webapi 비공식 클라이언트

[scheduler.py] v3.1 개선
- _call_openclaw(): 플레이스홀더 → EngineLoader 실제 호출
- _build_openclaw_prompt(): 구조화된 HTML 원고 프롬프트
- data/originals/: 원본 article JSON 저장 경로 추가

[설정/환경] 정비
- .env.example: SEEDANCE/ELEVENLABS/GEMINI/RUNWAY 복원
  + VIDEO_HOST_BASE_URL, GEMINI_WEB_* , REMOTE_CLAUDE_POLLING_ENABLED 추가
- scripts/setup.bat: data/originals, outputs, assist, novels, config/novels
  디렉토리 생성 + 폰트 다운로드 + blog.cmd 기반 Task Scheduler 등록
- requirements.txt: fastapi, uvicorn, python-multipart 추가

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

bots/distributors/image_host.py

@@ -215,6 +215,86 @@ def get_public_url(image_path: str) -> str:
     return ''
 
 
+# ─── 비디오 호스팅 (릴스용) ──────────────────────────
+
+_local_video_server = None
+
+
+def start_local_video_server(port: int = 8766) -> str:
+    """
+    로컬 HTTP 파일 서버 시작 — 비디오(MP4) 전용.
+    Returns: base URL (예: http://192.168.1.100:8766)
+    """
+    import socket
+    import threading
+    import http.server
+    import functools
+
+    global _local_video_server
+    if _local_video_server:
+        return _local_video_server
+
+    outputs_dir = str(BASE_DIR / 'data' / 'outputs')
+    handler = functools.partial(
+        http.server.SimpleHTTPRequestHandler, directory=outputs_dir
+    )
+    server = http.server.HTTPServer(('0.0.0.0', port), handler)
+    thread = threading.Thread(target=server.serve_forever, daemon=True)
+    thread.start()
+
+    try:
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(('8.8.8.8', 80))
+        local_ip = s.getsockname()[0]
+        s.close()
+    except Exception:
+        local_ip = '127.0.0.1'
+
+    base_url = f'http://{local_ip}:{port}'
+    _local_video_server = base_url
+    logger.info(f"로컬 비디오 서버 시작: {base_url}")
+    return base_url
+
+
+def get_public_video_url(video_path: str) -> str:
+    """
+    비디오 파일 → 공개 URL 반환 (Instagram Reels, TikTok 등).
+    Instagram Reels API는 공개 접근 가능한 MP4 URL이 필요.
+
+    우선순위:
+    1. LOCAL_IMAGE_SERVER=true → 로컬 HTTP 서버 (Tailscale 외부 접속 필요)
+    2. VIDEO_HOST_BASE_URL 환경변수 → 직접 지정한 CDN/서버 URL
+
+    운영 환경에서는 Tailscale로 미니PC를 외부에서 접근하거나,
+    Cloudflare Tunnel 등을 사용하세요.
+    """
+    if not Path(video_path).exists():
+        logger.error(f"비디오 파일 없음: {video_path}")
+        return ''
+
+    # 1. 직접 지정한 CDN/서버 베이스 URL
+    video_base = os.getenv('VIDEO_HOST_BASE_URL', '').rstrip('/')
+    if video_base:
+        filename = Path(video_path).name
+        url = f'{video_base}/{filename}'
+        logger.info(f"비디오 외부 URL: {url}")
+        return url
+
+    # 2. 로컬 HTTP 서버 (Tailscale/ngrok으로 외부 접근 가능한 경우)
+    if os.getenv('LOCAL_IMAGE_SERVER', '').lower() == 'true':
+        base_url = start_local_video_server()
+        filename = Path(video_path).name
+        url = f'{base_url}/{filename}'
+        logger.warning(f"로컬 비디오 서버 URL (외부 접근 필요): {url}")
+        return url
+
+    logger.warning(
+        "비디오 공개 URL 생성 불가. .env에 VIDEO_HOST_BASE_URL을 설정하거나 "
+        "LOCAL_IMAGE_SERVER=true (Tailscale/ngrok)로 설정하세요."
+    )
+    return ''
+
+
 if __name__ == '__main__':
     import sys
     if len(sys.argv) > 1:

bots/distributors/instagram_bot.py

@@ -142,6 +142,104 @@ def publish_container(container_id: str) -> str:
         return ''
 
 
+def upload_video_container(video_url: str, caption: str) -> str:
+    """
+    Instagram Reels 업로드 컨테이너 생성.
+    video_url: 공개 접근 가능한 MP4 URL
+    Returns: container_id
+    """
+    if not _check_credentials():
+        return ''
+
+    url = f"{GRAPH_API_BASE}/{INSTAGRAM_ACCOUNT_ID}/media"
+    params = {
+        'media_type': 'REELS',
+        'video_url': video_url,
+        'caption': caption,
+        'share_to_feed': 'true',
+        'access_token': INSTAGRAM_ACCESS_TOKEN,
+    }
+    try:
+        resp = requests.post(url, data=params, timeout=30)
+        resp.raise_for_status()
+        container_id = resp.json().get('id', '')
+        logger.info(f"Reels 컨테이너 생성: {container_id}")
+        return container_id
+    except Exception as e:
+        logger.error(f"Instagram Reels 컨테이너 생성 실패: {e}")
+        return ''
+
+
+def wait_for_video_ready(container_id: str, max_wait: int = 300) -> bool:
+    """
+    비디오 컨테이너 처리 완료 대기 (최대 max_wait초).
+    Reels는 인코딩 시간이 이미지보다 길다.
+    """
+    status_url = f"{GRAPH_API_BASE}/{container_id}"
+    for _ in range(max_wait // 10):
+        try:
+            resp = requests.get(
+                status_url,
+                params={'fields': 'status_code', 'access_token': INSTAGRAM_ACCESS_TOKEN},
+                timeout=10,
+            )
+            status = resp.json().get('status_code', '')
+            if status == 'FINISHED':
+                return True
+            if status in ('ERROR', 'EXPIRED'):
+                logger.error(f"Reels 컨테이너 오류: {status}")
+                return False
+            logger.debug(f"Reels 인코딩 중: {status}")
+        except Exception as e:
+            logger.warning(f"Reels 상태 확인 오류: {e}")
+        time.sleep(10)
+    logger.warning("Reels 컨테이너 준비 시간 초과")
+    return False
+
+
+def publish_reels(article: dict, video_path_or_url: str) -> bool:
+    """
+    쇼츠 MP4를 Instagram Reels로 게시.
+    video_path_or_url: 로컬 MP4 파일 경로 또는 공개 MP4 URL
+      - 로컬 경로인 경우 image_host.get_public_video_url()로 공개 URL 변환
+      - http/https URL인 경우 그대로 사용
+    """
+    if not _check_credentials():
+        logger.info("Instagram 미설정 — Reels 발행 건너뜀")
+        return False
+
+    logger.info(f"Instagram Reels 발행 시작: {article.get('title', '')}")
+
+    # 로컬 경로 → 공개 URL 변환
+    video_url = video_path_or_url
+    if not video_path_or_url.startswith('http'):
+        import sys
+        sys.path.insert(0, str(Path(__file__).parent))
+        from image_host import get_public_video_url
+        video_url = get_public_video_url(video_path_or_url)
+        if not video_url:
+            logger.error(
+                "Reels 공개 URL 변환 실패 — .env에 VIDEO_HOST_BASE_URL 또는 "
+                "LOCAL_IMAGE_SERVER=true (Tailscale) 설정 필요"
+            )
+            return False
+
+    caption = build_caption(article)
+    container_id = upload_video_container(video_url, caption)
+    if not container_id:
+        return False
+
+    if not wait_for_video_ready(container_id):
+        return False
+
+    post_id = publish_container(container_id)
+    if not post_id:
+        return False
+
+    _log_published(article, post_id, 'instagram_reels')
+    return True
+
+
 def publish_card(article: dict, image_path_or_url: str) -> bool:
     """
     카드 이미지를 인스타그램 피드에 게시.