CartViral

电商AI产品视频:导入商品,生成TikTok/Reels短片,按销售赚取收益。

托管 MCP 服务器

npx add-mcp 'https://app.cartviral.com/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Connect CartViral to Claude, ChatGPT, Codex and Cursor (MCP)

CartViral has an MCP server at https://app.cartviral.com/mcp. In Claude or ChatGPT, add it once as a custom connector with that URL, sign in to CartViral and approve access (OAuth, no key to copy). In Claude Code, Codex or Cursor you can also use an API key from Claude & ChatGPT in the CartViral menu with the header Authorization: Bearer YOUR_KEY. Then ask the agent to import products, make clips, photos, a YouTube cover from your prompt and a face photo, a brand film, and give you the links. It works with your account's credits and limits. In a terminal there is also the cartviral command: one line to install, sign in in the browser, no connector setup.

Fastest: add a connector (no key)

Any client that supports MCP sign-in connects with just the URL https://app.cartviral.com/mcp: it opens a CartViral sign-in, you approve access once, and the client gets its own revocable token. The same page in the app has copy buttons and one-click installs: Claude & ChatGPT in the CartViral menu.

  • Claude (web, desktop app, phone): Settings → Customize → Connectors → + Add → Add custom connector. Name: CartViral, URL: paste the link, press Add. Then press Connect next to CartViral: a browser page opens, press Continue connecting, sign in to CartViral and press Allow. The link goes into the settings: pasting it into a chat connects nothing.
  • ChatGPT: Settings → Apps → Advanced settings → turn on Developer mode → create an app with the same URL and OAuth → approve in CartViral, then turn CartViral on in a chat. Developer mode needs a paid ChatGPT plan.
  • Claude Code: claude mcp add --transport http cartviral https://app.cartviral.com/mcp, then run /mcp and choose Authenticate.
  • Cursor and VS Code: one-click install buttons on the Claude & ChatGPT page, then sign in when asked.

Connected apps are listed on the same page, where you can disconnect them. Bonus: after your first purchase, the first time an agent connects to your account 20 credits land on your balance (once per account).

Listed in the official MCP Registry (com.cartviral/cartviral) and on Glama. Server card: app.cartviral.com/.well-known/mcp.json. Docs and manifest: github.com/artemecom/cartviral-mcp.

From a terminal: the CartViral CLI

For agents that work in a terminal (Claude Code, Codex, Cursor) and for scripts there is a command-line program. It runs the same tools as the connector, on the same account and credits, and needs no connector setup: install, sign in once in the browser, ask.

curl -fsSL https://cartviral.com/install.sh | sh    # installs the cartviral command (needs Node.js 18+)
~/.local/bin/cartviral login                         # opens CartViral in the browser: press Allow
~/.local/bin/cartviral skill install                 # teaches Claude Code to use it

In a new terminal window the short name cartviral works by itself.

Then ask your agent in plain words ("make a creator video for my product https://..."), or run it yourself:

cartviral tools                                      # everything it can do
cartviral help create_video                          # a tool's parameters
cartviral import_products https://mystore.com
cartviral generate_clips --product_id ID --clip_type ai_story --wait --out ./clips
cartviral edit_video --video ./ad.mp4 --prompt "replace the bottle with my can from the photo" --product_images ./can.jpg --wait --out ./out
  • A local image or video path is uploaded for you; --wait waits for the result and --out saves the files.
  • On a server or in CI use an API key instead of the browser: cartviral login --key YOUR_KEY or the variable CARTVIRAL_API_KEY.
  • The tool list comes from the server, so new CartViral tools appear without updating the program. Source: github.com/artemecom/cartviral-cli.

If your assistant says it can't reach CartViral

  • It can't add the connector by itself. Claude and ChatGPT only use CartViral after you add it once in their settings (steps above). Until then they can only read about it on the web.
  • Web search is off. Turn on web search in the chat, or paste https://cartviral.com/llms.txt: it describes every product and price in plain text.
  • It tried from its code sandbox. The code tool in Claude and ChatGPT has no open internet. Ask it to use the CartViral connector instead of running code.
  • A work or team account. An admin may have to allow custom connectors for the workspace first.
  • Sign-in loops. Make sure you sign in to the same CartViral account you want the agent to use, then approve the request.

What your agent can do

Everything the cabinet does. Clips, photos and other paid work spend your account's credits at the same prices; a failed job refunds itself.

ToolWhat it doesCredits
get_accountPlan, credit balance, price of each clip type0
import_products, list_productsImport a Shopify catalog (up to 750 products) or one product page from Shopify, Amazon, Etsy and most sites; catalog with CartViral score0
generate_clips, list_clipsMontage, AI story reel or creator (UGC) clip of a product, 9:16, optionally starring a brand character; status and download links1 / 6 / 12 per clip
remake_from_referenceA proven video's structure and story (hook, beats, timings) remade, with your product or without one6
generate_photos, generate_carousel, generate_static_adsAI photo sets (model, product, infographic), Instagram and TikTok carousels, static ads for Meta and TikTok7 to 9 / 3 / 4 per set
list_photo_sets, list_carousels, list_static_adsStatus and download links of the photo sets, carousels and static ads above0
get_listing_copy, get_copyMarketplace listing and SEO copy, ad copy, social captions, a creator brief, a 30-day content plan1 first time, then free
create_imageImages from your own prompt with up to 3 reference photos (a face, a product, a style): YouTube covers at 16:9, banners, scenes1 per image
create_videoA 4-10 s video from your prompt, with camera moves (dolly zoom, crane, orbit, push in, whip pan, low angle) and sound: model standard (Gemini Omni Flash, follows the action closest) or veo (Google Veo 3.1, always 8 s, a more cinematic look)2 on either
edit_videoA real video with one thing changed: the product from up to 5 photos in a hand, on the desk or instead of another object; the people, motion, camera, light and the video's own sound stay; the first 10 s are used (how it works)2
make_cinematicA 15 or 30 s brand film with a pro model, every frame a banner12 / 18
make_angles, make_talking_photoNew angles of one photo; a photo that says your text in any language1 per angle / 2 per 10 s take
reframe_video, remove_background, breakdown_videoChange a video's frame; cut-out PNG; why a viral video works (hook, beats, timings)1 / 1 / 0
copy_motionThe person from a photo repeats a reference video's movement (dance, gesture, walk), up to 15 s; only when premium video is switched onPremium, priced by length
create_character, save_character, list_charactersA recurring person for the brand: the same face in every clip2 for 2 portraits
list_creations, get_create_options, upload_mediaResults of the tools above; models and prices; store a file0
list_offers, join_offer, bring_a_brand, list_pitchesCreators: brand offers in CartViral Earn and your tracking link; pitch a brand with 3 AI clips and a page0 / 18 per pitch

Image and video arguments take any public https file link (CartViral downloads it once) or a CartViral link. Premium video models and their prices: get_create_options.

With an API key

Step 1. Create an API key

Sign in at app.cartviral.com/account/agents, name the key (for example "Claude Code") and create it. The key is shown once, with a copy button. You can revoke it on the same page.

Step 2. Add CartViral to your agent

Claude Code

claude mcp add --transport http cartviral https://app.cartviral.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Codex CLI

In ~/.codex/config.toml:

[mcp_servers.cartviral]
url = "https://app.cartviral.com/mcp"
bearer_token_env_var = "CARTVIRAL_API_KEY"

Then in your shell profile: export CARTVIRAL_API_KEY="YOUR_KEY".

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cartviral": {
      "url": "https://app.cartviral.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Desktop

Settings → Developer → Edit config, then add:

{
  "mcpServers": {
    "cartviral": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.cartviral.com/mcp",
               "--header", "Authorization: Bearer YOUR_KEY"]
    }
  }
}

Any other MCP client

Streamable HTTP transport, URL https://app.cartviral.com/mcp, header Authorization: Bearer YOUR_KEY. The same operations are a REST API: cartviral.com/api.

Step 3. Ask

  • "Import https://yourstore.com and show me the 5 products with the best CartViral score."
  • "Make 3 AI story clips of the top product and give me the download links when they're ready."
  • "Make a YouTube cover at 16:9: me from this photo looking shocked, the product in my hand, big title MY STORE MADE $10K."
  • "Create a brand character, a woman in her 20s with freckles, save the better portrait as Mia and use her in 3 creator clips."
  • "Find CartViral Earn offers that ship to the US with at least 50% commission and join the best one."

Security and limits

  • A key acts as your account: it spends your credits, with the same limits as the cabinet. Keep it private and revoke it if it leaks.
  • Up to 120 calls per minute per key; up to 10 keys per account.
  • Agents never post to social media for you: they make and fetch files, you post.
  • Connectors get OAuth tokens (PKCE, 1-hour access tokens, rotating refresh tokens) instead of your key; disconnect any app on the Claude & ChatGPT page.

FAQ

Does CartViral have an MCP server?

Yes: https://app.cartviral.com/mcp, Streamable HTTP, with OAuth sign-in for connectors or an API key. It is listed in the official MCP Registry as com.cartviral/cartviral, and its server card is at https://app.cartviral.com/.well-known/mcp.json.

Which agents work with it?

Claude (custom connector), ChatGPT (developer mode app), Claude Code, Codex CLI, Cursor, VS Code, Claude Desktop and any MCP client that supports Streamable HTTP with OAuth or a bearer token.

Can the agent make an image from my own prompt, like a YouTube cover with my face?

Yes: create_image takes your prompt and up to 3 reference photos (a face, a product, a style) and makes 1, 2 or 4 images in 9:16, 4:5, 1:1 or 16:9, 1 credit each. It is not tied to a catalog product.

Does it cost extra?

No. Tools that only read data are free; everything else is paid from your account's credits at the cabinet's prices (for example 1 for a montage, 6 for an AI story reel, 12 for a creator (UGC) clip, 1 per image). After your first purchase, the first time an agent connects to your account you get 20 bonus credits, once per account.

My assistant says it has no access to CartViral. What do I do?

Add CartViral once as a connector in the assistant's settings (Claude: Settings → Connectors; ChatGPT: Settings → Apps, developer mode) with https://app.cartviral.com/mcp. Assistants can't add connectors themselves, and their code sandboxes have no open internet.

Can the agent publish to TikTok?

No. It makes clips and returns download links; you post them yourself.

Connect CartViral to your assistant

Free account, 18 free credits, no card. Copy the link, paste it into Claude or ChatGPT.

Open Claude & ChatGPT

More guides: Best AI product video generators · Creatify alternatives · Topview alternatives · Revid alternatives · Content Rewards alternative · Trybe alternatives · Product link to TikTok video · Earn with AI product videos · n8n and Make · Shopify Collabs alternative · API · Start a Shopify affiliate program · AI video affiliate programs · Faceless affiliate with AI videos · Clipping jobs: per view vs per sale · Arcads pricing · Creatify pricing · Creatify vs Arcads · Higgsfield alternatives · Product videos from photos · Etsy listing videos · Shopify product page video · TikTok Shop product videos · TikTok Shop affiliate without followers · Get paid to post product videos · How to find clipping jobs · Remake a viral TikTok · Arcads alternatives · MakeUGC alternatives · Pippit alternatives · HeyGen alternatives · Best AI UGC ad generators · Free AI tools, no sign-up · Amazon product videos · eBay listing videos · TikTok Shop UK videos · Best AI for TikTok Shop videos · AI product photography · Commission rates by category · AI UGC vs creator UGC cost