Servidor MCP

Servidor Model Context Protocol para que um agente de IA baixe vídeos do X (Twitter) por você.

Instalação

Adicione isto à configuração do seu cliente MCP (Claude Desktop, Claude Code, Cursor ou qualquer ferramenta compatível com MCP):

{
  "mcpServers": {
    "x-downloader": {
      "command": "npx",
      "args": ["-p", "@roudanio/x-downloader-cli", "x-downloader-mcp"]
    }
  }
}

Autenticação

Execute isto uma vez antes — abre um fluxo de autorização de dispositivo no navegador e salva um token bearer em ~/.x-downloader/config.json. O servidor MCP lê esse mesmo token.

npx -p @roudanio/x-downloader-cli x-downloader auth login

Transporte

Somente stdio — sem processo de servidor separado nem porta de rede. O servidor se comunica via HTTPS com a API REST do xvideodownloader.org usando o seu token salvo.

Ferramentas

download_video

Envia a URL de um post do X/Twitter para download. Nome de arquivo e formato personalizados exigem SVIP.

check_status

Consulta uma tarefa de download pelo id. Repita até o status ser "done".

get_download_url

Obtém a URL de download do arquivo de uma tarefa concluída.

list_downloads

Lista seu histórico recente de downloads. Requer autenticação.

check_usage

Compara o uso de hoje com o limite diário de downloads do seu plano.

Limites de uso

Downloads feitos pelo servidor MCP contam nos mesmos limites diários grátis/SVIP do site — 2 por dia no plano grátis, ilimitados com SVIP vitalício.

Erros comuns

RATE_LIMIT (limite diário atingido), UNSUPPORTED_HOST (apenas URLs x.com/twitter.com), EMPTY_URL / INVALID_URL_FORMAT (entrada inválida). As ferramentas retornam esses erros como texto JSON simples no resultado — verifique o campo error ou code.