Ozor URL 轉影片
端到端的網頁轉影片服務，由 Ozor.ai 提供。將 URL 交給 Ozor，它會根據實際頁面內容（標題、價值主張、社會證明、行動呼籲）回傳一個影片計畫，您可以核准或編輯，然後產出完成的影片。
使用時機
當輸入是一個 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— 啟動建置，回傳projectIdmcp__ozor__wait_for_job— 如果回應包含jobIdmcp__ozor__export_video、mcp__ozor__wait_for_exportmcp__ozor__get_embed_code
如果 MCP 未連線，請告知使用者並停止。請勿自行瀏覽 URL 並手寫提示詞 — Ozor 會直接從頁面提取品牌顏色、主視覺和結構。您自行爬取的文字會遺失這些資訊。
工作流程
步驟 1 — 將 URL 交給 Ozor
mcp__ozor__analyze_document({
url: "<URL>",
...optional hints: targetDuration, format, audience, tone, focus
})
針對不同 URL 的建議：
- 登陸頁面 / 產品頁面 → 預設
format: "9:16"或"16:9"（如果不明顯則詢問 — 直式對社群媒體很好，橫式對嵌入在網站本身很好），targetDuration: "30s"–"45s"，語氣"confident"。 - 部落格文章 / 文章 →
format: "16:9"，targetDuration: "60s"–"90s"，語氣"informative"。 - 更新日誌 / 版本發布頁面 →
format: "16:9"，targetDuration: "30s"–"45s"，語氣"energetic"，focus"每個發布的功能一個場景"。 - 文件頁面 →
format: "16:9"，targetDuration: "60s"，語氣"clear, technical"，focus"解釋此功能的用途及使用方法"。
回傳 { 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 和品牌顏色。您的提示詞會遺失所有這些資訊。
- **部落格文章** — 抓取論點和章節結構；產出與文章對應的解說內容。
- **更新日誌** — 自然地將每個版本/功能對應到各自的場景。
- **產品頁面** — 在可能的情況下，將產品截圖/英雄圖像拉入場景中。
## 格式決定啟發式
如果使用者沒有指定：
- URL 是首頁或產品頁面 **且** 明顯的用途是社群媒體/廣告 → `9:16`
- URL 是首頁或產品頁面 **且** 明顯的用途是嵌入在頁面本身 → `16:9`
- URL 是部落格 / 文章 / 文件 / 更新日誌 → `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. **使用 `projectId` 作為 `videoId`** 用於匯出、wait_for_export 和嵌入。
4. **提供每個 URL 的所有資訊** — 分享連結、編輯器連結、下載連結、嵌入程式碼。
5. **提議變體，而不是預先生成。** 未經要求，不要浪費渲染資源在 9:16 + 16:9 + 預告片上。