MCP-Server

Model-Context-Protocol-Server, mit dem ein KI-Agent X-(Twitter-)Videos für Sie herunterladen kann.

Installation

Fügen Sie dies in die Konfiguration Ihres MCP-Clients ein (Claude Desktop, Claude Code, Cursor oder ein anderes MCP-kompatibles Tool):

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

Authentifizierung

Führen Sie dies zuerst einmal aus – es startet im Browser eine Geräte-Autorisierung und speichert ein Bearer-Token in ~/.x-downloader/config.json. Der MCP-Server liest dasselbe Token.

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

Transport

Nur stdio – kein separater Serverprozess und kein Netzwerkport. Der Server spricht mit Ihrem gespeicherten Token über HTTPS mit der REST API von xvideodownloader.org.

Tools

download_video

Eine X-/Twitter-Beitrags-URL zum Download einreichen. Eigener Dateiname und eigenes Format erfordern SVIP.

check_status

Eine Download-Aufgabe per ID abfragen. Wiederholen, bis der Status "done" ist.

get_download_url

Die Download-URL der Datei für eine abgeschlossene Aufgabe abrufen.

list_downloads

Ihren letzten Download-Verlauf auflisten. Erfordert Authentifizierung.

check_usage

Die heutige Nutzung mit dem täglichen Download-Limit Ihres Tarifs vergleichen.

Rate Limits

Downloads über den MCP-Server zählen gegen dieselben täglichen Free-/SVIP-Limits wie auf der Website – 2 pro Tag im Gratis-Tarif, unbegrenzt mit lebenslangem SVIP.

Häufige Fehler

RATE_LIMIT (Tageslimit erreicht), UNSUPPORTED_HOST (nur x.com/twitter.com-URLs), EMPTY_URL / INVALID_URL_FORMAT (ungültige Eingabe). Die Tools liefern diese als einfachen JSON-Text im Ergebnis zurück – prüfen Sie das Feld error oder code.