เซิร์ฟเวอร์ MCP
เซิร์ฟเวอร์ Model Context Protocol ที่ให้เอเจนต์ AI ดาวน์โหลดวิดีโอ X (Twitter) แทนคุณ
การติดตั้ง
เพิ่มโค้ดนี้ลงในการตั้งค่าไคลเอนต์ MCP ของคุณ (Claude Desktop, Claude Code, Cursor หรือเครื่องมือใดก็ได้ที่รองรับ MCP):
{
"mcpServers": {
"x-downloader": {
"command": "npx",
"args": ["-p", "@roudanio/x-downloader-cli", "x-downloader-mcp"]
}
}
}การยืนยันตัวตน
รันคำสั่งนี้หนึ่งครั้งก่อน — ระบบจะเปิดขั้นตอนการอนุญาตอุปกรณ์ในเบราว์เซอร์ และบันทึก bearer token ไว้ที่ ~/.x-downloader/config.json เซิร์ฟเวอร์ MCP จะอ่าน token เดียวกันนี้
npx -p @roudanio/x-downloader-cli x-downloader auth loginการส่งข้อมูล
ใช้ stdio เท่านั้น — ไม่มีโปรเซสเซิร์ฟเวอร์แยกหรือพอร์ตเครือข่าย เซิร์ฟเวอร์จะเรียก REST API ของ xvideodownloader.org ผ่าน HTTPS ด้วย token ที่คุณบันทึกไว้
เครื่องมือ
download_videoส่ง URL โพสต์ X/Twitter เพื่อดาวน์โหลด การกำหนดชื่อไฟล์และฟอร์แมตเองต้องใช้ SVIP
check_statusตรวจสอบงานดาวน์โหลดตาม id ทำซ้ำจนกว่าสถานะจะเป็น "done"
get_download_urlรับ URL สำหรับดาวน์โหลดไฟล์ของงานที่เสร็จแล้ว
list_downloadsแสดงประวัติการดาวน์โหลดล่าสุดของคุณ ต้องยืนยันตัวตน
check_usageตรวจสอบการใช้งานวันนี้เทียบกับขีดจำกัดรายวันของแพ็กเกจ
ขีดจำกัดการใช้งาน
การดาวน์โหลดผ่านเซิร์ฟเวอร์ MCP นับรวมในขีดจำกัดรายวันฟรี/SVIP เดียวกับเว็บไซต์ — แพ็กเกจฟรีวันละ 2 ครั้ง ส่วน SVIP ตลอดชีพไม่จำกัด
ข้อผิดพลาดที่พบบ่อย
RATE_LIMIT (ถึงขีดจำกัดรายวัน), UNSUPPORTED_HOST (รองรับเฉพาะ URL x.com/twitter.com), EMPTY_URL / INVALID_URL_FORMAT (ข้อมูลไม่ถูกต้อง) เครื่องมือจะส่งค่าเหล่านี้กลับเป็นข้อความ JSON ธรรมดาในผลลัพธ์ — ให้ตรวจสอบฟิลด์ error หรือ code