AGENT SKILL

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

03 SKILL.md 正文

Shopify product → promo video

Calls the Revid MCP server (https://www.revid.ai/api/mcp). Install once — see revid-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

  1. Validate the URL — must start with http(s)://. Reject obvious non-product paths (/cart, /blog, /collections/all).
  2. Optional pre-flight — fetch the URL once with HEAD to confirm it returns 200. If 4xx, ask the user to confirm the link.
  3. Build the payload (see template). Defaults are tuned for product promo: high density, dynamic animation, captions ON, music ON.
  4. Call MCP tool render_video with the payload below — returns data.pid. Then poll MCP tool get_project_status with that pid every 5–8 s until data.status === "ready". Optionally call export_video for a freshly named mp4.
  5. 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 for render_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

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

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.

★ 1.6k