Oxylabs

Oxylabs MCP Server

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

---

📖 ภาพรวม

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

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

🛠️ เครื่องมือ 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 รูปแบบ OpenAPI สำหรับการแยกข้อมูลที่มีโครงสร้างด้วยเครื่องมือ AI ข้างต้น

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

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

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

คุณจะต้องมีตัวจัดการแพ็กเกจ 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"

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

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

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

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

ตามข้อมูลประจำตัวที่ให้ไว้ เซิร์ฟเวอร์จะเปิดเผยเครื่องมือที่เกี่ยวข้องโดยอัตโนมัติ:

• หากระบุเฉพาะ OXYLABS_USERNAME และ OXYLABS_PASSWORD เซิร์ฟเวอร์จะเปิดเผยเครื่องมือ Web Scraper API
• หากระบุเฉพาะ OXYLABS_AI_STUDIO_API_KEY เซิร์ฟเวอร์จะเปิดเผยเครื่องมือ AI Studio
• หากระบุครบทั้งสามค่า เซิร์ฟเวอร์จะเปิดเผยเครื่องมือทั้งหมด

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

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

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

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "YOUR_USERNAME",
        "OXYLABS_PASSWORD": "YOUR_PASSWORD",
        "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_USERNAME": "YOUR_USERNAME",
        "OXYLABS_PASSWORD": "YOUR_PASSWORD",
        "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	Authorization: Basic <base64(username:password)> (การรับรองความถูกต้อง HTTP Basic มาตรฐาน)
Web Scraper API (ทางเลือก)	X-Oxylabs-Username และ X-Oxylabs-Password headers
AI Studio	X-Oxylabs-AI-Studio-Api-Key header

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

{
  "mcpServers": {
    "oxylabs": {
      "url": "https://your-host:8000/mcp",
      "headers": {
        "Authorization": "Basic <base64 of username:password>",
        "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 และเพิ่มหนึ่งในการกำหนดค่าข้างต้น

📝 การบันทึก (Logging)

เซิร์ฟเวอร์ให้ข้อมูลเพิ่มเติมเกี่ยวกับการเรียกใช้เครื่องมือในเหตุการณ์ 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 ใดก็ได้ รวมถึงแอปพลิเคชันหน้าเดียว (SPA) ที่ซับซ้อน
• เรนเดอร์เว็บไซต์แบบไดนามิกอย่างสมบูรณ์ด้วยการรองรับเบราว์เซอร์แบบไม่มีหัว (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 แบบไม่มีหัว	แอปหน้าเดียว, จัดการได้แล้ว
ทำความสะอาด HTML → Markdown	ใส่ลงในเวกเตอร์ DB หรือพรอมต์ได้โดยตรง
ตัวแยกวิเคราะห์โครงสร้างเสริม (Google, Amazon ฯลฯ)	เข้าถึงเป้าหมายยอดนิยมด้วยบรรทัดเดียว

---

🛡️ สัญญาอนุญาต

เผยแพร่ภายใต้ MIT License – ดู LICENSE สำหรับรายละเอียด

---

เกี่ยวกับ Oxylabs

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

mcp-name: io.oxylabs/oxylabs-mcp