ClipUGC

ClipUGC CLI

ClipUGC 利用 AI 网红为移动应用制作 UGC 视频，这位网红在每个视频中都保持相同的面容，成品 9:16 视频中还会包含你应用的屏幕录制。 本仓库是其官方 CLI、本地 MCP 服务和 Claude Code 插件。创建 AI 网红，生成同一人物的逼真形象，将其制作成无声反应片段，并把应用录屏放入可直接发布的 UGC 视频中。所有内容都不会在本地渲染。

三种接入方式：

托管服务也是最快的免费入门方式：提供 App Store 或 Google Play 链接，其 first_videos 工具就会免费制作三段成品视频。

npm install -g clipugc
clipugc auth login

需要 Node.js >= 20。在 ClipUGC 控制面板（API 密钥部分）创建 API 密钥。API 密钥适用于付费方案（Professional 和 Business）。托管 MCP 服务无需密钥。

在 Claude Code 中使用

最快的入门方式：本仓库附带三个 Claude Code 技能，你只需描述需求，无需学习各种标志。clipugc 通过对话方式驱动 CLI，ugc-director 将应用创意转化为完整的 UGC 视频方案，persona-account 则用于运营持续更新的 AI 创作者账号。

/plugin marketplace add clipugc/ClipUGC-CLI
/plugin install clipugc@ClipUGC-CLI

作为插件安装后，这些技能会使用插件命名空间：

/clipugc:ugc-director make a TikTok video for my habit tracker app
/clipugc:persona-account create an AI influencer for a fitness account
/clipugc:clipugc how many credits do I have left

（如果选择克隆仓库，Claude Code 会直接读取 .claude/skills/，技能名称不带前缀：/ugc-director、/persona-account、/clipugc。）

各技能的功能请参阅 docs/skills.md。

更喜欢使用标志？以下所有内容都可独立运行，技能只是用相同的 CLI 来驱动操作。

托管 MCP 服务：Claude.ai、ChatGPT、Claude Code、Cursor、VS Code、Gemini CLI

这些客户端使用 https://clipugc.com/mcp 上的 ClipUGC 托管服务（39 个工具，使用 OAuth 2.1 登录，所有方案均可使用，包括免费方案）。无需在你的设备上运行任何程序，也无需复制 API 密钥：首次调用时会打开浏览器，让你登录 ClipUGC 账号。

Claude Code

claude mcp add --transport http clipugc https://clipugc.com/mcp

Claude.ai：设置 > 连接器 > 添加自定义连接器。将名称设为 ClipUGC，粘贴 https://clipugc.com/mcp，并在 Claude 提示时登录。

ChatGPT：设置 > 应用（旧版本中为连接器）> 高级 > 开启开发者模式 > 创建。将名称设为 ClipUGC，URL 填写同一个地址，身份验证选择 OAuth。开发者模式适用于 Plus 和 Pro，目前尚未在欧洲经济区、瑞士或英国推出。分步指南。

Gemini CLI

gemini extensions install https://github.com/clipugc/ClipUGC-CLI

这会添加托管服务、简要指南（GEMINI.md）和技能。

Cursor

ClipUGC 插件在 Cursor Marketplace 上架后，可在那里安装，以获取服务和技能。在此之前，请在“设置”>“MCP”或 .cursor/mcp.json 中手动添加服务：

{
  "mcpServers": {
    "clipugc": {
      "url": "https://clipugc.com/mcp"
    }
  }
}

VS Code（GitHub Copilot Agent 模式）

code --add-mcp '{"name":"clipugc","type":"http","url":"https://clipugc.com/mcp"}'

或者，等它出现在扩展视图中后，搜索 @mcp clipugc。

本地 MCP 服务（API 密钥）：Claude Code、Cursor、Claude Desktop

已收录于 MCP Registry 和 Smithery。

CLI 也是一个包含 12 个工具的本地 MCP 服务，适合不想登录托管服务，而希望使用 API 密钥在自己机器上运行的情况。clipugc mcp 通过标准输入输出（stdio）使用 Model Context Protocol，因此任何 MCP 客户端都能通过工具创建角色、造型、片段和成片，无需调用上面的命令。

先登录一次，让服务获取密钥（它会读取 CLI 使用的同一个 ~/.config/clipugc/config.json）：

npm install -g clipugc
clipugc auth login

Claude Code

claude mcp add clipugc -- npx -y clipugc@latest mcp

@latest 很重要：如果不加它，npx 会重复使用机器上已安装的任何 clipugc；而 1.2.0 之前的全局安装没有 mcp 命令，因此 Claude Code 会报告 "Connection closed"。如果仍看到此提示，请使用 npm i -g clipugc@latest 更新旧安装，或在终端中运行一次 npx -y clipugc@latest mcp，等待下载完成（看到 "12 tools ready" 后按 Ctrl+C）。请勿在此仓库的检出目录中添加它：此时 npx 会将 clipugc 解析为本地项目，而不是 npm 包。

Cursor（Settings > MCP，或项目中的 .cursor/mcp.json）

{
  "mcpServers": {
    "clipugc": {
      "command": "npx",
      "args": ["-y", "clipugc@latest", "mcp"]
    }
  }
}

如果不想在那台机器上运行 clipugc auth login，请添加一个 env 块，并将 CLIPUGC_API_KEY 设为从控制面板获取的密钥。

Claude Desktop

Claude Desktop 会将服务作为扩展安装，因此无需编辑配置文件，也无需在应用本身之外安装 Node：

1. 从最新的 GitHub 发布版本下载 clipugc.mcpb。
2. 双击该文件，或打开 Claude Desktop，前往 Settings > Extensions，然后选择 Install Extension（某些版本中位于高级设置）。
3. 按提示粘贴你的 ClipUGC API 密钥。可在 控制面板 的 API Keys 下创建密钥。

该扩展运行的 MCP 服务与上文的 clipugc mcp 相同。若要自行构建此安装包，请运行 npm run build:mcpb（参见“本地开发”）。

提示词：make_ugc_video、new_ai_influencer、hook_ideas（适用于常见任务的即用型开场）。资源：clipugc://pipeline（调用顺序）和 clipugc://pricing（已记录的积分费用；get_credits 提供实时表格）。

工具：list_characters、create_character、generate_image、list_images、 create_clip、create_motion_clip、create_scene_replace_clip、merge_ad、get_video、 download_video、get_credits、list_hooks。参数遵循 CLI 标志（--per-page 对应 per_page）。生成工具会立即返回任务 ID，与未指定 --wait 的 CLI 一样；请使用 get_video（片段和成片）或 list_images（造型）轮询，直到状态为 completed。每个工具都会在其说明中注明积分费用，而 get_credits 会返回实时价格。

生成效果

一个角色，一次定型。下面每张图都是同一个人，只是场景、服装和光线不同，因为每种造型都是根据角色的基础图像生成的，而不是再次根据描述生成：

clipugc characters create --wait \
  --description "Very pretty Danish woman aged 22, light blonde fine hair to her shoulders with a middle parting, pale blue upturned eyes, heart-shaped face, porcelain cool-toned skin. Genuinely attractive Instagram-creator look, but reads as a real girl, natural skin texture with visible pores, not airbrushed." \
  --scene "close selfie in a softly lit bedroom at golden hour, warm low sun through the window behind her giving a rim light on her hair, full glam makeup with smoky bronze eyeshadow and glossy nude lips, phone-camera quality with mild grain, slightly off-centre framing"

# every look after that: same face, new setting, never re-describe the person
clipugc images generate --character <id> --wait \
  --scene "bathroom mirror selfie in the evening, phone visible in her hand, warm vanity lights either side of the mirror, polished makeup with glowing skin and glossy lips, phone-camera quality with grain, slightly off-centre framing"

接着，任何一种造型都可以变成一段无声反应短片。全程闭嘴；静态图像的口型同步会暴露视频是 AI 生成的，所以这种形式不是说话，而是保持表情并配上文字钩子：

clipugc videos create --image <lookId> --duration 5 --wait \
  --prompt "She glances down at the phone, back up to the lens, and one corner of her mouth pulls into a smirk she is clearly trying to suppress. Her lips stay closed and together for the entire clip. She does not speak, does not mouth any words, and her mouth never opens. Natural handheld movement, she shifts slightly, hair moves. Ordinary phone-camera footage, visible grain."

注意提示词的结构：按节拍推进情节（低头看 → 再抬头 → 露出忍笑的表情），明确说明不说话，并加入环境动态。要求呈现某个状态而不是变化过程，例如“她露出忍笑的表情”，就会导致面部变形。完整的提示词库涵盖 9 种情绪类别、约 30 种反应，收录在 ugc-director 技能中。

把屏幕录制和钩子加到短片中无需额外付费，所以最后一步不花钱，你可以随意测试各种钩子。

工作原理

除第一种造型外，之后的每一种造型都根据角色的基础图像生成，因此在整个推广活动或图片网格中，面孔始终是同一个人。这种一致性正是产品的核心。

完整定价：图像 2 个点数 · 短片 7（5 秒）/ 13（10 秒）个点数 · 动作控制按驱动视频每秒 3 个点数，使用 --engine wan 时每秒 2 个点数（最长 30 秒）· 将 AI 网红放入你自己的视频（videos replace）按每秒 3 个点数计费（最长 30 秒）· 场景编排短片 9（5 秒）/ 15（10 秒）个点数 · 成品视频免费。 费用会根据时长计算，退款会返还实际扣除的确切金额。使用 clipugc credits 查看实时价格。

快速入门（纯 CLI）

# 1. Cast the AI influencer. Be specific, this is what decides whether it looks
#    like a real creator or like generic AI. (See the casting guide for the formula.)
clipugc characters create --wait \
  --description "Very pretty Danish woman aged 22, light blonde fine hair to her shoulders with a middle parting, pale blue upturned eyes, heart-shaped face, porcelain cool-toned skin. Genuinely attractive Instagram-creator look, but reads as a real girl, natural skin texture with visible pores, not airbrushed." \
  --scene "close selfie in a softly lit bedroom at golden hour, warm rim light on her hair, full glam makeup with winged liner and glossy lips, natural skin texture, amateur front-camera phone quality, headroom above her head for text"

# 2. Animate the look into a 5s silent reaction.
clipugc videos create --image <lookId> --duration 5 --wait \
  --prompt "Handheld selfie framing, slight drift. Her expression gradually shifts from neutral to amazed, eyebrows rise, eyes widen, lips part slightly in a silent gasp, then she breaks into a delighted grin and holds it, looking straight into the camera. Hair moves subtly. No talking."

# 3. Add your app recording and a hook. Free, so test as many hooks as you like.
clipugc videos merge <videoId> --app-video ./screenrec.mp4 --hook "nobody talks about this app" --wait

# 4. Download the finished video by its own id (merged_video_id), not the clip id.
clipugc finished download <videoId> -o ugc-video.mp4

在任何命令后添加 --json，即可获取机器可读的输出；在任何生成命令后添加 --wait，即可通过加载动画轮询，直到生成完成。

示例提示词

提示词就是产品本身。下面每类各有一个示例；完整库见 docs/casting.md（9 种国籍）和 ugc-director 技能（涵盖 9 种情绪类别、约 30 种反应）。

选角：具体特征 → 明确的魅力描述 → 指定妆容和灯光 → 真实感锚点。四个部分缺一不可，否则效果就会看起来像 AI：

clipugc characters create --wait \
  --description "Very pretty Danish woman aged 22, light blonde fine hair to her shoulders with a middle parting and natural movement, pale blue upturned eyes, heart-shaped face, porcelain cool-toned skin, soft pink lips, gentle jawline. Calm, faintly teasing expression. Genuinely attractive Instagram-creator look, but reads as a real girl, natural skin texture with visible pores, not airbrushed." \
  --scene "close selfie in a softly lit bedroom at golden hour, warm low sun through the window behind her giving a rim light on her hair, full glam makeup with winged liner, long lashes and glossy lips, natural skin texture, amateur front-camera phone quality, headroom above her head for text"

clipugc characters create --wait \
  --description "Very pretty Russian woman aged 22 from Moscow, ash-blonde straight hair below her shoulders with a middle parting, cool grey-blue almond eyes set wide apart, high broad cheekbones, straight narrow nose, fair cool-toned skin, medium lips with a defined cupid's bow, fine straight brows. Reserved, slightly aloof expression that warms when she smiles. Strikingly attractive Instagram-creator look, yet unmistakably a real person, natural skin texture with visible pores, not airbrushed." \
  --scene "close selfie in a softly lit bedroom at golden hour, warm low sun behind her giving a rim light on her hair, soft glam makeup with winged liner and a nude glossy lip, natural skin texture, amateur front-camera phone quality, headroom above her head for text"

clipugc characters create --wait \
  --description "Very pretty Ukrainian woman aged 21 from Kyiv, honey-brown hair with a soft natural wave past her shoulders, warm green eyes with a gentle upturn, soft oval face with a rounded chin, light golden-toned skin, full lips, softly arched brows, a small mole above her lip. Warm, open, easy-smiling energy. Genuinely attractive Instagram-creator look that reads as a real girl, natural skin texture with visible pores, not airbrushed." \
  --scene "front-camera phone selfie by a large window in a bright apartment, soft diffused daylight on her face, plants blurred behind, everyday makeup with fluffy brows and a glossy lip, natural skin texture, amateur phone quality, headroom above the head for text"

造型：不要重新描述人物；底图已经包含她的面容。只更换场景、服装和灯光：

clipugc images generate --character <id> --wait \
  --scene "mirror selfie in a bathroom in the evening, phone visible in her hand, warm vanity lights either side of the mirror, polished makeup with glowing skin and blush, natural skin texture, amateur phone quality, headroom above the head for text"

clipugc images generate --character <id> --wait \
  --scene "sitting in the driver's seat of a parked car in daylight, seatbelt on, daylight through the windscreen, natural skin texture, amateur phone quality, headroom above the head for text"

反应：设计有节拍的情绪弧线，以定格结尾，加入环境动作，并且每次都明确要求不说话：

Handheld selfie framing with tiny natural wobble. She looks directly into the camera, one eyebrow raises slightly, a knowing smirk slowly spreads across her face, and she nods slowly twice, lips closed, holding eye contact the entire time. Hair moves subtly. No talking, mouth stays closed.

Handheld selfie framing, slight drift. Her expression gradually shifts from neutral to amazed, eyebrows rise, eyes widen, lips part slightly in a silent gasp, then she breaks into a delighted grin and holds it, looking straight into the camera. Hair moves subtly. No talking.

Nearly static selfie framing with subtle handheld drift. She rests her cheek against her palm, elbow anchored, eyes softening as a slow warm closed-mouth smile spreads, gaze drifting slightly off camera then returning to the lens, holding it. Hair moves subtly. No talking.

Handheld selfie framing, slight wobble. She exhales through her nose, shakes her head slowly with a rueful closed-mouth smile, briefly glances up at the ceiling, then back into the camera with an amused resigned look, holding it. Hair follows the motion naturally. No talking.

吸睛文案：叠加在视频片段上的文字。同一片段可以免费换用新的吸睛文案，因此每个视频都制作 2-3 个版本，让平台来选择：

nobody talks about this app
why did nobody tell me
I stopped paying for 4 apps
POV: you finally organised your week

对比

ClipUGC 是通过 AI Agent 制作 UGC 风格视频的多种方式之一。以下是两篇由我们撰写的对比文章，均标注了各工具的“适用场景之外”，也包括 ClipUGC：

• 制作 AI UGC 视频的最佳 MCP 服务： 对比 ClipUGC、agent-media、VidGuy、UnrealUGC、UGC Copilot 和 EzUGC 的托管方式、登录要求、工具数量、免费使用额度和价格。
• 移动应用的最佳 AI UGC 视频生成器： 介绍八种工具，包括 ReelFarm、Fastlane、UGCdrop、MakeUGC、Creatify 和 Arcads。

简而言之：如果你想要一位在每个视频中面容一致、并在画面中展示你的应用的 AI 网红，可以选择 ClipUGC；你可以通过终端或聊天来制作视频，价格为每月 $14.99 起，并提供免费套餐。它不会替你发布内容，也不支持网店从商品页面直接生成视频。

文档

本地开发

npm ci
npm run build     # compile TypeScript to dist/
npm test          # run the vitest suite
npm run dev       # run from source (tsx src/index.ts)
npm run build:mcpb  # build the Claude Desktop extension: dist-mcpb/clipugc.mcpb
                    # also writes dist-mcpb/clipugc-smithery.mcpb for `smithery mcp publish`

仓库根目录中的 manifest.json 和 icon.png 描述了 Claude Desktop 扩展。构建脚本会将 dist/、package.json 和仅用于生产环境的 node_modules/ 放入 dist-mcpb/stage/，验证清单文件并打包。其版本、名称和工具列表必须与 package.json 和 MCP 服务保持一致；测试会对此进行检查。

隐私政策

此 CLI 和 Claude Desktop 扩展本身不会收集任何信息。 代码中没有分析、遥测或崩溃报告功能。

离开你设备的数据包括：你的提示词和工具参数、你选择上传的文件（照片、应用屏幕录制、驱动视频）以及你的 API 密钥。这些数据只会通过 HTTPS 发送至 clipugc.com，且仅用于处理你发起的请求。API 密钥存储在 ~/.config/clipugc/config.json（CLI）或 Claude Desktop 的扩展设置中，绝不会发送到其他地方。

ClipUGC 服务如何存储和处理这些数据（包括数据保留期限，以及用于渲染视频的 AI 服务提供商）详见 ClipUGC 隐私政策： https://clipugc.com/privacy-policy?utm_source=github-readme&utm_medium=integration&utm_campaign=agent-directories。

如有疑问或需要删除数据，请联系：[email protected]。

许可证

MIT