Fix: [2.0.3] yt-dlp 쿠키 인증 추가, 문서 업데이트, CI/CD .md 스킵

- yt-dlp에 쿠키 파일(/app/cookies.txt) 지원 추가 (YouTube 봇 감지 우회)
- CI/CD에 paths-ignore: **/*.md 추가하여 문서 수정 시 빌드 스킵
- 전체 문서 업데이트: 라우트 변경, 쿠키 인증 방식, n8n Expression 모드 안내
- .gitignore에 cookies.txt 추가

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

docs/development.md

@@ -10,7 +10,7 @@ news-summary-bot/
 │   ├── __init__.py
 │   ├── main.py          # FastAPI 엔드포인트 (/summarize, /health)
 │   ├── config.py        # pydantic-settings 환경변수
-│   ├── transcript.py    # youtube-transcript-api로 자막 추출
+│   ├── transcript.py    # yt-dlp + 쿠키로 자막 추출
 │   ├── summarizer.py    # Claude Sonnet 4.6 요약
 │   └── discord.py       # Discord 웹훅 전송
 ├── Dockerfile
@@ -79,7 +79,9 @@ curl -X POST http://localhost:8000/summarize \
 
 ### transcript.py
 
-YouTube URL에서 video ID를 추출하고 `youtube-transcript-api`를 사용하여 자막을 가져옵니다. 한국어(`ko`) 자막을 우선으로 시도하며, 없을 경우 영어 등 다른 언어 자막을 fallback으로 사용합니다.
+YouTube URL에서 video ID를 추출하고 `yt-dlp`를 사용하여 자막을 가져옵니다. 한국어(`ko`) 자막을 우선으로 시도하며, 없을 경우 영어(`en`) 자막을 fallback으로 사용합니다.
+
+서버 환경에서는 YouTube 봇 감지를 우회하기 위해 `/app/cookies.txt` 쿠키 파일을 사용합니다. 로컬 개발 시에는 가정용 IP라 쿠키 없이도 동작합니다.
 
 ### summarizer.py
 

docs/n8n-setup.md

@@ -48,12 +48,14 @@ FastAPI 서버의 `/api/news/summarize` 엔드포인트를 호출합니다.
 | 설정 항목 | 값 |
 |---|---|
 | Method | `POST` |
-| URL | `http://<서버IP>/api/news/summarize` |
+| URL | `https://nkeystudy.site/api/news/summarize` |
 | Body Content Type | JSON |
 | Body | 아래 참조 |
 
-**Body (JSON):**
+**Body 설정:**
 
+- **Specify Body:** `Using JSON` (Expression 모드)
+- **JSON:**
 ```json
 {
   "video_url": "{{ $json.link }}",
@@ -61,6 +63,8 @@ FastAPI 서버의 `/api/news/summarize` 엔드포인트를 호출합니다.
 }
 ```
 
+> **주의:** 영상 제목에 큰따옴표(`"`)가 포함된 경우 JSON이 깨질 수 있습니다. 반드시 **Expression 모드**를 사용하세요 (Fixed 모드에서는 특수문자 이스케이프가 안 됩니다).
+
 **Headers:**
 
 | 헤더 | 값 |

docs/operations.md

@@ -61,7 +61,8 @@ docker compose logs -f news-summary-bot
 
 | 증상 | 원인 | 해결 |
 |------|------|------|
-| 자막 추출 실패 | 영상에 자막 없음 | 자동생성 자막이 없는 영상은 스킵됨 |
+| 자막 추출 실패 (자막 없음) | 영상에 자막 없음 | 자동생성 자막이 없는 영상은 스킵됨 |
+| 자막 추출 실패 (봇 감지) | YouTube 쿠키 만료 | 브라우저에서 쿠키 재export 후 서버에 업로드 (아래 쿠키 갱신 참고) |
 | Discord 전송 실패 | 웹훅 URL 만료 | Discord에서 웹훅 재생성 후 `.env` 업데이트 |
 | 401 Unauthorized | API_SECRET 불일치 | n8n 헤더와 `.env` 값 확인 |
 | Claude API 오류 | API 키 만료 또는 잔액 부족 | Anthropic 콘솔에서 확인 |
@@ -69,6 +70,28 @@ docker compose logs -f news-summary-bot
 
 ---
 
+## 쿠키 갱신
+
+YouTube는 클라우드 서버 IP를 봇으로 감지하여 자막 추출을 차단합니다. 이를 우회하기 위해 브라우저 쿠키를 사용하며, 약 6개월~1년 주기로 만료됩니다.
+
+**만료 증상:** 자막 추출 시 500 에러 + 로그에 `Sign in to confirm you're not a bot` 메시지
+
+**갱신 절차:**
+
+1. Chrome 확장 **Get cookies.txt LOCALLY**로 YouTube 쿠키 export
+2. 서버에 업로드:
+   ```bash
+   scp cookies.txt ubuntu@nkeystudy.site:~/nkeysworld/news-summary-bot/cookies.txt
+   ```
+3. 컨테이너 재시작:
+   ```bash
+   docker compose -p nkeys-apps -f /nkeysworld/compose.apps.yml restart news-summary-bot
+   ```
+
+> `compose.apps.yml`에서 `./news-summary-bot/cookies.txt:/app/cookies.txt:ro`로 마운트되어 있어야 합니다.
+
+---
+
 ## 모니터링 포인트
 
 - `/health` 엔드포인트로 컨테이너 상태 확인