CartViral
AI product videos for e-commerce: import products, generate TikTok/Reels clips, earn per sale.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http cartviral 'https://app.cartviral.com/mcp'
{
"mcpServers": {
"cartviral": {
"type": "http",
"url": "https://app.cartviral.com/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
CartViral MCP Server
AI product videos for e-commerce, from any AI agent. CartViral turns a product page into ready-to-post TikTok, Reels and Shorts clips. This hosted MCP server lets Claude, ChatGPT, Codex, Cursor and other agents import products, generate clips, fetch download links, browse brand affiliate offers and pitch brands.
- Endpoint:
https://app.cartviral.com/mcp(Streamable HTTP, hosted, nothing to install) - Auth: OAuth 2.1 (dynamic client registration, PKCE) or an API key
- Registry:
com.cartviral/cartviralin the official MCP Registry - Docs: https://cartviral.com/mcp
- Smithery: https://smithery.ai/servers/mercury-promotion/CartViral_mcp
- Price: free account with 18 credits (3 AI clips), no card; read-only tools cost nothing. After your first purchase, the first agent connection adds 20 bonus credits (once per account)
- Clips: photo montages, AI story reels and creator (UGC) clips where an AI creator talks to camera in their own voice, all vertical 9:16 and built from your real product photos
Connect
Claude (web and desktop)
Settings → Connectors → Add custom connector → paste https://app.cartviral.com/mcp → Connect. Sign in to CartViral and approve access.
ChatGPT
Add a custom connector (developer mode) with the URL https://app.cartviral.com/mcp and OAuth authentication.
Claude Code
claude mcp add --transport http cartviral https://app.cartviral.com/mcp
# then run /mcp inside Claude Code and choose Authenticate
Or with an API key:
claude mcp add --transport http cartviral https://app.cartviral.com/mcp \
--header "Authorization: Bearer YOUR_KEY"
Codex CLI
~/.codex/config.toml:
[mcp_servers.cartviral]
url = "https://app.cartviral.com/mcp"
bearer_token_env_var = "CARTVIRAL_API_KEY"
Cursor
~/.cursor/mcp.json:
{
"mcpServers": {
"cartviral": {
"url": "https://app.cartviral.com/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
Any other client
Streamable HTTP, URL https://app.cartviral.com/mcp. Either let the client run the OAuth flow (discovery at /.well-known/oauth-protected-resource/mcp), or send Authorization: Bearer YOUR_KEY (or x-api-key: YOUR_KEY). Create keys at https://app.cartviral.com/account/agents.
Tools
| Tool | What it does | Credits |
|---|---|---|
get_account | Plan, credit balance, price of each clip type | 0 |
import_products | Import a Shopify catalog (up to 750 products) or one product page from Shopify, Amazon, Etsy and most sites | 0 |
list_products | Catalog with CartViral score (push / hold) | 0 |
generate_clips | Montage, AI story reel or creator (UGC) clip of a product, 9:16. clip_type: montage, ai_story, avatar (the creator clip); ad is kept for older integrations and makes the same AI clip as ai_story | 1 / 6 / 12 per clip (ad: 6) |
list_clips | Render status and download links (valid 24 hours) | 0 |
list_offers, join_offer | Creators: brand offers in CartViral Earn and your tracking link | 0 |
bring_a_brand, list_pitches | 3 AI clips of a brand's product and a page to send it; who opened it | 18 per pitch |
Every tool declares readOnlyHint, destructiveHint and openWorldHint.
Example prompts
- "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."
- "Find CartViral Earn offers that ship to the US with at least 20% commission and join the best one."
- "Pitch these Shopify brands: [links]. Tomorrow, tell me which ones opened the page."
Security
- OAuth tokens are opaque and stored hashed; access tokens last 1 hour, refresh tokens rotate on every use. Disconnect any app in Account → AI agents.
- A token or key acts as your account (same credits and limits as the web app). Up to 120 calls per minute per key.
- Agents never post to social media for you: they make and fetch clips, you post.
Support
support@cartviral.com · https://cartviral.com
الأسئلة الشائعة
ما هو CartViral؟
AI product videos for e-commerce: import products, generate TikTok/Reels clips, earn per sale.
كيف أثبّت CartViral؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http cartviral 'https://app.cartviral.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج CartViral إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل CartViral مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون CartViral؟
ينشره artemecom. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.