डेवलपर दस्तावेज़ अंग्रेज़ी में प्रकाशित हैं। साइडबार आपकी चुनी हुई भाषा का अनुसरण करता है।
MCP इंटिग्रेशन
Model Context Protocol के ज़रिए Claude, ChatGPT, Cursor और OpenAI Agent Builder को SubDownload से जोड़ें।
संक्षिप्त विवरण
Model Context Protocol (MCP) एक मानकीकृत फ़्रेमवर्क है जो AI असिस्टेंट्स को बाहरी टूल्स सीधे कॉल करने देता है। SubDownload का MCP सर्वर 12 टूल्स एक्सपोज़ करता है — असिंक्रोनस AI ट्रांसक्रिप्शन और प्रति-उपयोगकर्ता Library सहित — और Dynamic Client Registration (DCR) के साथ OAuth 2.1, साथ ही स्टैटिक API Key दोनों सपोर्ट करता है।
सर्वर कॉन्फ़िगरेशन
| प्रॉपर्टी | मान |
|---|---|
| सर्वर URL | https://api.subdownload.com/mcp |
| ऑथ मेटाडेटा | /.well-known/oauth-authorization-server |
| डायनेमिक रजिस्ट्रेशन | POST /oauth/register |
| ऑथराइज़ | GET /oauth/authorize |
| टोकन | POST /oauth/token |
| Scope | mcp:access |
| टोकन प्रीफ़िक्स | oat_ (OAuth) या sk_live_ (API Key) |
क्लाइंट सेटअप
क्लाइंट-वार स्टेप-बाय-स्टेप गाइड देखें:
- → Claude (Desktop / Code) — DCR के साथ OAuth, पहले से बनाई गई क्रेडेंशियल की ज़रूरत नहीं
- → ChatGPT — स्टैटिक OAuth क्लाइंट (Client ID / Secret)
- → OpenAI Agent Builder — API Key ऑथेंटिकेशन
MCP टूल्स
| टूल | लागत | उद्देश्य |
|---|---|---|
fetch_transcript | 1 क्रेडिट | URL/ID से ट्रांसक्रिप्ट प्राप्त करें (पैरामीटर: video_url, lang)। |
search_youtube | 1 क्रेडिट | वीडियो या चैनल खोजें (पैरामीटर: query, type, limit)। |
resolve_channel | मुफ़्त | @handle / URL / UC… ID को चैनल जानकारी में बदलें (पैरामीटर: input)। |
search_channel_videos | 1 क्रेडिट | किसी चैनल के वीडियो में खोजें (पैरामीटर: channel, query, limit)। |
get_channel_latest_videos | मुफ़्त | RSS से नवीनतम ~15 वीडियो (पैरामीटर: channel)। |
list_channel_videos | 1 क्रेडिट/पेज | पेज़ेटेड अपलोड (पैरामीटर: channel या continuation)। |
list_playlist_videos | 1 क्रेडिट/पेज | पेज़ेटेड प्लेलिस्ट (पैरामीटर: playlist या continuation)। |
transcribe_video | done पर 5 क्रेडिट | कैप्शन-रहित वीडियो के लिए असिंक्रोनस AI Whisper ट्रांसक्रिप्शन शुरू करता है। task_id + next_poll_after_seconds देता है (पैरामीटर: video_url, lang)। |
get_asr_task | मुफ्त | ASR टास्क पोल करता है; status=done पर segments देता है (पैरामीटर: task_id)। |
list_library | मुफ्त | उपयोगकर्ता के सेव्ड ट्रांसक्रिप्ट और सारांश (पैरामीटर: favorite, q, limit, offset)। |
get_library_item | मुफ्त | सेव्ड आइटम इनलाइन ट्रांसक्रिप्ट + सारांश के साथ पढ़ें (पैरामीटर: id, locale)। |
save_to_library | 1 टोकन कोटा | kind=asr सेव्ड ट्रांसक्रिप्ट मार्क करता है; kind=summary AI जनरेटेड सारांश अपलोड करता है (पैरामीटर: video_id, kind, text, locale, model…)। |
एरर हैंडलिंग
असफल कॉल से कभी क्रेडिट नहीं कटते। एरर यूज़र-फ्रेंडली मैसेज लौटाते हैं जिन्हें AI असिस्टेंट स्वाभाविक रूप से समझते हैं। पूरी सूची एरर कोड में देखें।