अपना क्लिप वर्कफ़्लो ऑटोमेट करें: ClipMaster API और MCP सर्वर

अगर आप हर हफ़्ते वीडियो क्लिप करते हैं, तो ऐप का UI धीरे-धीरे धीमा लगने लगता है। आपको पहले से पता होता है कि कौन सा पॉडकास्ट क्लिप किया जाएगा, क्लिप किस चैनल पर जाएँगी, और उन्हें कब पब्लिश करना है — आप बस उन्हीं स्क्रीन पर क्लिक करके यह सब करते हैं। ClipMaster अब इस पूरे वर्कफ़्लो को प्रोग्रामेटिकली उपलब्ध कराता है: स्क्रिप्ट और टूल्स के लिए एक REST API, और एक MCP सर्वर जो Claude को चैट से इसे चलाने की सुविधा देता है। यह आर्टिकल बताता है कि दोनों कैसे काम करते हैं और कब किसका इस्तेमाल करना चाहिए।

एक API, दो तरीके से एक्सेस

दोनों तरीके एक ही अंतर्निहित API और एक ही अकाउंट का उपयोग करते हैं: हर कॉल आपके अपने प्रोजेक्ट्स तक सीमित होती है, ऐप के समान टोकन द्वारा मापी जाती है, और कोई अलग बिलिंग नहीं होती। प्रमाणीकरण एक API key (cm_live_…) है जिसे ऐप में Settings → API access के तहत बनाया जाता है, और यह पेड प्लान पर उपलब्ध है। यह key Authorization हेडर में जाती है, इसे किसी भी समय रद्द किया जा सकता है, और यह कभी भी अकाउंट मैनेजमेंट, बिलिंग या एडमिन फ़ंक्शन तक पहुँच प्रदान नहीं करती — वे वेब ऐप में ही रहते हैं।

• REST API स्क्रिप्ट, क्रॉन जॉब्स और आपके अपने टूल्स के लिए है — कुछ भी जहाँ आप नियत नियंत्रण चाहते हैं।
• MCP सर्वर बातचीत के माध्यम से काम करने के लिए है: आप Claude को बताते हैं कि आप क्या परिणाम चाहते हैं, और यह आपकी ओर से उसी API को कॉल करता है।

पूरा वर्कफ़्लो कवर किया गया है

"यहाँ एक वीडियो है" और "क्लिप पब्लिश होने के लिए शेड्यूल है" के बीच का सब कुछ स्क्रिप्टेबल है: URL द्वारा वीडियो इम्पोर्ट करें या फ़ाइल अपलोड करें, प्रोसेसिंग की स्थिति जाँचें, जनरेट की गई क्लिप्स को उनके AI मेटाडेटा (हुक लाइन्स, क्लिप के प्रकार, ट्रांसक्रिप्ट्स) के साथ लिस्ट करें, बाउंड्री और कैप्शन एडजस्ट करें, एडिटर सेटिंग्स सेव करें, एक्सपोर्ट रेंडर करें, कंपाइलेशन बनाएँ, और तैयार एक्सपोर्ट्स को कनेक्टेड YouTube चैनल पर शेड्यूल करें।

चार स्टेप में एक पूरा रन

एक वीडियो इम्पोर्ट करें और उसे डाउनलोड करने योग्य क्लिप तक ले जाएँ:

# 1. Import a YouTube video
curl -X POST "https://api.clipmaster.app/api/v1/upload/from-url" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_url": "https://youtube.com/watch?v=..."}'
# -> {"project_id": 123, ...}

# 2. Poll until processing completes
curl "https://api.clipmaster.app/api/v1/projects/123/status" \
  -H "Authorization: Bearer $KEY"
# -> {"status": "completed", "total_clips": 6, ...}

# 3. List the generated clips
curl "https://api.clipmaster.app/api/v1/projects/123/clips" \
  -H "Authorization: Bearer $KEY"

# 4. Export it (captions, effects, trim), then download the export
curl -X POST "https://api.clipmaster.app/api/v1/projects/123/clips/456/export" \
  -H "Authorization: Bearer $KEY"
# -> {"export_id": 37, ...}; poll /exports/37/status until "completed"
curl "https://api.clipmaster.app/api/v1/exports?clip_id=456" \
  -H "Authorization: Bearer $KEY"
# -> newest completed export's "download_url" (presigned S3, expires next 00:00 UTC)
curl -L "$DOWNLOAD_URL" -o clip.mp4

वहाँ से यही पैटर्न शेड्यूलिंग (POST /scheduled-posts) तक फैला हुआ है। उदाहरण रिक्वेस्ट और रिस्पॉन्स के साथ पूरा एंडपॉइंट रेफरेंस clipmaster.app/docs/api पर उपलब्ध है, और अगर आप इसे किसी LLM को फ़ीड कर रहे हैं तो /docs/api.md पर एक प्लेन-मार्कडाउन मिरर भी है।

या Claude को इस पर लगाएँ

MCP सर्वर API को Claude Desktop, Claude Code और किसी भी MCP क्लाइंट के लिए टूल्स के रूप में रैप करता है। सेटअप आपके API key के साथ एक कॉन्फ़िग ब्लॉक है:

{
  "mcpServers": {
    "clipmaster": {
      "command": "uvx",
      "args": ["clipmaster-mcp"],
      "env": { "CLIPMASTER_API_KEY": "cm_live_..." }
    }
  }
}

उसके बाद, वर्कफ़्लो वह सब कुछ है जिसे आप शब्दों में बयां कर सकते हैं। कुछ चीज़ें जो सिंगल रिक्वेस्ट के रूप में काम करती हैं:

• "इस एपिसोड को इम्पोर्ट करो और मुझे बताओ कि यह कब पूरा हो गया।"
• "किस क्लिप में सबसे मज़बूत हुक है? मुझे उसका ट्रांसक्रिप्ट दिखाओ।"
• "शीर्ष दो क्लिप्स को रेंडर करो और उन्हें शुक्रवार शाम 5 बजे मेरे चैनल पर शेड्यूल करो।"
• "इस हफ़्ते पब्लिश होने के लिए पहले से क्या कतार में है?"

स्क्रिप्ट से अंतर निर्णय का है: Claude क्लिप मेटाडेटा — हुक्स, प्रकार, ट्रांसक्रिप्ट्स — को पढ़ता है और वह चुनाव करता है जो आप अन्यथा अपनी आँखों से करते। आपका MCP क्लाइंट महत्वपूर्ण टूल कॉल्स से पहले पूछता है, और शेड्यूल किया गया कुछ भी ऐप के कैलेंडर में दिखाई देता है, जहाँ इसे किसी भी अन्य पोस्ट की तरह रीटाइम या रद्द किया जा सकता है। सेटअप गाइड: clipmaster.app/docs/mcp।

व्यावहारिक विवरण

• लागत ऐप के समान है। 1 टोकन = प्रोसेसिंग के लिए 1 स्रोत मिनट; एक्सपोर्ट्स पर ऐप के नियमों के अनुसार शुल्क लगता है। एक API कॉल का कभी अतिरिक्त शुल्क नहीं लगता।
• Keys रद्द करने योग्य और रेट-लिमिटेड हैं। प्रति key 120 रिक्वेस्ट/मिनट; Settings में key को रद्द करने से वह तुरंत निष्क्रिय हो जाती है।
• जहाँ ज़रूरी हो वहाँ रिट्राई सुरक्षित हैं। एक ही एक्सपोर्ट को एक ही स्लॉट में दो बार शेड्यूल करने पर डबल-पब्लिशिंग के बजाय मौजूदा पोस्ट वापस आ जाती है।
• चैनल कनेक्शन एक बार, ऐप में होते हैं। API और MCP कनेक्टेड चैनल पर शेड्यूल कर सकते हैं लेकिन OAuth कनेक्ट खुद कभी नहीं करते।

अगर आपकी क्लिपिंग रूटीन पहले से ही अनुमानित है, तो उस पर क्लिक करना बंद करें। अनुमानित हिस्से को स्क्रिप्ट करें, या इसे Claude को सौंप दें — और अपना समय रिकॉर्डिंग पर खर्च करें।