---
name: motion-cardnews-ko
description: |
  HTML 슬라이드를 SNS용 모션 카드뉴스 MP4 동영상으로 변환합니다.
  트리거 키워드: 모션 카드뉴스, 동영상 카드뉴스, SNS 동영상, HTML to video, 카드뉴스 MP4
version: "1.0.0"
phase: IDS Phase 5
---

# motion-cardnews-ko

IDS Phase 5 — HTML→MP4 모션 카드뉴스 생성 스킬.

## 기능

HTML 슬라이드(또는 PIL 솔리드 프레임)를 ffmpeg로 SNS 최적화 MP4 동영상으로 렌더링합니다.

## 지원 모션 효과 (5가지)

| 효과 | 설명 |
|------|------|
| `fade` | 페이드 인/아웃 전환 |
| `slide` | 슬라이드 전환 |
| `zoom` | Ken Burns 줌 효과 |
| `dissolve` | 크로스 디졸브 전환 |
| `sequence` | 순차 concat (concat demuxer) |

## 지원 SNS 규격 (3가지)

| 플랫폼 | 해상도 | 비율 |
|--------|--------|------|
| `instagram_reels` | 1080×1920 | 9:16 |
| `twitter` | 1920×1080 | 16:9 |
| `threads` | 1080×1080 | 1:1 |

기본값: `threads` (1:1)

## BGM (선택)

BGM은 선택 사항입니다. 허용 라이선스:
- CC0
- YouTube Audio Library Free
- Public Domain

## 사용 예시

```python
from skills.motion_cardnews_ko import render_motion, SIZES

output = render_motion(
    frame_paths=[Path("frame1.png"), Path("frame2.png")],
    output_path=Path("output.mp4"),
    size=SIZES["instagram_reels"],
    effect="fade",
    fps=30,
    duration_per_frame=1.5,
    bgm_path=None,
)
```