Clipcat is a skill bundle for agents that can run shell commands. The agent reads `SKILL.md`, runs `clipcat` commands, and parses JSON output to search TikTok Shop data, analyze videos, and generate new selling content.
Builders who want their agent to research TikTok Shop and generate or replicate short-form product videos.
You can turn a shell-capable agent into a TikTok Shop video producer that researches, analyzes, and generates clips from one CLI.
Queries creators, products, shops, videos, lives, keywords, images, reviews, and comments across TikTok Shop markets.
Searches reverse-engineered prompts from real high-GMV selling videos and rewrites them for a new product.
Extracts scripts, scenes, hooks, and music from TikTok or Douyin videos.
Recreates a proven video structure using your product assets, a video URL, or a local file.
Turns product photos into UGC-style or talking-head videos and can generate e-commerce images from text prompts.
Downloads TikTok or Douyin videos through the Clipcat API.
# Install the clipcat CLI curl -fsSL https://clipcat.ai/cli | bash
clipcat config --api-key your_api_key_here --base-url https://clipcat.ai
I sell a portable blender (image: /path/to/juicer.jpg), target market US. Search the viral prompt library for relevant proven videos, rewrite the best match into a selling-video prompt for my product, tell me which video it came from, and generate an 8s video once I approve.
Search for viral TikTok videos about lip gloss in the US market this week. Show me the top 10 results sorted by likes.
Create a 10-second OOTD video featuring a British girl showcasing my product. Product image: /path/to/dress.jpg Use veo3.1fast model, 9:16 aspect ratio, English language.
Analyze this video and extract the script, scenes, and music information: https://www.tiktok.com/@username/video/987654321
Turn any AI agent into a TikTok Shop video producer. Find viral TikTok videos, research TikTok Shop products, shops, creators and live rooms, break down why a video sells, generate a ready-to-shoot viral selling prompt from the library of real high-GMV AI selling videos, replicate a winning video with your own product, turn product photos into AI selling / UGC / talking-head videos, generate e-commerce images from a text prompt, and download TikTok or Douyin videos — all from one CLI.
Works with any AI agent that can run shell commands — Claude Code, Codex, WorkBuddy, OpenClaw, Cursor, or your own. It ships as a single cross-platform clipcat CLI plus a SKILL.md manifest: the agent reads the manifest, runs clipcat commands and parses the JSON output.
For the latest guide and examples, see: https://clipcat.ai
中文文档：README_ZH.md
Clipcat is just a small CLI binary and a SKILL.md skill manifest, so any agent that can run shell commands can drive it:
SKILL.md to learn the available commands and conventions.clipcat <command> and parses the JSON output (default).OpenClaw auto-installs the skill from the manifest; any other agent installs the CLI manually (see below). Either way the runtime is the same clipcat binary.
clipcat <entity> -h)--enhance--character-idOpenClaw — auto-installed from the skill manifest; no manual step needed.
Any other agent / manual — install the CLI binary:
# Install the clipcat CLI
curl -fsSL https://clipcat.ai/cli | bash
Sign up or log in, then generate an API key in your personal center:
Configure the key once on the machine the agent runs on:
clipcat config --api-key your_api_key_here --base-url https://clipcat.ai
Agents that manage secrets via environment variables can instead set CLIPCAT_API_KEY (e.g. OpenClaw: openclaw env set CLIPCAT_API_KEY your_api_key_here).
Once installed, you can ask your agent to:
clipcat quote, shows you the model / duration / resolution / credits, and waits for your confirmationclipcat prompt search doesn't invent a script — it retrieves from a real, searchable
library of AI selling videos that actually sold on TikTok Shop:
| Asset | What it gives you |
|---|---|
| 5000+ real AI viral selling videos | Every one actually sold on TikTok Shop — not demos, not concepts |
| 15 markets online | US, UK, and every other TikTok Shop market, so prompts match your target region |
| 30 primary categories online | Beauty, home, electronics, food… matched to your product's category |
| Copy-ready prompts | Each viral video ships with the exact prompt that produced it — copy it, or replicate the video in one step |
| Real sales proof | Every entry carries the original video's real GMV / sales / views, so you build on what already won |
| Updated daily | New winners land every day — the US market is ingested daily, the other markets weekly |
| Semantic search | Describe the effect you want ("cozy home, handheld close-up, real person on camera") and retrieve the matching winners |
Because every prompt is grounded in a video that already sold, clipcat prompt search
gives you a ready-to-shoot prompt built on a proven best-seller — not a guess. Each hit
comes back with the source video and its public detail page, so you can always see what
the prompt was reverse-engineered from.
Trial models are open to all users; standard models require a paid plan.
| Model ID | Duration | Resolution | Notes |
|---|---|---|---|
grok_imagine | 10s, 15s | 480p, 720p | Trial, default. xAI Grok Imagine 1.5, 9:16 only |
veo3.1fast | 8s, 16s, 24s | 720p | Trial. Google Veo 3.1 Fast, balanced quality and cost |
omini_flash | 10s, 20s | 720p, 1080p | Trial. Gemini Omni Flash, Google's newest model |
seedance2_mini | 4-15s (any integer) | 480p, 720p | Trial. Seedance 2 Mini, value tier (free plans: 480p) |
mmh3_promo | 10s, 15s | 480p, 720p, 2K | Trial. Subsidized MiniMax H3, open to free plans |
seedance2 | 4-15s (any integer) | 480p, 720p, 1080p | Paid. ByteDance Seedance 2, top quality |
seedance2_5 | 4-30s (any integer) | 480p, 720p | Paid. ByteDance Seedance 2.5, clips up to 30s |
seedance2_fast | 4-15s (any integer) | 480p, 720p | Paid. ByteDance Seedance 2 Fast, fast variant |
wan30 | 5-30s (any integer) | 480p, 720p, 1080p | Paid. Alibaba Wan 3.0, clips up to 30s |
minimax_h3 | 10s, 15s | 768p, 2K | Paid. MiniMax H3 |
happyhorse10 | 3-15s (any integer) | 720p, 1080p | Paid. Alibaba HappyHorse 1.1 |
The table is what each model offers; run clipcat models for the live listing with the exact per-combination credit cost and your balance — it is the authority on which models still exist, and -h lags behind it between releases. Prefer mmh3_promo over minimax_h3 whenever it is listed: same model, subsidized channel, a fraction of the credits.
English, Chinese, French, German, Malay, Vietnamese, Thai, Japanese, Korean, Indonesian, Filipino, Spanish
US GB DE ES FR IT JP MX BR ID MY PH SG TH VN
All monetary values in e-commerce data responses are USD-converted regardless of region.
I sell a portable blender (image: /path/to/juicer.jpg), target market US.
Search the viral prompt library for relevant proven videos, rewrite the best match
into a selling-video prompt for my product, tell me which video it came from,
and generate an 8s video once I approve.
The agent runs clipcat prompt search over prompts reverse-engineered from real high-GMV videos, keeps the original hook, shot pacing and voiceover tone, swaps in your product and selling points, and cites the source video's page before spending any credits.
Search for viral TikTok videos about lip gloss in the US market this week.
Show me the top 10 results sorted by likes.
Returns a ranked list of relevant viral videos, including core metrics and source links for further analysis.
Please use Clipcat’s replication feature to fully replicate the original video’s script and visuals, replacing only the original product with my product. If there is voiceover in the original video, please adapt it to match my product; if there is no voiceover, then no voiceover is needed. The replicated video should not include subtitles. The duration of the new script must be controlled within 15 seconds. Please use the model seedance2.0, and the voiceover language should be English.
This is the TikTok link to replicate:https://www.tiktok.com/@username/video/123456789
The agent will display the parameters and wait for confirmation before submitting the task.
Create a 10-second OOTD video featuring a British girl showcasing my product.
Product image: /path/to/dress.jpg
Use veo3.1fast model, 9:16 aspect ratio, English language.
Analyze this video and extract the script, scenes, and music information:
https://www.tiktok.com/@username/video/987654321
Returns structured data including scene-by-scene breakdown, visual descriptions, voiceover content, and background music.
Download this TikTok video:
https://www.tiktok.com/@username/video/111222333
Synchronous operation, returns direct video URL immediately.
This repo follows the Agent Skills convention — one skill per directory under skills/, each containing a SKILL.md manifest:
clipcat-skill/
├── README.md # this file
├── README_ZH.md # Chinese version
├── docs/
│ └── SKILL_ZH.md # Chinese translation of the skill manifest
└── skills/
└── clipcat/
└── SKILL.md # the skill manifest agents load
skills/clipcat/SKILL.mdSign in to join the discussion.
No comments yet. Be the first to say what this is good for.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)
AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary
Academic Research Skills for Claude Code: research → write → review → revise → finalize
AI video skill for Claude Code & Codex — cinematic product videos with Remotion: 152 shot recipe cards, 209 motion previews, a production-ready template
817 structured cybersecurity skills for AI agents · Mapped to 6 frameworks: MITRE ATT&CK, NIST CSF 2.0, MITRE ATLAS, D3FEND, NIST AI RMF & MITRE F3 (Fight Fraud) · agentskills.io standard · Works with Claude Code, GitHub Copilot, Codex CLI, Cursor, Gemini CLI & 20+ platforms · 29 security domains · Apache 2.0