Документация для разработчиков публикуется на английском. Боковое меню переведено на выбранный язык.
Интеграция MCP
Подключите Claude, ChatGPT, Cursor и OpenAI Agent Builder к SubDownload через Model Context Protocol.
Обзор
Model Context Protocol (MCP) — стандартизированная платформа, позволяющая ИИ-ассистентам напрямую вызывать внешние инструменты. MCP-сервер SubDownload предоставляет 12 инструментов — включая асинхронную ИИ-транскрибацию и пер-пользовательскую Library — и поддерживает OAuth 2.1 с Dynamic Client Registration (DCR), а также статические API-ключи.
Конфигурация сервера
| Свойство | Значение |
|---|---|
| URL сервера | https://api.subdownload.com/mcp |
| Метаданные auth | /.well-known/oauth-authorization-server |
| Динамическая регистрация | POST /oauth/register |
| Авторизация | GET /oauth/authorize |
| Token | POST /oauth/token |
| Scope | mcp:access |
| Префикс токена | oat_ (OAuth) или sk_live_ (API-ключ) |
Настройка клиента
См. пошаговые руководства:
- → Claude (Desktop / Code) — OAuth с DCR, без заранее созданных учётных данных
- → ChatGPT — статический OAuth-клиент (Client ID / Secret)
- → OpenAI Agent Builder — аутентификация по API-ключу
Инструменты 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 | бесплатно | ~15 последних видео через RSS (параметр: channel). |
list_channel_videos | 1 кредит/стр. | Постраничные загрузки (параметры: channel или continuation). |
list_playlist_videos | 1 кредит/стр. | Постраничный плейлист (параметры: playlist или continuation). |
transcribe_video | 5 кредитов при done | Запускает асинхронную ИИ-транскрибацию Whisper для видео без субтитров. Возвращает task_id + next_poll_after_seconds (параметры: video_url, lang). |
get_asr_task | бесплатно | Опрос ASR-задачи; возвращает segments при status=done (параметр: task_id). |
list_library | бесплатно | Список сохранённых транскриптов и саммари пользователя (параметры: favorite, q, limit, offset). |
get_library_item | бесплатно | Чтение сохранённого элемента с inline-транскриптом и саммари (параметры: id, locale). |
save_to_library | 1 единица квоты токена | kind=asr помечает сохранённый транскрипт; kind=summary загружает саммари, сгенерированное ИИ (параметры: video_id, kind, text, locale, model…). |
Обработка ошибок
Неуспешные вызовы не списывают кредиты. Ошибки возвращают понятные сообщения, которые ИИ-ассистенты интерпретируют естественно. Полный список — в разделе Коды ошибок.