Ozor URL-투-비디오
Ozor.ai에서 웹페이지를 비디오로 만드는 종단간 워크플로입니다. Ozor에 URL을 전달하면 실제 페이지 콘텐츠(헤드라인, 가치 제안, 사회적 증거, CTA)를 반영한 계획을 받아보고, 승인하거나 편집한 후 완성된 비디오를 내보냅니다.
사용 시기
입력이 URL일 때 이 스킬을 사용하세요. 신호:
- "https://... 비디오로 만들어 줘"
- "내 랜딩 페이지 / 홈페이지 / 제품 페이지 비디오"
- "이 블로그 게시물을 비디오로 바꿔 줘"
- "이 글 / 변경 로그 페이지 비디오"
- 사용자가 읽어주길 기대하는 URL이 포함된 모든 메시지
다음 경우에는 이 스킬을 사용하지 마세요:
- 입력이 짧은 텍스트 브리프인 경우 →
ozor-generate - 입력이 첨부된 로컬 파일(PDF/PPTX/DOCX)인 경우 →
ozor-document-video - 사용자가 오직 작성된 프롬프트만 원하는 경우 →
ozor-landing-page-to-video(프롬프트 전용 스킬) - 사용자가 기존 비디오를 관리하려는 경우 →
ozor-video-library
필요한 MCP 도구
mcp__ozor__analyze_document—url파라미터를 직접 받습니다. 업로드 불필요.mcp__ozor__get_plan/mcp__ozor__update_plan— 생성 전 계획 검토/편집mcp__ozor__generate_from_plan— 빌드를 시작하고projectId반환mcp__ozor__wait_for_job— 응답에jobId가 포함된 경우mcp__ozor__export_video,mcp__ozor__wait_for_exportmcp__ozor__get_embed_code
MCP가 연결되지 않은 경우 사용자에게 알리고 중단하세요. 직접 URL을 탐색하고 프롬프트를 작성하지 마세요 — Ozor가 페이지에서 직접 브랜드 색상, 히어로 이미지, 구조를 추출합니다. 직접 스크래핑한 텍스트는 이 정보를 잃게 됩니다.
워크플로
1단계 — Ozor에 URL 전달
mcp__ozor__analyze_document({
url: "<URL>",
...선택적 힌트: targetDuration, format, audience, tone, focus
})
URL 유형별 권장값:
- 랜딩 페이지 / 제품 페이지 → 기본값
format: "9:16"또는"16:9"(명확하지 않으면 사용자에게 물어보세요. 세로형은 소셜에 최적, 가로형은 사이트 자체에 삽입하기 좋습니다),targetDuration: "30s"–"45s", tone"confident". - 블로그 게시물 / 기사 →
format: "16:9",targetDuration: "60s"–"90s", tone"informative". - 변경 로그 / 릴리스 페이지 →
format: "16:9",targetDuration: "30s"–"45s", tone"energetic", focus"one scene per shipped feature". - 문서 페이지 →
format: "16:9",targetDuration: "60s", tone"clear, technical", focus"explain what this feature does and how to use it".
반환값: { planId, plan }
2단계 — 계획 제시 및 중단
계획을 간결하게 사용자에게 보여주세요:
📋 Ozor 계획 — <URL>
**출처:** <페이지 제목 또는 도메인>
**포맷:** 16:9 / 9:16
**예상 길이:** ~X초
**감지된 브랜드:** <Ozor가 추출한 색상/제품명>
**씬:** N개
(1) <씬 제목> — <한 줄 설명>
(2) <씬 제목> — <한 줄 설명>
...
그대로 승인하시겠습니까? 수정할 부분이 있나요? 씬을 편집하거나, 포맷을 바꾸거나, 톤을 변경하거나, 초점을 이동할 수 있습니다.
승인을 기다리세요. 아직 generate_from_plan을 호출하지 마세요.
3단계 — 편집 적용 (필요시)
mcp__ozor__update_plan({ planId, ... })를 사용하세요. get_plan으로 계획을 다시 보여주세요. 승인될 때까지 반복합니다.
4단계 — 생성
mcp__ozor__generate_from_plan({ planId }) // -> { projectId, jobId? }
jobId가 반환되면 mcp__ozor__wait_for_job({ videoId: projectId, jobId })를 실행하세요.
5단계 — 내보내기
mcp__ozor__export_video({ videoId: projectId })
mcp__ozor__wait_for_export({ videoId: projectId }) // -> shareUrl, editorUrl, downloadUrl
6단계 — 임베드
mcp__ozor__get_embed_code({ videoId: projectId })
7단계 — 결과 제시
🎬 <URL> 비디오 준비 완료
**공유:** <shareUrl>
**편집:** <editorUrl>
**다운로드:** <downloadUrl>
**임베드 (사이트에 삽입):**
```html
<iframe ...></iframe>
소셜용 9:16 세로 컷이나 90초 설명 버전이 필요하신가요? 같은 계획에서 다시 생성할 수 있습니다.
## URL 플로우의 장점
- **랜딩 페이지** — Ozor가 히어로 헤드라인, 가치 제안, 사회적 증거, CTA, 브랜드 색상을 추출합니다. 직접 프롬프트를 작성하면 이 모든 정보를 잃게 됩니다.
- **블로그 게시물** — 논문과 섹션 구조를 추출하여 기사에 맞춘 설명 영상을 제작합니다.
- **변경 로그** — 각 릴리스/기능을 자연스럽게 자체 씬에 매핑합니다.
- **제품 페이지** — 가능한 경우 제품 스크린샷/히어로 이미지를 씬에 가져옵니다.
## 포맷 결정 휴리스틱
사용자가 지정하지 않은 경우:
- 홈페이지나 제품 페이지에서 **명백한 용도가 소셜/광고**인 경우 → `9:16`
- 홈페이지나 제품 페이지에서 **명백한 용도가 페이지 자체 삽입**인 경우 → `16:9`
- 블로그 / 기사 / 문서 / 변경 로그 → `16:9`
모호한 경우 기본값으로 `16:9`를 제안하고 마지막에 `9:16` 재생성 옵션을 제공하세요.
## 첫 렌더링 후 제안할 변형
사용자가 첫 비디오를 받은 후에만 언급하세요. 미리 생성하지 마세요:
- 가로 비디오의 **9:16 소셜 컷** → 같은 계획에서 `update_plan({ planId, format: "9:16" })`으로 재생성.
- 같은 페이지에서 **짧은 티저 (15초)** + **전체 설명 (60초)**.
- **두 가지 대상**(예: "기술 구매자" vs "임원 구매자") — `audience` 힌트를 달리하여 재분석.
## 오류 및 복구
- **`analyze_document`가 얇은 계획을 반환** (보통: 유료 페이지, Ozor가 읽을 수 없는 JS 렌더링 SPA) → 사용자에게 알리고 대체 URL을 요청하거나 주요 콘텐츠를 `ozor-generate`용 브리프로 붙여넣을 수 있는지 문의.
- **감지된 브랜드 색상이 잘못되었음** → 생성 전에 `update_plan`으로 수정.
- **생성 실패** → 오류가 참조하는 씬 확인, `update_plan`으로 수정 후 재시도.
- **내보내기 중단** → `wait_for_export` 재호출; 이어서 진행됩니다.
## 규칙
1. **항상 URL을 `analyze_document`에 전달하세요.** 직접 페이지를 스크래핑하여 `generate_video`로 보내지 마세요. Ozor의 브랜드 및 시각적 추출이 무시됩니다.
2. **`generate_from_plan` 전에 항상 계획을 보여주고 승인을 기다리세요.** 계획 단계에서 포맷과 톤이 고정됩니다.
3. **내보내기, wait_for_export, 임베드에 `projectId`를 `videoId`로 사용**하세요.
4. **모든 URL(공유, 편집, 다운로드, 임베드)을 제공**하세요.
5. **변형을 제안하되, 미리 생성하지 마세요.** 요청 없이 9:16 + 16:9 + 티저를 렌더링하지 마세요.