clipcat

name	clipcat
description	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.
user-invocable	true
metadata	{"openclaw":{"skillKey":"clipcat","requires":{"env":["CLIPCAT_API_KEY"]},"primaryEnv":"CLIPCAT_API_KEY","install":[{"id":"download-darwin-arm64","kind":"download","os":["darwin"],"arch":["arm64"],"url":"https://static.clipcat.ai/public/cli/v1.0.6/clipcat_darwin_arm64.tar.gz","archive":"tar.gz","bins":["clipcat"],"label":"Install Clipcat CLI (macOS Apple Silicon)"},{"id":"download-darwin-x64","kind":"download","os":["darwin"],"arch":["x64"],"url":"https://static.clipcat.ai/public/cli/v1.0.6/clipcat_darwin_amd64.tar.gz","archive":"tar.gz","bins":["clipcat"],"label":"Install Clipcat CLI (macOS Intel)"},{"id":"download-linux-x64","kind":"download","os":["linux"],"arch":["x64"],"url":"https://static.clipcat.ai/public/cli/v1.0.6/clipcat_linux_amd64.tar.gz","archive":"tar.gz","bins":["clipcat"],"label":"Install Clipcat CLI (Linux x86_64)"},{"id":"download-linux-arm64","kind":"download","os":["linux"],"arch":["arm64"],"url":"https://static.clipcat.ai/public/cli/v1.0.6/clipcat_linux_arm64.tar.gz","archive":"tar.gz","bins":["clipcat"],"label":"Install Clipcat CLI (Linux arm64)"},{"id":"download-windows-x64","kind":"download","os":["win32"],"arch":["x64"],"url":"https://static.clipcat.ai/public/cli/v1.0.6/clipcat_windows_amd64.zip","archive":"zip","bins":["clipcat.exe"],"label":"Install Clipcat CLI (Windows x86_64)"}]},"homepage":"https://clipcat.ai"}

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

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. Only use --pretty when the result is meant for human terminal reading.
4. 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:

1. Task ID is saved locally to ~/.clipcat/tasks.json automatically.
2. Use --poll <seconds> to wait inline (e.g. --poll 600 = wait up to 10 min).
3. If poll times out, the CLI prints a resume command — save it.
4. Use clipcat query_task (no args) to resume the latest local task.
5. 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.