feat: v3 멀티플랫폼 자동화 엔진 — 변환/배포 엔진 + 쇼츠 + README

## 변환 엔진 (bots/converters/)
- blog_converter: HTML 자동감지 + Schema.org JSON-LD + AdSense 플레이스홀더
- card_converter: Pillow 1080×1080 인스타그램 카드 이미지
- thread_converter: X 스레드 280자 자동 분할
- newsletter_converter: 주간 HTML 뉴스레터
- shorts_converter: TTS + ffmpeg 뉴스앵커 쇼츠 영상 (1080×1920)

## 배포 엔진 (bots/distributors/)
- image_host: ImgBB 업로드 / 로컬 HTTP 서버
- instagram_bot: Instagram Graph API (컨테이너 → 폴링 → 발행)
- x_bot: X API v2 OAuth1 스레드 게시
- tiktok_bot: TikTok Content Posting API v2 청크 업로드
- youtube_bot: YouTube Data API v3 재개가능 업로드

## 기타
- article_parser: KEY_POINTS 파싱 추가 (SNS/TTS용 핵심 3줄)
- publisher_bot: HTML 본문 직접 발행 지원
- scheduler: 시차 배포 스케줄 + Telegram 변환/배포 명령 추가
- remote_claude: Claude Agent SDK Telegram 연동
- templates/shorts_template.json: 코너별 색상/TTS/트랜지션 설정
- scripts/download_fonts.py: NotoSansKR / 맑은고딕 자동 설치
- .gitignore: .claude/, 기획문서, 생성 미디어 파일 추가
- .env.example: 플레이스홀더 텍스트 (실제 값 없음)
- README: v3 아키텍처 전체 문서화 (설치/API키/상세설명/FAQ)
- requirements.txt: openai, pydub 추가

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

.env.example

@@ -1,17 +1,77 @@
-GOOGLE_CLIENT_ID=your-google-client-id.apps.googleusercontent.com
-GOOGLE_CLIENT_SECRET=your-google-client-secret
+# ─── Google OAuth (필수) ─────────────────────────────
+# Google Cloud Console > 사용자 인증 정보 > OAuth 클라이언트 ID에서 발급
+# https://console.cloud.google.com/
+GOOGLE_CLIENT_ID=your_google_oauth_client_id.apps.googleusercontent.com
+GOOGLE_CLIENT_SECRET=your_google_oauth_client_secret
+# scripts/get_token.py 실행 후 자동 저장됨
 GOOGLE_REFRESH_TOKEN=
-BLOG_MAIN_ID=your-blogger-blog-id
+# Blogger 대시보드 URL에서 확인 (숫자 18자리)
+BLOG_MAIN_ID=your_blogger_blog_id
+
+# ─── 쿠팡 파트너스 (선택) ─────────────────────────────
+# https://partners.coupang.com/ 에서 발급
 COUPANG_ACCESS_KEY=
 COUPANG_SECRET_KEY=
-TELEGRAM_BOT_TOKEN=your-telegram-bot-token
-TELEGRAM_CHAT_ID=your-telegram-chat-id
-# 이미지 모드 선택 (manual | request | auto)
+
+# ─── Telegram (필수) ──────────────────────────────────
+# @BotFather에서 /newbot 명령으로 생성
+TELEGRAM_BOT_TOKEN=your_telegram_bot_token
+# @userinfobot에서 확인
+TELEGRAM_CHAT_ID=your_telegram_chat_id
+
+# ─── 이미지 모드 선택 ─────────────────────────────────
 #   manual  — 글 발행 시점에 프롬프트 1개를 Telegram으로 전송 (기본값)
 #   request — 매주 월요일 프롬프트 목록 전송 → 직접 생성 후 Telegram으로 이미지 전송
 #   auto    — OpenAI DALL-E API 자동 생성 (OPENAI_API_KEY 필요, 별도 비용 발생)
 IMAGE_MODE=manual
-# auto 모드 사용 시에만 입력
+
+# OpenAI (auto 모드 또는 쇼츠 배경 이미지 자동 생성 시 필요)
+# https://platform.openai.com/api-keys
 OPENAI_API_KEY=
+
 # 블로그 사이트 URL (Search Console 등록용)
 BLOG_SITE_URL=
+
+# ─── v3: 멀티플랫폼 배포 ──────────────────────────────
+
+# [Instagram Graph API] Phase 1B
+# Facebook Developer App에서 발급 (비즈니스 계정 필요)
+# https://developers.facebook.com/
+INSTAGRAM_ACCESS_TOKEN=
+INSTAGRAM_ACCOUNT_ID=
+
+# [X(Twitter) API v2] Phase 1B
+# X Developer Portal에서 발급 (Free Tier 이상)
+# https://developer.twitter.com/
+X_API_KEY=
+X_API_SECRET=
+X_ACCESS_TOKEN=
+X_ACCESS_SECRET=
+
+# [Anthropic API] Telegram 자연어 명령용 (선택)
+# https://console.anthropic.com/
+ANTHROPIC_API_KEY=
+
+# ─── v3: 이미지 호스팅 ────────────────────────────────
+# ImgBB (무료, https://api.imgbb.com/ 에서 키 발급)
+# 인스타그램 카드 이미지를 공개 URL로 변환하는 데 사용
+IMGBB_API_KEY=
+# 로컬 테스트용 HTTP 서버 (true/false)
+LOCAL_IMAGE_SERVER=false
+
+# ─── v3 Phase 2: 쇼츠 변환 ───────────────────────────
+# Google Cloud TTS REST API (https://cloud.google.com/text-to-speech)
+# 없으면 gTTS(무료)로 자동 대체됨
+GOOGLE_TTS_API_KEY=
+# ffmpeg 경로 (PATH에 등록되지 않은 경우)
+# FFMPEG_PATH=C:/ffmpeg/bin/ffmpeg.exe
+
+# ─── v3 Phase 2: TikTok ───────────────────────────────
+# TikTok Developers (https://developers.tiktok.com/)
+TIKTOK_ACCESS_TOKEN=
+TIKTOK_OPEN_ID=
+
+# ─── v3 Phase 2: YouTube ──────────────────────────────
+# YouTube Data API v3 (기존 Google Cloud 프로젝트에서 API 추가 활성화)
+# YouTube Studio > 채널 > 고급 설정에서 채널 ID 확인
+YOUTUBE_CHANNEL_ID=