用途：Clipcat CLI 是 Clipcat AI 视频生成工作流的本地入口，供 Claude Code、Codex、WorkBuddy、OpenClaw 等 AI 智能体调用，覆盖 TikTok Shop 卖货视频从选品调研到成片发布的流程。
主要能力：查询 TikTok 电商数据（达人、商品、店铺、视频、直播、搜索）；从爆款提示词库生成可直接拍摄的卖货视频提示词；用自有产品复刻爆款视频；由图片生成产品视频；按自有提示词与素材生成视频；用 GPT Image 2 / GPT Image 2.5 生成 AI 图片；将脚本转为 mp3 配音（预设或克隆音色）；分析视频脚本、场景与音乐；下载 TikTok/抖音视频；发布成片到自己的 TikTok 账号（直接发布或草稿箱）；按天或指定工作日定时运行 Agent 提示词；查询异步任务状态。
安装与配置：先运行 clipcat --version 判断是否已安装。macOS / Linux / Git Bash 安装命令为 curl -fsSL https://clipcat.ai/cli | bash；Windows PowerShell 为 irm https://clipcat.ai/cli.ps1 | iex。之后配置密钥：clipcat config --api-key <your-key> --base-url https://clipcat.ai，密钥获取地址为 https://clipcat.ai/workspace?modal=settings&tab=apikeys。更新用 clipcat update。
使用方式：先运行 clipcat -h 查看全部命令，再用 clipcat <subcommand> -h 查看参数；默认输出 JSON。replicate、product_video、generate、tiktok publish submit 采用两步确认：首次调用不扣费、不创建任务，返回清单与 confirmId，用户明确确认后再加 --confirm <confirmId> 执行。数据命令为名词-动词结构，如 creator、product、seller、video、live、find 等。
限制：历史数据集覆盖有限，sales/catalog/enrich 类命令常返回未收录；空结果表示未收录而非不存在。分页按次计费，历史列表用 --page/--page-size（上限 10），实时列表用 --offset/--cursor。读取命令每次 6 积分，提示词搜索超出免费额度后每次 3 积分。所有金额均为美元。Windows 沙箱可能因 TLS 凭据问题安装失败，需在普通 PowerShell 中运行。模型目录以 clipcat models 为准。