Serveur MCP

Serveur Model Context Protocol permettant à un agent IA de télécharger des vidéos X (Twitter) pour vous.

Installation

Ajoutez ceci à la configuration de votre client MCP (Claude Desktop, Claude Code, Cursor ou tout outil compatible MCP) :

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

Authentification

Exécutez d'abord ceci une fois : un flux d'autorisation par appareil s'ouvre dans votre navigateur et un jeton bearer est enregistré dans ~/.x-downloader/config.json. Le serveur MCP lit ce même jeton.

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

Transport

stdio uniquement — aucun processus serveur séparé ni port réseau. Le serveur communique en HTTPS avec l'API REST de xvideodownloader.org à l'aide de votre jeton enregistré.

Outils

download_video

Soumettre l'URL d'une publication X/Twitter à télécharger. Les options de nom de fichier et de format nécessitent SVIP.

check_status

Interroger une tâche de téléchargement par son id. Répéter jusqu'à ce que le statut soit "done".

get_download_url

Obtenir l'URL de téléchargement du fichier d'une tâche terminée.

list_downloads

Lister votre historique de téléchargements récent. Authentification requise.

check_usage

Comparer l'utilisation du jour à la limite quotidienne de votre formule.

Limites de débit

Les téléchargements via le serveur MCP comptent dans les mêmes limites quotidiennes gratuites/SVIP que le site — 2 par jour en formule gratuite, illimités avec SVIP à vie.

Erreurs courantes

RATE_LIMIT (limite quotidienne atteinte), UNSUPPORTED_HOST (URL x.com/twitter.com uniquement), EMPTY_URL / INVALID_URL_FORMAT (entrée invalide). Les outils les renvoient sous forme de texte JSON brut dans le résultat — vérifiez le champ error ou code.