A documentação para desenvolvedores é publicada em inglês. A navegação lateral segue o idioma escolhido.
Integração MCP
Conecte Claude, ChatGPT, Cursor e OpenAI Agent Builder ao SubDownload via Model Context Protocol.
Visão geral
Model Context Protocol (MCP) é um framework padronizado que permite que assistentes de IA chamem ferramentas externas diretamente. O servidor MCP do SubDownload expõe 12 ferramentas — incluindo transcrição por IA assíncrona e uma Library por usuário — e suporta OAuth 2.1 com Dynamic Client Registration (DCR), além de chaves de API estáticas.
Configuração do servidor
| Propriedade | Valor |
|---|---|
| URL do servidor | https://api.subdownload.com/mcp |
| Metadados de auth | /.well-known/oauth-authorization-server |
| Registro dinâmico | POST /oauth/register |
| Autorizar | GET /oauth/authorize |
| Token | POST /oauth/token |
| Scope | mcp:access |
| Prefixo do token | oat_ (OAuth) ou sk_live_ (API Key) |
Configuração do cliente
Veja os guias passo a passo:
- → Claude (Desktop / Code) — OAuth com DCR, sem credenciais pré-criadas
- → ChatGPT — cliente OAuth estático (Client ID / Secret)
- → OpenAI Agent Builder — autenticação por API Key
Ferramentas MCP
| Ferramenta | Custo | Propósito |
|---|---|---|
fetch_transcript | 1 crédito | Obter transcrição por URL/ID (parâmetros: video_url, lang). |
search_youtube | 1 crédito | Buscar vídeos ou canais (parâmetros: query, type, limit). |
resolve_channel | grátis | Resolver @handle / URL / UC… ID para info do canal (parâmetro: input). |
search_channel_videos | 1 crédito | Buscar vídeos em um canal (parâmetros: channel, query, limit). |
get_channel_latest_videos | grátis | ~15 vídeos mais recentes via RSS (parâmetro: channel). |
list_channel_videos | 1 crédito/pág. | Uploads paginados (parâmetros: channel ou continuation). |
list_playlist_videos | 1 crédito/pág. | Playlist paginada (parâmetros: playlist ou continuation). |
transcribe_video | 5 créditos em done | Inicia transcrição AI Whisper assíncrona para vídeos sem legendas. Retorna task_id + next_poll_after_seconds (parâmetros: video_url, lang). |
get_asr_task | grátis | Consulta uma tarefa ASR; retorna segments em status=done (parâmetro: task_id). |
list_library | grátis | Lista transcrições e resumos salvos do usuário (parâmetros: favorite, q, limit, offset). |
get_library_item | grátis | Lê um item salvo com transcrição + resumo inline (parâmetros: id, locale). |
save_to_library | 1 cota de token | kind=asr marca transcrição salva; kind=summary envia o resumo gerado pela IA (parâmetros: video_id, kind, text, locale, model…). |
Tratamento de erros
Chamadas com falha nunca consomem créditos. Erros retornam mensagens legíveis que assistentes de IA interpretam naturalmente. Lista completa em Códigos de erro.