Oxylabs

Oxylabs MCP Server

ลิงก์ที่ขาดหายไประหว่างโมเดล AI กับเว็บในโลกจริง: API เดียวที่ส่งมอบข้อมูลที่สะอาดและมีโครงสร้างจากทุกเว็บไซต์

---

ข้อจำกัดความรับผิดชอบ

ที่เก็บนี้ยังคงได้รับการสนับสนุนอย่างเต็มที่ แต่หากคุณใช้ Oxylabs Web API โปรดดูที่ที่เก็บ Web API MCP: Web API MCP

📖 ภาพรวม

เซิร์ฟเวอร์ Oxylabs MCP ทำหน้าที่เป็นสะพานเชื่อมระหว่างโมเดล AI กับเว็บ ช่วยให้โมเดลสามารถดึงข้อมูลจาก URL ใดก็ได้ แสดงผลหน้าเว็บที่ใช้ JavaScript จำนวนมาก แยกและจัดรูปแบบเนื้อหาเพื่อให้ AI ใช้งาน จัดการ CAPTCHA และเข้าถึงข้อมูลเว็บที่จำกัดตามภูมิภาคจากกว่า 195 ประเทศ

สร้างขึ้นบน Model Context Protocol (MCP) ซึ่งเป็นมาตรฐานเปิดสำหรับเชื่อมต่อผู้ช่วย AI กับเครื่องมือและข้อมูลภายนอก

mcp-name: io.oxylabs/oxylabs-mcp

🛠️ เครื่องมือ MCP

Oxylabs MCP มีเครื่องมือสองชุดที่ใช้ร่วมกันหรือแยกกันได้:

เครื่องมือ Oxylabs Web Scraper API

1. universal_scraper: ดึงข้อมูลจาก URL ใดก็ได้ พร้อมตัวเลือกแสดงผล JavaScript กำหนดเป้าหมายตามภูมิภาค และส่งออกเป็น Markdown/HTML/ลิงก์
2. google_search_scraper: ดึงผลลัพธ์จาก Google Search พร้อมตัวเลือกแยกวิเคราะห์เป็น JSON ที่มีโครงสร้าง
3. amazon_search_scraper: ดึงข้อมูลหน้าผลการค้นหาของ Amazon พร้อมตัวเลือกแยกวิเคราะห์เป็น JSON ที่มีโครงสร้าง
4. amazon_product_scraper: แยกข้อมูลจากหน้าผลิตภัณฑ์ Amazon แต่ละหน้า

เครื่องมือ Oxylabs AI Studio

5. ai_scraper: ดึงเนื้อหาจาก URL ใดก็ได้ด้วยการแยกข้อมูลที่ขับเคลื่อนด้วย AI ในรูปแบบ JSON, CSV, Markdown หรือ TOON
6. ai_crawler: รวบรวมข้อมูลจากเว็บไซต์โดยเริ่มต้นที่ URL และทำตามพรอมป์ต์ พร้อมเก็บข้อมูลจากหลายหน้า
7. ai_browser_agent: ควบคุมเบราว์เซอร์จริงตามพรอมป์ต์ — ไปยังหน้าเว็บ คลิก กรอกแบบฟอร์ม — และส่งคืนผลลัพธ์
8. ai_search: ค้นหาเว็บและเลือกส่งคืนเนื้อหา Markdown ของผลการค้นหาแต่ละรายการได้
9. ai_map: ทำแผนที่ URL ของเว็บไซต์ โดยกรองตามคีย์เวิร์ดหรือพรอมป์ต์
10. generate_schema: สร้าง JSON schema รูปแบบ OpenAPI สำหรับการแยกข้อมูลแบบมีโครงสร้างด้วยเครื่องมือ AI ข้างต้น

✅ ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมีอย่างน้อยหนึ่งรายการต่อไปนี้:

• บัญชี Oxylabs Web Scraper API: รับ API token (หรือชื่อผู้ใช้และรหัสผ่าน) จาก แดชบอร์ด Oxylabs (ทดลองใช้ฟรี 1 สัปดาห์)
• คีย์ Oxylabs AI Studio API: รับ API key จาก Oxylabs AI Studio (รับเครดิตฟรี 1000 เครดิต)

หากต้องการเรียกใช้เซิร์ฟเวอร์ในเครื่อง (ตัวเลือกที่ 2 ด้านล่าง) คุณจะต้องมีตัวจัดการแพ็กเกจ uv ด้วย:

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

📦 การกำหนดค่า

มีสองวิธีในการใช้เซิร์ฟเวอร์: เชื่อมต่อกับ อินสแตนซ์ที่โฮสต์ไว้ (ไม่ต้องติดตั้ง) หรือ เรียกใช้ในเครื่อง โดยกำหนดข้อมูลรับรองในตัวแปรสภาพแวดล้อม

ตัวเลือกที่ 1: เซิร์ฟเวอร์ที่โฮสต์ไว้ (ไม่ต้องติดตั้ง)

Oxylabs ให้บริการเซิร์ฟเวอร์ MCP ที่โฮสต์ไว้ที่:

https://mcp.oxylabs.io/mcp

ส่งข้อมูลรับรองผ่านส่วนหัวของคำขอ:

ข้อมูลรับรอง	ส่วนหัว
Web Scraper API token (แนะนำ)	Authorization: Bearer <token>
Web Scraper API token (ทางเลือก)	X-Oxylabs-Api-Token
ชื่อผู้ใช้และรหัสผ่าน Web Scraper API	Authorization: Basic <base64(username:password)>
ชื่อผู้ใช้และรหัสผ่าน Web Scraper API (ทางเลือก)	X-Oxylabs-Username และ X-Oxylabs-Password
AI Studio	X-Oxylabs-AI-Studio-Api-Key

หากส่งทั้ง API token และชื่อผู้ใช้กับรหัสผ่าน ระบบจะใช้ token

ตั้งค่าด้วย Claude Code:

claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN" \
  --header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"

ตั้งค่าด้วย Cursor หรือไคลเอนต์ใดก็ตามที่รองรับเซิร์ฟเวอร์ MCP ระยะไกลพร้อมส่วนหัวแบบกำหนดเอง:

{
  "mcpServers": {
    "oxylabs": {
      "url": "https://mcp.oxylabs.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN",
        "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

เซิร์ฟเวอร์นี้ยังอยู่ในรายการของ Smithery ด้วย

หมายเหตุ: ไคลเอนต์ที่รองรับเฉพาะ OAuth สำหรับเซิร์ฟเวอร์ระยะไกล (เช่น การเพิ่มตัวเชื่อมต่อแบบกำหนดเองใน UI เว็บ claude.ai) ยังไม่สามารถส่งส่วนหัวได้ — การลงชื่อเข้าใช้ด้วย OAuth อยู่ในแผนงานของเรา ระหว่างนี้ ให้ใช้การตั้งค่าในเครื่องด้านล่างกับไคลเอนต์เหล่านั้น

ตัวเลือกที่ 2: เรียกใช้ในเครื่อง

ตัวแปรสภาพแวดล้อม

เซิร์ฟเวอร์ Oxylabs MCP รองรับตัวแปรสภาพแวดล้อมต่อไปนี้:

ชื่อ	คำอธิบาย	ค่าเริ่มต้น
OXYLABS_API_TOKEN	Oxylabs Web Scraper API token ของคุณ
OXYLABS_USERNAME	ชื่อผู้ใช้ Oxylabs Web Scraper API ของคุณ
OXYLABS_PASSWORD	รหัสผ่าน Oxylabs Web Scraper API ของคุณ
OXYLABS_AI_STUDIO_API_KEY	คีย์ Oxylabs AI Studio API ของคุณ
LOG_LEVEL	ระดับบันทึกสำหรับล็อกที่ส่งคืนให้ไคลเอนต์	INFO

สำหรับเครื่องมือ Web Scraper API ให้กำหนด OXYLABS_API_TOKEN หรือกำหนดทั้ง OXYLABS_USERNAME และ OXYLABS_PASSWORD หากกำหนดทั้งสองแบบ ระบบจะใช้ token สำหรับเครื่องมือ AI Studio ให้กำหนด OXYLABS_AI_STUDIO_API_KEY

ระบบจะแสดงรายการเครื่องมือทั้งหมดเสมอ การเรียกใช้เครื่องมือโดยไม่มีข้อมูลรับรองที่จำเป็นจะแสดงข้อความ แจ้งข้อผิดพลาดพร้อมอธิบายสิ่งที่ต้องกำหนดค่า

❗ สำคัญ: กำหนดเฉพาะตัวแปรสภาพแวดล้อมที่คุณมีข้อมูลรับรองจริงเท่านั้น ค่าตัวอย่างจะทำให้การเรียกใช้เครื่องมือล้มเหลว

กำหนดค่าด้วย uvx

ติดตั้ง แพ็กเกจจาก PyPI และเรียกใช้โดยอัตโนมัติ:

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_API_TOKEN": "YOUR_API_TOKEN",
        "OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

กำหนดค่าด้วยโคลนในเครื่อง

เหมาะสำหรับการพัฒนา — เรียกใช้เซิร์ฟเวอร์จากโคลนในเครื่องของที่เก็บนี้:

{
  "mcpServers": {
    "oxylabs": {
      "command": "uv",
      "args": [
        "--directory",
        "/<absolute-path-to-folder>/oxylabs-mcp",
        "run",
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_API_TOKEN": "YOUR_API_TOKEN",
        "OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

เรียกใช้เป็นเซิร์ฟเวอร์ HTTP ระยะไกล (โฮสต์เอง)

เซิร์ฟเวอร์ยังรองรับการขนส่ง MCP แบบ streamable-HTTP เริ่มต้นด้วยคำสั่ง:

MCP_TRANSPORT=streamable-http MCP_HOST=0.0.0.0 MCP_PORT=8000 uvx oxylabs-mcp

เมื่อใช้การขนส่ง HTTP จะส่งข้อมูลรับรองในแต่ละคำขอแทนการใช้ตัวแปรสภาพแวดล้อม:

ข้อมูลรับรอง	วิธีส่ง
Web Scraper API token (แนะนำ)	Authorization: Bearer <token>
Web Scraper API token (ทางเลือก)	ส่วนหัว X-Oxylabs-Api-Token
ชื่อผู้ใช้และรหัสผ่าน Web Scraper API	Authorization: Basic <base64(username:password)> (การยืนยันตัวตน HTTP Basic)
ชื่อผู้ใช้และรหัสผ่าน Web Scraper API (ทางเลือก)	ส่วนหัว X-Oxylabs-Username และ X-Oxylabs-Password
AI Studio	ส่วนหัว X-Oxylabs-AI-Studio-Api-Key

ตัวอย่างการกำหนดค่าไคลเอนต์:

{
  "mcpServers": {
    "oxylabs": {
      "url": "https://your-host:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN",
        "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

ระบบจะแสดงรายการเครื่องมือทั้งหมดเสมอ ไม่ว่าจะมีข้อมูลรับรองใดให้ใช้ก็ตาม การเรียกใช้เครื่องมือโดยไม่มี ข้อมูลรับรองที่จำเป็นจะแสดงข้อความแจ้งข้อผิดพลาดพร้อมอธิบายสิ่งที่ต้องกำหนดค่าอย่างชัดเจน

ตั้งค่าด้วย Claude Desktop

ไปที่ Claude → Settings → Developer → Edit Config แล้วเพิ่มการกำหนดค่าใดการกำหนดค่าหนึ่งข้างต้นลงในไฟล์ claude_desktop_config.json

ตั้งค่าด้วย Cursor AI

ไปที่ Cursor → Settings → Cursor Settings → MCP คลิก Add new global MCP server แล้วเพิ่มการกำหนดค่าใดการกำหนดค่าหนึ่งข้างต้น

📝 การบันทึกล็อก

เซิร์ฟเวอร์ให้ข้อมูลเพิ่มเติมเกี่ยวกับการเรียกใช้เครื่องมือในเหตุการณ์ notification/message:

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "Create job with params: {\"url\": \"https://ip.oxylabs.io\"}"
  }
}

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "Job info: job_id=7333113830223918081 job_status=done"
  }
}

{
  "method": "notifications/message",
  "params": {
    "level": "error",
    "data": "Error: request to Oxylabs API failed"
  }
}

✨ คุณสมบัติเด่น

ดึงเนื้อหาจากทุกเว็บไซต์

• แยกข้อมูลจาก URL ใดก็ได้ รวมถึงแอปพลิเคชันหน้าเดียวที่ซับซ้อน
• แสดงผลเว็บไซต์แบบไดนามิกได้อย่างครบถ้วนด้วยการรองรับเบราว์เซอร์แบบ headless
• เลือกการแสดงผล JavaScript แบบเต็ม แสดงเฉพาะ HTML หรือไม่แสดงผลก็ได้
• จำลองวิวพอร์ตบนมือถือและเดสก์ท็อปเพื่อการแสดงผลที่สมจริง

รับข้อมูลที่พร้อมใช้กับ AI โดยอัตโนมัติ

• ทำความสะอาดและแปลง HTML เป็น Markdown โดยอัตโนมัติเพื่อให้อ่านง่ายขึ้น
• ใช้ตัวแยกวิเคราะห์อัตโนมัติสำหรับเป้าหมายยอดนิยม เช่น Google, Amazon และอื่น ๆ

จัดการ CAPTCHA และข้อจำกัดตามภูมิภาค

• รับมือกับระบบจัดการคำขออัตโนมัติที่ซับซ้อนได้ด้วยอัตราความสำเร็จสูง
• ดึงข้อมูลจากเว็บไซต์ที่ซับซ้อนที่สุดได้อย่างน่าเชื่อถือ
• รับ IP ที่หมุนเวียนโดยอัตโนมัติจากกลุ่มพร็อกซีที่ครอบคลุมกว่า 195 ประเทศ

ตั้งค่าได้ยืดหยุ่นและรองรับหลายแพลตฟอร์ม

• ตั้งค่าตัวเลือกการแสดงผลและการแยกวิเคราะห์ได้ตามต้องการ
• ส่งข้อมูลไปยังโมเดล AI หรือเครื่องมือวิเคราะห์ได้โดยตรง
• ใช้งานได้บน macOS, Windows และ Linux

มีระบบจัดการข้อผิดพลาดและคำขอในตัว

• จัดการและรายงานข้อผิดพลาดอย่างครอบคลุม
• จำกัดอัตราการเรียกใช้และจัดการคำขออย่างชาญฉลาด

ทำไมต้อง Oxylabs MCP?  🕸️ ➜ 📦 ➜ 🤖

ลองนึกภาพว่าคุณบอก LLM ว่า "สรุปการพูดคุยล่าสุดบน Hacker News เกี่ยวกับ GPT‑5" — แล้วมันก็ตอบได้ทันที เซิร์ฟเวอร์ Oxylabs MCP ทำให้สิ่งนี้เป็นจริง โดยจัดการงานน่าเบื่อแทนคุณ:

Oxylabs MCP ทำอะไร	สำคัญกับคุณอย่างไร
จัดการกำแพงป้องกันคำขออัตโนมัติ ด้วยเครือข่ายพร็อกซีทั่วโลกของ Oxylabs	ช่วยให้เข้าถึงเว็บไซต์ได้และไม่เปิดเผยตัวตน
แสดงผล JavaScript ใน Chrome แบบ headless	จัดการแอปหน้าเดียวได้เรียบร้อย
ทำความสะอาด HTML → Markdown	นำไปใส่ใน vector DB หรือพรอมป์ต์ได้ทันที
ตัวแยกวิเคราะห์แบบมีโครงสร้างที่เลือกใช้ได้ (Google, Amazon ฯลฯ)	เข้าถึงเป้าหมายยอดนิยมได้ในบรรทัดเดียว

---

🛡️ ใบอนุญาต

เผยแพร่ภายใต้ MIT License — ดูรายละเอียดได้ที่ LICENSE

---

เกี่ยวกับ Oxylabs

Oxylabs ก่อตั้งขึ้นในปี 2015 เป็นแพลตฟอร์มรวบรวมข้อมูลเชิงลึกจากเว็บชั้นนำของตลาด ดำเนินงานตามมาตรฐานสูงสุดด้านธุรกิจ จริยธรรม และการปฏิบัติตามข้อกำหนด ช่วยให้บริษัททั่วโลกปลดล็อกข้อมูลเชิงลึกที่ขับเคลื่อนด้วยข้อมูล

โซลูชันที่สร้างขึ้นจาก MCP นี้:

Michelin Detour