Skills clipcat

Name: clipcat
Author: openclaw

Clipcat - TikTok e-commerce video creation skill. Video search, product insights, viral replication, product-to-video generation, breakdown analysis, and video download via Clipcat CLI.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/a2888409/clipcat" ~/.claude/skills/openclaw-skills-clipcat && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/a2888409/clipcat" ~/.openclaw/skills/openclaw-skills-clipcat && rm -rf "$T"

manifest: skills/a2888409/clipcat/SKILL.md

Clipcat CLI

Use this skill when you need TikTok e-commerce video creation through

clipcat

Get API key: https://clipcat.ai/workspace?modal=settings&tab=apikeys

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.

Installation

This skill is auto-installed by OpenClaw using the declared

install

spec in the frontmatter above. OpenClaw downloads the platform-specific binary from versioned, immutable URLs under

https://static.clipcat.ai/public/cli/vX.Y.Z/

and places it under

~/.openclaw/tools/clipcat/

. No remote shell script is executed.

After installation, configure your API key once:

clipcat config --api-key <your-key>

What this CLI is for

clipcat

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

Search viral TikTok videos by keyword
Search TikTok Shop products by keyword (market intelligence)
Get TikTok Shop product details and reviews
Replicate viral videos with your product
Generate product videos from images
Generate AI images from text prompts (with optional reference images)
Analyze videos (script, scenes, music)
Download TikTok/Douyin videos
Query async task status

Default agent workflow

Start with
```
clipcat -h
```
to see all commands.
Before using any command, run
```
clipcat <subcommand> -h
```
to see flags.
Default to JSON output. Only use
```
--pretty
```
when the result is meant for human terminal reading.
Warn the user before running commands that consume credits.

Choosing the right command

```
search
```
— find viral TikTok videos by keyword
```
search_items
```
— search TikTok Shop products by keyword; returns market insights, competitor shops, and product intelligence
```
product_detail
```
— get product info by ID or URL
```
product_comment
```
— get product reviews
```
replicate
```
— replicate a viral video with your product images (auto-detects URL type)
```
product_video
```
— generate video from product images only (no reference video)
```
image
```
— generate an AI image from a text prompt; optionally supply up to 5 reference images via
```
--image
```
(local file) or
```
--image-url
```
(URL)
```
list_images
```
— list image generation tasks from server; supports
```
--status
```
/
```
--limit
```
/
```
--page
```
filters
```
breakdown
```
— analyze a video (script, scenes, music)
```
download
```
— download TikTok/Douyin video (returns signed URL)
```
user_videos
```
— get a TikTok user's video list with analytics (plays, likes, shares, comments, e-commerce cart data)
```
query_task
```
— check status of an async task
```
list_tasks
```
— list recent tasks from server

replicate: URL type auto-detection

clipcat replicate

automatically detects the URL type:

TikTok/Douyin link → calls
```
/replicate_from_social
```
(costs 1 extra credit for download)
Direct video URL → calls
```
/replicate
```

Always inform the user about the extra credit before running with a social URL.

Async task rules

replicate

product_video

image

, and

breakdown

are async. After submission:

Task ID is saved locally to
```
~/.clipcat/tasks.json
```
automatically.
Use
```
--poll <seconds>
```
to wait inline (e.g.
```
--poll 600
```
= wait up to 10 min).
If poll times out, the CLI prints a resume command — save it.
Use
```
clipcat query_task
```
(no args) to resume the latest local task.
Use
```
clipcat list_tasks
```
to see all tasks from the server.

query_task: auto-resume

clipcat query_task

with no flags automatically reads the latest task from

~/.clipcat/tasks.json

and resumes it. No need to remember task IDs.

Available models

Model ID	Duration	Resolution
`sora2`	10s, 15s	720p
`sora2_official`	4s, 8s, 12s	720p
`veo3.1fast`	8s,16s,24s	720p, 4K

Always check

clipcat replicate -h

for the current model list.

Good agent behavior

Run
```
clipcat -h
```
first if unsure which command to use.
Show parameters to user and get confirmation before running paid commands.
Keep record of task IDs; use
```
query_task
```
to resume if poll times out.
Preserve signed video URLs intact — they contain
```
X-Amz-*
```
params that break if truncated.
Agents should prefer the default JSON output.
Use
```
--pretty
```
only for human-facing terminal display.