revid-shopify-product-promo
Turn a Shopify (or any e-commerce) product page URL into a 30–45 second 9:16 promo video ready for TikTok / Reels / Shorts. Use when the user shares a product link and wants a short ad/promo, not a long-form review. Calls the Revid MCP server (render_video → get_project_status).
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- revid-shopify-product-promo
- metadata
- { "openclaw": { "requires": { "config": [ "REVID_API_KEY" ] } } }
- description
- Turn a Shopify (or any e-commerce) product page URL into a 30–45 second 9:16 promo video ready for TikTok / Reels / Shorts. Use when the user shares a product link and wants a short ad/promo, not a long-form review. Calls the Revid MCP server (render_video → get_project_status).
02 资源文件 2
- 脚本examples/run.sh1.0 KB
- 参考文档examples/shopify-aeropods.json1.0 KB
03 SKILL.md 正文
Shopify product → promo video
Calls the Revid MCP server (
https://www.revid.ai/api/mcp). Install once — seerevid-api-foundations.
Take a product page URL and produce a vertical promo video that pulls the product image(s), name, key features, and price.
When to use this skill
- Input is a single product page URL from Shopify, WooCommerce, BigCommerce, or any storefront with crawlable HTML (most stores).
- Output goal is a promo / ad / launch teaser, 30–45 s, vertical (9:16).
- The user wants Revid to extract the product details automatically. If they
hand you a script instead, use
revid-script-to-video. - For a generic ad written from a product description (no live URL), use
revid-product-description-to-ad.
Inputs
| Field | Required | Notes |
|---|---|---|
url |
yes | Public product page URL |
aspectRatio |
no | Defaults to 9:16 |
targetDuration |
no | Defaults to 35 (s) |
voiceId |
no | Default voice if omitted |
webhookUrl |
no | Skip polling if you can receive webhooks |
Step-by-step
- Validate the URL — must start with
http(s)://. Reject obvious non-product paths (/cart,/blog,/collections/all). - Optional pre-flight — fetch the URL once with
HEADto confirm it returns 200. If 4xx, ask the user to confirm the link. - Build the payload (see template). Defaults are tuned for product promo:
high
density, dynamic animation, captions ON, music ON. - Call MCP tool
render_videowith the payload below — returnsdata.pid. Then poll MCP toolget_project_statuswith thatpidevery 5–8 s untildata.status === "ready". Optionally callexport_videofor a freshly named mp4. - Return
{ pid, status, videoUrl, thumbnailUrl, durationSeconds, creditsUsed }.
render_video arguments
{
"workflow": "article-to-video",
"source": {
"url": "{PRODUCT_URL}",
"scrapingPrompt": "Extract the product name, hero image, 3 key features, and price. Ignore reviews, related products, footer, and navigation."
},
"aspectRatio": "9:16",
"voice": { "enabled": true, "stability": 0.55, "speed": 1.05, "language": "en-US" },
"captions": { "enabled": true, "position": "middle", "autoCrop": true },
"music": { "enabled": true, "syncWith": "beats", "trackName": "uplifting-pop" },
"media": {
"type": "stock-video",
"density": "high",
"animation": "dynamic",
"quality": "pro",
"imageModel": "good",
"videoModel": "pro",
"turnImagesIntoVideos": true,
"applyStyleTransfer": false
},
"options": {
"targetDuration": 35,
"summarizationPreference": "summarize",
"hasToGenerateCover": true,
"coverTextType": "product-name",
"soundEffects": true,
"addStickers": false
},
"render": { "resolution": "1080p", "frameRate": 30 }
}
scrapingPrompt is the most important knob — it stops Revid from picking up
header/footer junk. Customize it per storefront if you find a recurring noise
pattern.
Examples
examples/shopify-aeropods.json— copy-paste body forrender_video(also a valid POST body for the direct HTTPS fallback).examples/run.sh— bash smoke test using the direct HTTPS fallback (POST /api/public/v3/render→GET /status). Useful when you don't have an MCP client at hand.
Quick test
Call render_video with examples/shopify-aeropods.json,
with source.url set to your product page
(https://your-shop.myshopify.com/products/your-product).
Polling
Call get_project_status with the pid returned by render_video. Stop when
data.status === "ready"; fail when data.status === "failed". Cadence: 5 s,
then 8 s once progress > 30. Full pseudocode:
revid-api-foundations § Polling.
Failure modes
| Symptom | Fix |
|---|---|
scrape failed / 403 from the URL |
Storefront blocks bots. Open the page in a real browser, copy the title + 3 bullet features + price into a script, and switch to revid-script-to-video. |
| Video shows wrong product image | Storefront serves SSR via JS only. Pass media.useOnlyProvided: true and media.provided: [{ url: "<hero-image-url>", type: "image" }] to force the right asset. |
| Voice sounds robotic | Increase voice.stability to 0.7 and pick a specific voice.voiceId. Default voice varies. |
| Duration overshoots target | Set options.summarizationPreference: "summarize" (already in the template) and lower targetDuration. |
| Captions cover product | captions.position: "top" (or "bottom"). |
ok: false, error: "insufficient_credits" |
Drop media.quality to "standard" or render.resolution to "720p", or call buy_credit_pack. |
See also
revid-product-description-to-adif you don't have a live URL.revid-script-with-custom-mediaif you want to control every visual.revid-api-foundationsfor the contract.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.