Communitygithub.com

OpenClip 长视频转短视频

将一部完整的长视频一键转化为适用于 TikTok、Reels 和 YouTube Shorts 的批量短视频——自动寻找高光片段、转为竖屏、添加字幕并生成社交文案。

OpenClip 长视频转短视频 是什么?

OpenClip 长视频转短视频技能(openclip-repurpose)是一个端到端的工作流型 AI 技能,专为需要将长视频内容重新利用为平台就绪短视频的创作者和开发者设计。它支持 TikTok、Instagram Reels、YouTube Shorts、X 和 LinkedIn 等主流平台。通过 OpenClip 的远程 MCP 服务器(https://openclip.app/mcp),用户可以提交长视频,系统会自动分析并提取惊爆时刻,按互动评分排序,并在渲染前提供片段预览以便用户筛选。剪辑流水线为付费功能(需活跃订阅和积分),而竖屏转制和修剪工具免费可用。工作流包括:提交视频、轮询直到处理完成、获取亮点片段、根据评分选择最佳片段、生成字幕、根据平台调整画面比例,最后提供下载链接、标题、钩子和社交文案,方便直接发布。技能还支持创建和复用处理代理,以保持批量内容风格一致。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/OpenClip-App/agent-skills/tree/main/skills/openclip-repurpose

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

OpenClip:将长视频批量转为短视频内容

这是一个端到端工作流技能。输入一部完整的视频,输出一组可直接发布的竖屏片段,每条片段均包含字幕和文案。它整合了 OpenClip 剪辑流水线、字幕生成以及免费的媒体处理工具。

剪辑流水线是 付费 功能(需要活跃订阅和积分)。转制和修剪工具免费。

一次性设置

OpenClip 是一个远程 MCP 服务器,地址为 https://openclip.app/mcp。出现 OAuth 提示时,请使用你的 OpenClip 账户登录,无需复制 API 密钥。

  • Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp,然后执行 /mcp 授权。
  • Claude Desktop / Web 版: 设置 → 连接器 → “添加自定义连接器”,粘贴 URL 并登录。
  • Cursor(.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
  • 仅使用标头的客户端: 在 openclip.app/settings/connect 生成 MCP 令牌,然后连接至 https://openclip.app/mcp/key,并设置请求头 Authorization: Bearer <令牌>。

运行检查:调用 get_account 并确认 credits_remaining > 0。

工作流

开始前,先与用户确认两件事:需要多少个片段,以及针对哪些平台。这两个答案将决定后续所有决策。不要擅自替用户做决定。

  1. 提交视频源。 submit_video(url)。返回一个 job_id,状态为 queued。 如果是本地文件:先调用 create_upload,PUT 上传字节,再调用 complete_upload。
  2. 轮询直到完成。 反复调用 get_video_status(job_id) 直到状态变为 completed。如果很快返回 failed,则表示没有活跃订阅。如果返回 pending_credits,则表示积分不足。请直接告知用户并停止,不要继续轮询一个终态。
  3. 拉取亮点片段。 调用 list_clips(job_id)。按 virality_score(0 到 10)排序,取用户所需的数量。在渲染之前,向用户展示片段标题、钩子、时长和评分,以便用户否决。渲染会消耗积分。
  4. 为每个选中的片段添加字幕。 调用 list_caption_presets,然后为每个批准的片段调用 render_clip(moment_id, caption_preset)。持续轮询 list_clips,直到每个片段都有 rendered_clip 字段。
  5. 根据需要调整画面比例。 流水线的输出默认已是短视频格式。如果用户需要针对特定平台调整不同宽高比,请使用免费的 edit_video(video, operation="crop", aspect="9:16" | "1:1" | "4:5") 对渲染后的片段进行处理。
  6. 交付批量结果。 为每个片段提供:rendered_clip 链接、title、hook、social_copy、duration_ms、virality_score 以及建议的 platforms 字段。

平台适配比例

  • TikTok、Reels、Shorts - 9:16 竖屏。这是默认比例,流水线会以此为核心输出。
  • Instagram 信息流 - 4:5 或 1:1。使用 edit_video 对渲染后的片段进行裁剪。
  • X 和 LinkedIn - 16:9 或 1:1 均可。字幕比宽高比更重要,因为这些平台通常默认静音自动播放。

每个片段都包含一个来自流水线的 platforms 字段。将其视为初始建议而非硬性规则,并根据用户实际发布平台进行调整。

执行顺序与成本控制

  • 批量轮询。 只提交一次,然后循环调用 get_video_status 轮询,不要重复提交。
  • 只渲染用户批准的片段。 每次 render_clip 都会消耗资源,用户只要三个片段,就不要渲染全部十个。
  • 对于重复性工作流(相同的字幕、相同的构图、相同的 Logo 水印), 请使用 create_agent 保存一个处理代理,并在 submit_video 时传入该代理 ID。这样未来的每次批量处理都能保持一致,无需重新指定。describe_agent_settings 可列出所有字段。
  • 在开始大规模批量处理前, 调用 get_usage 查看积分余额(积分以分钟处理时长计)。当用户要求大量片段时,请先检查积分。

规则

  • 始终轮询,每个步骤都是异步的。
  • 按 virality_score 排序,分数越高越好。使用 viral_score_details 解释评分依据(钩子强度、可分享性、重看价值、惊喜感、情感冲击力)。
  • 时间单位为毫秒。
  • 剪辑链接是永久 CDN 链接,不签名,不过期。
  • 不支持项目和文件夹。 不要向用户承诺提供文件夹结构。
  • 除非用户要求,否则不要将 social_copy 改写为影响者风格。文案已根据片段内容生成,过度重写通常效果更差。

提示示例与对应操作

  • “把这个播客变成 10 个 TikTok 视频” - 提交、轮询、list_clips、展示前 10 个片段列表、获取批准、为每个片段添加字幕并渲染、轮询、交付结果。
  • “从这场网络研讨会里给我一周的素材” - 同上,数量控制在 5 到 7 个片段,使用每个片段的 category 按主题分组。
  • “只要最好的那个,用 MrBeast 风格的字幕” - 提交、轮询、取 virality_score 最高的片段、调用 render_clip(moment_id, caption_preset="beast")、轮询。
  • “和上次一样的风格” - 在 submit_video 中复用保存的代理 ID。

相关技能

关于流水线机制和状态处理的详细说明,请参见 openclip-clipping。字幕预设和自定义字幕样式,请参见 openclip-captions。免费的裁剪、修剪和压缩功能,请参见 openclip-video-editing。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

OpenClip-App/agent-skills

OpenClip captions: burn styled animated captions into short clips.

OpenClip-App/agent-skills

OpenClip clipping: long video → short vertical clips ranked by virality score.

OpenClip-App/agent-skills

OpenClip agent skill for clipping long-form into short-form social clips.

openclip-convert

Convert and compress media from your agent with OpenClip - video to mp4, webm, mov, mkv, or gif, and audio to mp3, aac, wav, or flac. FREE with just an OpenClip account, no subscription. Use when asked to

openclip-remove-background

Remove the background from an image with OpenClip and get back a transparent PNG. FREE with just an OpenClip account, no subscription. Use when asked to

openclip-thumbnails

Pull still frames out of a video as thumbnail images with OpenClip, then compress, resize, crop, or reformat them to jpg, png, or webp. FREE with just an OpenClip account, no subscription. Use when asked for

openclip-transcription

Transcribe video or audio to JSON, SRT, and VTT with speaker diarization and time codes, using OpenClip. FREE with just an OpenClip account, no subscription. Use when asked to

openclip-ugc-ads

Generate short vertical UGC-style ad clips from a structured creative brief with OpenClip, picking from a roster of AI creators. Use when asked to

openclip-video-editing

Edit a video file from your agent with OpenClip - trim, crop, reframe to 9:16 or 1:1, resize, rotate, flip, compress to a target size, or mute the audio. FREE with just an OpenClip account, no subscription. Use when asked to

相关技能