19926533763/clipcat-skill

Files

T

19926533763 66dfe5d74d feat: add Clipcat skill

2026-09-02 14:17:59 +08:00

5.8 KiB

Raw Blame History

Clipcat Skill

Clipcat 是一个 TikTok 电商 AI 视频创作 Skill，任何 AI Agent 都可以集成——Claude Code、OpenClaw、Cursor，或你自研的 Agent 均可。它以一个跨平台的 clipcat CLI 加一份 SKILL.md 清单的形式提供：Agent 通过调用 clipcat 命令，在同一套工作流中完成爆款视频发现、TikTok Shop 市场情报分析、视频分析、爆款复刻、商品视频生成、AI 图片生成以及 TikTok 视频下载。

最新指南和示例请查看：https://clipcat.ai

工作原理

Clipcat 本质上只是一个小巧的 CLI 二进制 + 一份 SKILL.md 技能清单，任何能执行 shell 命令的 Agent 都能驱动它：

Agent 读取 SKILL.md 了解可用命令与约定。
调用 clipcat <命令> 并解析其 JSON 输出（默认格式）。
异步任务（视频/图片生成）提交后立即返回，由 Agent 跨轮次轮询。

OpenClaw 会依据清单自动安装该 Skill；其他 Agent 则手动安装 CLI（见下文）。无论哪种方式，底层运行的都是同一个 clipcat 二进制。

核心能力

TikTok 电商数据情报：覆盖达人、商品、店铺、视频、直播、关键词/图片搜索 6 大实体域，支持榜单、多维筛选发现、趋势、详情、评价、评论与跨实体关系查询（Agent 通过 clipcat <实体> -h 选择具体命令）
视频分析：提取 TikTok 或抖音视频中的脚本、分镜、钩子和音乐信息
爆款复刻：基于已验证的爆款结构，结合你的商品素材进行复刻生成（自动识别 TikTok/抖音链接与直链视频 URL）
商品生视频：将商品图片生成 UGC 风格的 TikTok 视频
AI 图片生成：基于 GPT Image 2 模型，根据文本提示生成 AI 图片，并可选上传参考图（最多 5 张）
视频下载：通过 Clipcat API 下载 TikTok 或抖音视频

安装

1. 安装 CLI

OpenClaw：依据 Skill 清单自动安装，无需手动操作。

其他 Agent / 手动安装：安装 CLI 二进制：

# 安装 clipcat CLI
curl -fsSL https://clipcat.ai/cli | bash

2. 获取 API Key

注册或登录后，在个人中心生成 API Key：

生成 API Key

3. 配置 API Key

在 Agent 运行的机器上配置一次即可：

clipcat config --api-key your_api_key_here --base-url https://clipcat.ai

通过环境变量管理密钥的 Agent 也可改为设置 CLIPCAT_API_KEY（例如 OpenClaw：openclaw env set CLIPCAT_API_KEY your_api_key_here）。

使用方式

安装完成后，你可以直接让你的 Agent 帮你：

“搜索本周关于 lip gloss 的 TikTok 爆款视频”
“搜索 TikTok Shop 里热门宠物产品，并展示竞品店铺”
“用我的商品图片复刻这个 TikTok 视频”
“用这些图片生成一个商品视频”
“生成一张模特手持我商品的 AI 图片”
“分析这个视频并提取脚本”
“展示这个 TikTok 用户最近的视频及互动数据”
“下载这个 TikTok 视频”
“拉取这个商品链接对应的 TikTok Shop 商品详情和评论亮点”

重要说明

视频生成任务是异步执行的，通常需要几分钟
提交消耗算力的任务前，Agent 会先用 clipcat quote 报出精确算力，向你展示模型/时长/分辨率/算力，并等待你确认
不要手动重复提交任务，Clipcat 已内置重试处理
请保留完整的 TikTok 或抖音链接，尤其是带签名参数的 URL

支持模型

grok_imagine - 10s, 15s, 20s, 30s（720p，仅 9:16）—— 默认模型，支持更长时长
veo3.1fast - 8s, 16s, 24s（720p, 1080p）—— 质量与成本均衡
sora2_official_exp - 4s, 8s, 12s（720p，9:16 或 16:9）—— 仅付费用户，OpenAI Sora 2 官方通道

用 clipcat models 查看完整可用模型列表、每个「分辨率 × 时长」组合的精确算力和你的余额；clipcat replicate -h 也会列出模型。

支持语言

英语、中文、法语、德语、马来语、越南语、泰语、日语、韩语、印尼语、菲律宾语

使用示例

示例 1：搜索 TikTok 爆款视频

Search for viral TikTok videos about lip gloss in the US market this week.
Show me the top 10 results sorted by likes.

会返回按热度排序的相关爆款视频列表，包含核心指标和源链接，便于进一步分析。

示例 2：复刻 TikTok 视频

Replicate this TikTok video with my product:
https://www.tiktok.com/@username/video/123456789

Use these product images:
- /path/to/product1.jpg
- /path/to/product2.jpg

Generate a 16-second video in English using veo3.1fast model.

Agent 会先展示参数，并等待你确认后再提交任务。

示例 3：从零生成商品视频

Create a 10-second OOTD video featuring a British girl showcasing my product.
Product image: /path/to/dress.jpg
Use veo3.1fast model, 9:16 aspect ratio, English language.

示例 4：分析视频

Analyze this video and extract the script, scenes, and music information:
https://www.tiktok.com/@username/video/987654321

会返回结构化数据，包括逐镜头拆解、画面描述、口播内容和背景音乐信息。

示例 5：下载 TikTok 视频

Download this TikTok video:
https://www.tiktok.com/@username/video/111222333

该操作为同步执行，会立即返回视频直链 URL。

使用建议

始终提供完整的 TikTok/抖音链接
Prompt 越具体，结果通常越好
视频生成需要时间，请等待任务完成
带签名参数的视频链接请完整保留
根据时长和质量需求选择合适模型

5.8 KiB Raw Blame History Unescape Escape