CLI
เครื่องมือบรรทัดคำสั่งสำหรับดาวน์โหลดวิดีโอ X (Twitter) และขั้นตอนยืนยันตัวตนที่เซิร์ฟเวอร์ MCP ใช้
การติดตั้ง
ต้องใช้ Node.js >= 24 ไม่ต้องติดตั้งแบบ global — รันด้วย npx ได้ทันที หรือติดตั้งแบบ global:
npm install -g @roudanio/x-downloader-cliต้องมี yt-dlp ใน PATH สำหรับการดาวน์โหลดโดยตรง และ ffmpeg ด้วย เว้นแต่จะใช้ -f best หากใช้เพียงเซิร์ฟเวอร์ MCP หรือคำสั่ง auth ไม่จำเป็นต้องมีทั้งสองอย่าง
เริ่มต้นใช้งาน
การดาวน์โหลดโดยตรงใช้ yt-dlp บนเครื่องของคุณ — ไม่ต้องมีบัญชี:
x-downloader https://x.com/user/status/123456789ตัวเลือกการดาวน์โหลด
| -o, --output <dir> | โฟลเดอร์ปลายทาง (ค่าเริ่มต้น ~/Downloads) |
| -n, --filename <name> | กำหนดชื่อไฟล์ปลายทางเอง |
| -f, --format <format> | ตัวเลือกฟอร์แมตของ yt-dlp (ค่าเริ่มต้น bestvideo*+bestaudio/best) |
| -F, --list-formats | แสดงฟอร์แมตที่มีแล้วออก |
| --cookies <file> | ไฟล์คุกกี้ที่ส่งต่อให้ yt-dlp |
| --proxy <url> | URL พร็อกซีที่ส่งต่อให้ yt-dlp |
| --dry-run | พิมพ์คำสั่ง yt-dlp ที่ได้แทนการรันจริง |
การยืนยันตัวตน
auth login / auth logout / auth status ใช้จัดการ token การอนุญาตอุปกรณ์ที่เซิร์ฟเวอร์ MCP (x-downloader-mcp) ใช้เรียก API ของเว็บไซต์ คำสั่งดาวน์โหลดโดยตรงด้านบนไม่เคยใช้ token นี้และไม่เคยเรียกเว็บไซต์
รหัสการออก
| 0 | สำเร็จ |
| 1 | ข้อผิดพลาดทั่วไป (อาร์กิวเมนต์ไม่ถูกต้อง, ยืนยันตัวตนล้มเหลว, yt-dlp จบด้วยข้อผิดพลาด) |
| 2 | ขาดโปรแกรมที่จำเป็น (ไม่พบ yt-dlp หรือไม่มี ffmpeg สำหรับฟอร์แมตเริ่มต้น) |
| other | ส่งต่อมาจากโปรเซส yt-dlp โดยตรง |
เอาต์พุตที่เครื่องอ่านได้
ยังไม่รองรับสำหรับการดาวน์โหลดโดยตรง — เอาต์พุตเป็นข้อความธรรมดา หากต้องการผลลัพธ์แบบมีโครงสร้าง ให้ใช้เซิร์ฟเวอร์ MCP หรือ REST API โดยตรง