Servidor MCP

Servidor Model Context Protocol para que un agente de IA descargue videos de X (Twitter) por ti.

Instalación

Añade esto a la configuración de tu cliente MCP (Claude Desktop, Claude Code, Cursor o cualquier herramienta compatible con MCP):

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

Autenticación

Ejecuta esto una vez primero: abre un flujo de autorización de dispositivo en tu navegador y guarda un token bearer en ~/.x-downloader/config.json. El servidor MCP lee ese mismo token.

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

Transporte

Solo stdio: sin proceso de servidor aparte ni puerto de red. El servidor se comunica por HTTPS con la API REST de xvideodownloader.org usando tu token guardado.

Herramientas

download_video

Envía la URL de una publicación de X/Twitter para descargarla. Cambiar el nombre de archivo o el formato requiere SVIP.

check_status

Consulta una tarea de descarga por id. Repite hasta que el estado sea "done".

get_download_url

Obtiene la URL de descarga del archivo de una tarea completada.

list_downloads

Lista tu historial de descargas reciente. Requiere autenticación.

check_usage

Compara el uso de hoy con el límite diario de descargas de tu plan.

Límites de uso

Las descargas hechas a través del servidor MCP cuentan para los mismos límites diarios gratuitos/SVIP que el sitio web: 2 al día en el plan gratuito, ilimitadas con SVIP de por vida.

Errores comunes

RATE_LIMIT (límite diario alcanzado), UNSUPPORTED_HOST (solo URLs de x.com/twitter.com), EMPTY_URL / INVALID_URL_FORMAT (entrada no válida). Las herramientas los devuelven como texto JSON simple en el resultado: revisa el campo error o code.