/clipcat

name: clipcat
description: All-in-one TikTok Shop selling-video skill for any AI agent (Claude Code, Codex, WorkBuddy, OpenClaw). Find viral TikTok videos, research TikTok Shop products, shops, creators and live rooms, break down why a video sells (script, scenes, hooks, music), search the largest library of real high-GMV AI selling videos and their reverse-engineered prompts and adapt the closest match to your own product, replicate a winning video, turn product photos — or your own raw prompt and images — into AI selling / UGC / talking-head / product-demo videos, generate e-commerce images from a text prompt, upscale to 1080p or 2K, and download TikTok or Douyin videos. Keywords — AI selling video, TikTok viral replication, TikTok Shop product research, competitor shop analysis, creator and influencer ranking, AI selling video prompt library, product-to-video, UGC video generator, AI product image, TikTok video downloader. Use whenever the user needs TikTok e-commerce data, viral video research, or AI video/image generation.
user-invocable: true
metadata:
  {
    "openclaw":
      {
        "requires": { "env": ["CLIPCAT_API_KEY"] },
        "primaryEnv": "CLIPCAT_API_KEY",
      },
    "homepage": "https://clipcat.ai",
  }

Clipcat CLI

This skill is intentionally short. Detailed flags and supported values belong to the CLI itself — always treat `clipcat -h` and `clipcat <subcommand> -h` as the primary reference. The one thing `-h` cannot be current about is the model catalog: models come and go between releases, so `clipcat models` is the authority on which models, resolutions and durations exist right now.

Installation

Run `clipcat --version` first — if it prints a version, clipcat is installed; skip to API key. If the command is missing, install for the platform:

macOS / Linux / Git Bash:

curl -fsSL https://clipcat.ai/cli | bash

Windows (PowerShell, no bash):

irm https://clipcat.ai/cli.ps1 | iex

Then set the API key (see below). Update later with `clipcat update` (re-runs the installer; your saved config is preserved).

Windows sandbox note (Codex etc.)

If the Windows install fails with `SEC_E_NO_CREDENTIALS`, `AcquireCredentialsHandle`, `0x8009030E`, "The underlying connection was closed", or 「基础连接已经关闭」, you are in a restricted sandbox (e.g. the Codex Windows sandbox) where the Windows TLS stack (Schannel) can't open credentials — `Invoke-WebRequest` and system `curl.exe` both fail there. The installer automatically retries the download through Node (its OpenSSL bypasses Schannel), so installing Node in the sandbox usually fixes it. If it still fails, **show the install command to the user and ask them to run it in a normal PowerShell outside the sandbox, or to approve running it outside the sandbox — do not keep retrying with different commands.**

API key

Configure the key in the local config file — the only reliable method:

clipcat config --api-key <your-key> --base-url https://clipcat.ai

Get the key at https://clipcat.ai/workspace?modal=settings&tab=apikeys. Prefer the config file over the `CLIPCAT_API_KEY` environment variable: sandboxed agents (e.g. Codex) filter out env vars whose names contain KEY/SECRET/TOKEN, so it is usually invisible there. (OpenClaw injects `CLIPCAT_API_KEY` automatically; when set, it overrides the config file.)

What this CLI is for

`clipcat` is the local entrypoint for all Clipcat AI video generation workflows:

• Query TikTok e-commerce data: creators, products, shops, videos, lives, search
• Generate a ready-to-shoot selling-video prompt from the viral prompt library
• Replicate viral videos with your product
• Generate product videos from images
• Generate a video straight from your own prompt and assets, sent to the model verbatim
• Generate AI images from text prompts using GPT Image 2 / GPT Image 2.5 (Flare / Sunburst), with optional reference images
• Turn a script into an mp3 voice-over (text-to-speech, preset or cloned voice), reusable as reference audio
• Analyze videos (script, scenes, music)
• Download TikTok/Douyin videos
• Publish finished videos to your own TikTok accounts (direct post or drafts inbox)
• Schedule an Agent prompt to run by itself every day or on chosen weekdays
• Query async task status

Default agent workflow

1. Start with `clipcat -h` to see all commands. 2. Before using any command, run `clipcat <subcommand> -h` to see flags. 3. Default to JSON output. 4. `replicate` / `product_video` / `generate` / `tiktok publish` submit in TWO calls: the first charges nothing, creates nothing and returns a checklist + `confirmId`; you show that checklist to the user, wait for an explicit yes, then run `--confirm <confirmId>` (see "Two-step confirmation"). 5. If any command prints an update notice on stderr (`⬆ clipcat X is available … Run: clipcat update`), run `clipcat update` once, then continue. It self-skips when already up to date, so it is safe to run.

Choosing the right command

TikTok e-commerce data — entity commands

These are noun-verb commands: `clipcat <entity> <verb>`. Run `clipcat <entity> -h` to list verbs and `clipcat <entity> <verb> -h` for flags.

• `creator <list|rank|profile|enrich|trend|posts|sales-videos|lives|products|followers|following|region|milestones>` — TikTok creators/influencers
• `product <list|rank|detail|trend|reviews|live-comments|creators|videos|lives>` — TikTok Shop products
• `seller <list|rank|detail|trend|catalog|inventory|creators|videos|lives>` — TikTok Shop shops
• `video <list|rank|snapshot|sales|trend|comments|captions|products|hashtag>` — TikTok videos
• `live detail` — live-room detail (only while live)
• `find <creators|products|videos|lives|hashtags|music|photo|all>` — keyword/image search; `find all` is the broad fallback

**Two data sources, and the command name already picks one for you.** There is no `--mode` flag to reason about — pick by what you need back:

| You need |