Oxylabs

Máy chủ MCP Oxylabs

Mắt xích còn thiếu giữa các mô hình AI và web thực tế: một API cung cấp dữ liệu sạch, có cấu trúc từ mọi trang web.

---

Tuyên bố miễn trừ trách nhiệm

Kho lưu trữ này vẫn được hỗ trợ đầy đủ, nhưng nếu bạn đang sử dụng Oxylabs Web API, vui lòng tham khảo kho lưu trữ Web API MCP: Web API MCP

📖 Tổng quan

Máy chủ MCP Oxylabs tạo cầu nối giữa các mô hình AI và web. Máy chủ cho phép chúng thu thập dữ liệu từ mọi URL, hiển thị các trang sử dụng nhiều JavaScript, trích xuất và định dạng nội dung để AI sử dụng, xử lý CAPTCHA và truy cập dữ liệu web bị giới hạn theo vị trí địa lý từ hơn 195 quốc gia.

Máy chủ được xây dựng dựa trên Model Context Protocol (MCP), tiêu chuẩn mở để kết nối trợ lý AI với các công cụ và dữ liệu bên ngoài.

mcp-name: io.oxylabs/oxylabs-mcp

🛠️ Công cụ MCP

Oxylabs MCP cung cấp hai nhóm công cụ có thể sử dụng cùng nhau hoặc độc lập:

Công cụ Oxylabs Web Scraper API

1. universal_scraper: thu thập dữ liệu từ mọi URL, với tùy chọn hiển thị JavaScript, nhắm mục tiêu theo vị trí địa lý và xuất kết quả dưới dạng Markdown/HTML/liên kết;
2. google_search_scraper: trích xuất kết quả từ Google Search, với tùy chọn phân tích cú pháp thành JSON có cấu trúc;
3. amazon_search_scraper: thu thập dữ liệu từ các trang kết quả tìm kiếm Amazon, với tùy chọn phân tích cú pháp thành JSON có cấu trúc;
4. amazon_product_scraper: trích xuất dữ liệu từ các trang sản phẩm Amazon riêng lẻ.

Công cụ Oxylabs AI Studio

5. ai_scraper: thu thập nội dung từ mọi URL bằng tính năng trích xuất dựa trên AI, ở định dạng JSON, CSV, Markdown hoặc TOON;
6. ai_crawler: thu thập dữ liệu trên một trang web, bắt đầu từ URL được cung cấp, dựa trên lời nhắc và thu thập dữ liệu trên nhiều trang;
7. ai_browser_agent: điều khiển trình duyệt thực dựa trên lời nhắc — điều hướng, nhấp, điền biểu mẫu — và trả về kết quả;
8. ai_search: tìm kiếm trên web và tùy chọn trả về nội dung Markdown của từng kết quả;
9. ai_map: lập bản đồ URL của một trang web, lọc theo từ khóa hoặc lời nhắc;
10. generate_schema: tạo lược đồ JSON định dạng OpenAPI để trích xuất dữ liệu có cấu trúc bằng các công cụ AI ở trên.

✅ Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo bạn có ít nhất một trong các mục sau:

• Tài khoản Oxylabs Web Scraper API: lấy mã thông báo API (hoặc tên người dùng và mật khẩu) từ bảng điều khiển Oxylabs (có bản dùng thử miễn phí 1 tuần);
• Khóa API Oxylabs AI Studio: lấy khóa API từ Oxylabs AI Studio (miễn phí 1000 tín dụng).

Để chạy máy chủ cục bộ (Tùy chọn 2 bên dưới), bạn cũng cần trình quản lý gói 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"

📦 Cấu hình

Có hai cách sử dụng máy chủ: kết nối với máy chủ được lưu trữ (không cần cài đặt) hoặc chạy cục bộ với thông tin xác thực trong các biến môi trường.

Tùy chọn 1: Máy chủ được lưu trữ (không cần cài đặt)

Oxylabs vận hành máy chủ MCP được lưu trữ tại:

https://mcp.oxylabs.io/mcp

Thông tin xác thực được truyền qua các tiêu đề yêu cầu:

Thông tin xác thực	Tiêu đề
Mã thông báo Web Scraper API (khuyến nghị)	Authorization: Bearer <token>
Mã thông báo Web Scraper API (thay thế)	X-Oxylabs-Api-Token
Tên người dùng và mật khẩu Web Scraper API	Authorization: Basic <base64(username:password)>
Tên người dùng và mật khẩu Web Scraper API (thay thế)	X-Oxylabs-Username và X-Oxylabs-Password
AI Studio	X-Oxylabs-AI-Studio-Api-Key

Nếu truyền cả mã thông báo API lẫn tên người dùng và mật khẩu, mã thông báo sẽ được sử dụng.

Thiết lập với 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"

Thiết lập với Cursor hoặc bất kỳ ứng dụng khách nào hỗ trợ máy chủ MCP từ xa có tiêu đề tùy chỉnh:

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

Máy chủ cũng được liệt kê trên Smithery.

Lưu ý: các ứng dụng khách chỉ hỗ trợ OAuth cho máy chủ từ xa (ví dụ: thêm trình kết nối tùy chỉnh trong giao diện web claude.ai) hiện chưa thể truyền tiêu đề — tính năng đăng nhập OAuth nằm trong lộ trình phát triển của chúng tôi. Trong thời gian chờ đợi, hãy sử dụng thiết lập cục bộ bên dưới với các ứng dụng khách đó.

Tùy chọn 2: Chạy cục bộ

Biến môi trường

Máy chủ MCP Oxylabs hỗ trợ các biến môi trường sau:

Tên	Mô tả	Mặc định
OXYLABS_API_TOKEN	Mã thông báo Oxylabs Web Scraper API của bạn
OXYLABS_USERNAME	Tên người dùng Oxylabs Web Scraper API của bạn
OXYLABS_PASSWORD	Mật khẩu Oxylabs Web Scraper API của bạn
OXYLABS_AI_STUDIO_API_KEY	Khóa API Oxylabs AI Studio của bạn
LOG_LEVEL	Cấp độ nhật ký được trả về cho ứng dụng khách	INFO

Đối với các công cụ Web Scraper API, hãy đặt OXYLABS_API_TOKEN hoặc cả OXYLABS_USERNAME và OXYLABS_PASSWORD. Nếu đặt cả hai, mã thông báo sẽ được sử dụng. Đối với các công cụ AI Studio, hãy đặt OXYLABS_AI_STUDIO_API_KEY.

Tất cả công cụ luôn được liệt kê; nếu gọi một công cụ mà không có thông tin xác thực cần thiết, hệ thống sẽ trả về thông báo lỗi giải thích cần cấu hình những gì.

❗ Quan trọng: chỉ đặt các biến môi trường mà bạn có thông tin xác thực thực. Giá trị giữ chỗ sẽ khiến các lệnh gọi công cụ thất bại.

Cấu hình bằng uvx

Cài đặt gói từ PyPI và tự động chạy gói:

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

Cấu hình bằng bản sao cục bộ

Hữu ích cho việc phát triển — chạy máy chủ từ bản sao cục bộ của kho lưu trữ này:

{
  "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"
      }
    }
  }
}

Chạy dưới dạng máy chủ HTTP từ xa (tự lưu trữ)

Máy chủ cũng hỗ trợ giao thức truyền tải MCP streamable-HTTP. Khởi động máy chủ bằng lệnh:

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

Với giao thức truyền tải HTTP, thông tin xác thực được truyền theo từng yêu cầu thay vì qua biến môi trường:

Thông tin xác thực	Cách truyền
Mã thông báo Web Scraper API (khuyến nghị)	Authorization: Bearer <token>
Mã thông báo Web Scraper API (thay thế)	tiêu đề X-Oxylabs-Api-Token
Tên người dùng và mật khẩu Web Scraper API	Authorization: Basic <base64(username:password)> (xác thực HTTP Basic)
Tên người dùng và mật khẩu Web Scraper API (thay thế)	tiêu đề X-Oxylabs-Username và X-Oxylabs-Password
AI Studio	tiêu đề X-Oxylabs-AI-Studio-Api-Key

Ví dụ cấu hình ứng dụng khách:

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

Tất cả công cụ luôn được liệt kê bất kể thông tin xác thực được cung cấp; nếu gọi một công cụ mà không có thông tin xác thực cần thiết, hệ thống sẽ trả về thông báo lỗi giải thích chính xác cần cấu hình những gì.

Thiết lập với Claude Desktop

Đi đến Claude → Settings → Developer → Edit Config và thêm một trong các cấu hình ở trên vào tệp claude_desktop_config.json.

Thiết lập với Cursor AI

Đi đến Cursor → Settings → Cursor Settings → MCP. Nhấp vào Add new global MCP server và thêm một trong các cấu hình ở trên.

📝 Ghi nhật ký

Máy chủ cung cấp thêm thông tin về các lệnh gọi công cụ trong các sự kiện 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"
  }
}

✨ Tính năng chính

Thu thập nội dung từ mọi trang web

• Trích xuất dữ liệu từ mọi URL, bao gồm cả các ứng dụng trang đơn phức tạp
• Hiển thị đầy đủ các trang web động bằng tính năng hỗ trợ trình duyệt không giao diện
• Chọn hiển thị JavaScript đầy đủ, chỉ HTML hoặc không hiển thị
• Mô phỏng khung nhìn trên thiết bị di động và máy tính để bàn để hiển thị chân thực

Tự động nhận dữ liệu sẵn sàng cho AI

• Tự động làm sạch và chuyển đổi HTML sang Markdown để dễ đọc hơn
• Sử dụng trình phân tích cú pháp tự động cho các mục tiêu phổ biến như Google, Amazon và nhiều nền tảng khác

Xử lý CAPTCHA và giới hạn địa lý

• Vượt qua các hệ thống quản lý yêu cầu tự động phức tạp với tỷ lệ thành công cao
• Thu thập dữ liệu đáng tin cậy ngay cả từ những trang web phức tạp nhất
• Tự động nhận IP luân phiên từ nhóm proxy phủ sóng hơn 195 quốc gia

Thiết lập linh hoạt và hỗ trợ đa nền tảng

• Thiết lập tùy chọn hiển thị và phân tích cú pháp nếu cần
• Đưa dữ liệu trực tiếp vào các mô hình AI hoặc công cụ phân tích
• Hoạt động trên macOS, Windows và Linux

Tích hợp xử lý lỗi và quản lý yêu cầu

• Xử lý và báo cáo lỗi toàn diện
• Giới hạn tốc độ và quản lý yêu cầu thông minh

Vì sao chọn Oxylabs MCP?  🕸️ ➜ 📦 ➜ 🤖

Hãy tưởng tượng bạn yêu cầu LLM "Tóm tắt cuộc thảo luận mới nhất trên Hacker News về GPT‑5" — và nó trả lời ngay. Máy chủ MCP Oxylabs giúp điều đó thành hiện thực bằng cách xử lý những phần nhàm chán thay bạn:

Oxylabs MCP làm gì	Vì sao điều đó hữu ích với bạn
Quản lý các rào cản yêu cầu tự động bằng mạng proxy toàn cầu Oxylabs	Cho phép truy cập trang web và ẩn danh
Hiển thị JavaScript trong Chrome không giao diện	Giải quyết các ứng dụng trang đơn
Làm sạch HTML → Markdown	Đưa thẳng vào cơ sở dữ liệu vector hoặc lời nhắc
Trình phân tích cú pháp có cấu trúc tùy chọn (Google, Amazon, v.v.)	Truy cập các mục tiêu phổ biến chỉ bằng một dòng

---

🛡️ Giấy phép

Phân phối theo Giấy phép MIT – xem LICENSE để biết chi tiết.

---

Giới thiệu về Oxylabs

Được thành lập vào năm 2015, Oxylabs là nền tảng thu thập thông tin web hàng đầu thị trường, hoạt động theo các tiêu chuẩn cao nhất về kinh doanh, đạo đức và tuân thủ, giúp các công ty trên toàn thế giới khai thác thông tin chuyên sâu dựa trên dữ liệu.

Các giải pháp được xây dựng dựa trên MCP này:

Michelin Detour