核心用法
Clipcat CLI 是一款面向TikTok电商场景的综合性视频生成与数据分析工具，通过命令行接口提供六大核心能力：
1. 电商数据情报
覆盖创作者、商品、店铺、视频、直播、关键词/图片搜索六大实体域，支持榜单查询（日/周/月）、趋势分析、关系链挖掘（如创作者带货商品、商品关联视频）。数据模式区分离线（历史趋势）与实时（当前状态），需通过--mode参数控制。
2. 爆款视频复制（Replicate）
核心功能，支持两类输入：
配合--image/--image-url上传商品图，AI自动提取参考视频的脚本结构、镜头语言、音乐节奏，生成新视频。
- TikTok/Douyin链接：自动识别社交平台URL，额外消耗10积分下载费
- 直链视频URL：直接调用复制接口
3. 纯商品视频生成（Product Video）
无需参考视频，直接由商品图片生成营销视频，适合新品冷启动。
4. AI图像生成
基于GPT Image 2模型，支持文生图及最多5张参考图，提供1:1/16:9/9:16三种画幅。
5. 视频解析（Breakdown）
拆解视频的脚本文本、场景序列、背景音乐，用于竞品分析与素材学习。
6. 视频下载
获取TikTok/Douyin视频的直链下载地址。
显著优点
- 成本透明可控：所有付费操作（
replicate、product_video）必须先调用quote获取精确积分报价，提交时需附带--expected-credits参数，服务器仅在实际成本高于预期时拒绝，杜绝超扣 - 异步任务架构：视频生成类任务（10分钟级）采用异步提交+轮询模式，避免工具调用超时
- 多平台原生支持：提供macOS（Intel/Apple Silicon）、Linux（x86_64/ARM64）、Windows的预编译二进制包，OpenClaw自动安装
- 模型选择灵活：覆盖Google Veo 3.1、Gemini Omni、ByteDance Seedance 2、OpenAI Sora 2等9种视频模型，Trial模型免费开放
- 超分辨率增强：支持720p→2k的后期增强，按10秒区块计费，失败仅退款不扣费
潜在缺点与局限性
- 付费门槛：标准模型（Seedance 2、Sora 2等）及超分辨率功能需订阅付费计划，免费用户受限
- 数据时效约束：榜单查询的
--date参数有严格回溯窗口（日榜≤30天、周榜≤6月、月榜≤12月），过期日期直接被拒 - 实时数据不稳定：部分接口如
creator region、video captions、live detail（仅限直播中）返回空值概率较高 - 分类系统复杂：商品/店铺类目采用三级数字ID体系，需先调用
category resolve解析关键词，存在语言树切换（中英文自动识别）的学习成本 - 地区限制：
--region参数仅支持15个指定国家/地区，超出范围报错
适合人群
- TikTok Shop卖家：需要快速生成商品短视频、监控竞品爆款
- 跨境电商运营：依赖数据驱动决策，需批量分析创作者带货能力
- 短视频广告投手：追求"爆款复制"效率，需要AI拆解优质素材结构
- MCN机构：管理多账号矩阵，需自动化获取达人数据与内容趋势
常规风险
- API密钥安全：
CLIPCAT_API_KEY需妥善保管，建议通过clipcat config本地配置而非硬编码 - 积分消耗管理：视频生成按"模型×分辨率×时长"计费，长视频+高分辨率+超分辨率组合成本累积快，务必先
quote确认 - 任务状态轮询频率：建议
image30秒、video1-2分钟轮询，过度频繁调用可能触发速率限制 - 资产引用格式：
clipcat://开头的内部资源标识符需原样传递，禁止添加https前缀