Oxylabs

Oxylabs MCP Server

Penghubung yang hilang antara model AI dan web dunia nyata: satu API yang menyediakan data bersih dan terstruktur dari situs mana pun.

---

Penafian

Repositori ini masih didukung sepenuhnya, tetapi jika Anda menggunakan Oxylabs Web API, silakan kunjungi repositori Web API MCP: Web API MCP

📖 Ikhtisar

Server MCP Oxylabs menyediakan jembatan antara model AI dan web. Server ini memungkinkan model AI mengambil data dari URL mana pun, merender halaman yang sarat JavaScript, mengekstrak dan memformat konten untuk penggunaan AI, menangani CAPTCHA, serta mengakses data web yang dibatasi secara geografis dari lebih dari 195 negara.

Server ini dibangun berdasarkan Model Context Protocol (MCP), standar terbuka untuk menghubungkan asisten AI ke alat dan data eksternal.

mcp-name: io.oxylabs/oxylabs-mcp

🛠️ Alat MCP

Oxylabs MCP menyediakan dua rangkaian alat yang dapat digunakan bersama atau secara terpisah:

Alat Oxylabs Web Scraper API

1. universal_scraper: mengambil data dari URL mana pun, dengan opsi perenderan JavaScript, penargetan geografis, serta keluaran Markdown/HTML/tautan;
2. google_search_scraper: mengekstrak hasil dari Google Search, dengan opsi menguraikannya menjadi JSON terstruktur;
3. amazon_search_scraper: mengambil data dari halaman hasil pencarian Amazon, dengan opsi menguraikannya menjadi JSON terstruktur;
4. amazon_product_scraper: mengekstrak data dari halaman produk Amazon tertentu.

Alat Oxylabs AI Studio

5. ai_scraper: mengambil konten dari URL mana pun dengan ekstraksi berbasis AI, dalam format JSON, CSV, Markdown, atau TOON;
6. ai_crawler: merayapi situs web mulai dari URL awal berdasarkan prompt dan mengumpulkan data dari beberapa halaman;
7. ai_browser_agent: mengendalikan browser sungguhan berdasarkan prompt — menavigasi, mengeklik, mengisi formulir — dan mengembalikan hasilnya;
8. ai_search: menelusuri web dan secara opsional mengembalikan konten Markdown dari setiap hasil;
9. ai_map: memetakan URL situs web, dengan filter berdasarkan kata kunci atau prompt;
10. generate_schema: menghasilkan skema JSON berformat OpenAPI untuk ekstraksi terstruktur menggunakan alat AI di atas.

✅ Prasyarat

Sebelum memulai, pastikan Anda memiliki setidaknya satu dari berikut ini:

• Akun Oxylabs Web Scraper API: dapatkan token API (atau nama pengguna dan kata sandi) dari dasbor Oxylabs (tersedia uji coba gratis selama 1 minggu);
• Kunci API Oxylabs AI Studio: dapatkan kunci API Anda dari Oxylabs AI Studio (1000 kredit gratis).

Untuk menjalankan server secara lokal (Opsi 2 di bawah), Anda juga memerlukan pengelola paket 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"

📦 Konfigurasi

Ada dua cara untuk menggunakan server: terhubung ke instans yang dihosting (tanpa instalasi) atau menjalankannya secara lokal dengan kredensial di variabel lingkungan.

Opsi 1: Server yang dihosting (tanpa instalasi)

Oxylabs menjalankan server MCP yang dihosting di:

https://mcp.oxylabs.io/mcp

Kredensial dikirim melalui header permintaan:

Kredensial	Header
Token Web Scraper API (disarankan)	Authorization: Bearer <token>
Token Web Scraper API (alternatif)	X-Oxylabs-Api-Token
Nama pengguna dan kata sandi Web Scraper API	Authorization: Basic <base64(username:password)>
Nama pengguna dan kata sandi Web Scraper API (alt.)	X-Oxylabs-Username dan X-Oxylabs-Password
AI Studio	X-Oxylabs-AI-Studio-Api-Key

Jika token API dan nama pengguna serta kata sandi sama-sama dikirim, token akan digunakan.

Penyiapan dengan 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"

Penyiapan dengan Cursor atau klien apa pun yang mendukung server MCP jarak jauh dengan header khusus:

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

Server ini juga tercantum di Smithery.

Catatan: klien yang hanya mendukung OAuth untuk server jarak jauh (misalnya, menambahkan konektor khusus di UI web claude.ai) belum dapat mengirim header — dukungan masuk dengan OAuth ada dalam rencana kami. Untuk sementara, gunakan penyiapan lokal di bawah ini dengan klien tersebut.

Opsi 2: Jalankan secara lokal

Variabel lingkungan

Server MCP Oxylabs mendukung variabel lingkungan berikut:

Nama	Deskripsi	Default
OXYLABS_API_TOKEN	Token Oxylabs Web Scraper API Anda
OXYLABS_USERNAME	Nama pengguna Oxylabs Web Scraper API Anda
OXYLABS_PASSWORD	Kata sandi Oxylabs Web Scraper API Anda
OXYLABS_AI_STUDIO_API_KEY	Kunci API Oxylabs AI Studio Anda
LOG_LEVEL	Tingkat log untuk log yang dikembalikan ke klien	INFO

Untuk alat Web Scraper API, tetapkan OXYLABS_API_TOKEN atau keduanya, OXYLABS_USERNAME dan OXYLABS_PASSWORD. Jika keduanya ditetapkan, token akan digunakan. Untuk alat AI Studio, tetapkan OXYLABS_AI_STUDIO_API_KEY.

Semua alat selalu ditampilkan; jika alat dipanggil tanpa kredensial yang dibutuhkannya, pesan kesalahan akan menjelaskan hal yang perlu dikonfigurasi.

❗ Penting: tetapkan hanya variabel lingkungan yang kredensialnya benar-benar Anda miliki. Nilai placeholder akan menyebabkan pemanggilan alat gagal.

Konfigurasi dengan uvx

Menginstal paket dari PyPI dan menjalankannya secara otomatis:

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

Konfigurasi dengan klona lokal

Berguna untuk pengembangan — menjalankan server dari klona lokal repositori ini:

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

Menjalankan sebagai server HTTP jarak jauh (hosting mandiri)

Server ini juga mendukung transport MCP streamable-HTTP. Jalankan dengan:

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

Dengan transport HTTP, kredensial dikirim untuk setiap permintaan, bukan melalui variabel lingkungan:

Kredensial	Cara mengirimkannya
Token Web Scraper API (disarankan)	Authorization: Bearer <token>
Token Web Scraper API (alternatif)	Header X-Oxylabs-Api-Token
Nama pengguna dan kata sandi Web Scraper API	Authorization: Basic <base64(username:password)> (autentikasi HTTP Basic)
Nama pengguna dan kata sandi Web Scraper API (alt.)	Header X-Oxylabs-Username dan X-Oxylabs-Password
AI Studio	Header X-Oxylabs-AI-Studio-Api-Key

Contoh konfigurasi klien:

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

Semua alat selalu ditampilkan, apa pun kredensial yang diberikan; jika alat dipanggil tanpa kredensial yang dibutuhkannya, pesan kesalahan akan menjelaskan dengan tepat hal yang perlu dikonfigurasi.

Penyiapan dengan Claude Desktop

Buka Claude → Settings → Developer → Edit Config dan tambahkan salah satu konfigurasi di atas ke file claude_desktop_config.json.

Penyiapan dengan Cursor AI

Buka Cursor → Settings → Cursor Settings → MCP. Klik Add new global MCP server dan tambahkan salah satu konfigurasi di atas.

📝 Pencatatan log

Server menyediakan informasi tambahan tentang pemanggilan alat dalam peristiwa 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"
  }
}

✨ Fitur Utama

Ambil data dari situs mana pun

• Ekstrak data dari URL mana pun, termasuk aplikasi satu halaman yang kompleks
• Render situs web dinamis sepenuhnya menggunakan dukungan browser tanpa antarmuka
• Pilih perenderan JavaScript penuh, hanya HTML, atau tanpa perenderan
• Simulasikan tampilan seluler dan desktop untuk perenderan yang realistis

Dapatkan data siap pakai untuk AI secara otomatis

• Bersihkan dan konversi HTML ke Markdown secara otomatis agar lebih mudah dibaca
• Gunakan parser otomatis untuk target populer seperti Google, Amazon, dan lainnya

Tangani CAPTCHA dan pembatasan geografis

• Atasi sistem pengelolaan permintaan otomatis yang canggih dengan tingkat keberhasilan tinggi
• Ambil data dari situs web yang paling kompleks sekalipun dengan andal
• Dapatkan IP yang berotasi otomatis dari kumpulan proxy yang mencakup lebih dari 195 negara

Penyiapan fleksibel dan dukungan lintas platform

• Atur opsi perenderan dan penguraian jika diperlukan
• Kirim data langsung ke model AI atau alat analitik
• Berfungsi di macOS, Windows, dan Linux

Penanganan kesalahan dan pengelolaan permintaan bawaan

• Penanganan dan pelaporan kesalahan yang menyeluruh
• Pembatasan laju dan pengelolaan permintaan yang cerdas

Mengapa Oxylabs MCP?  🕸️ ➜ 📦 ➜ 🤖

Bayangkan Anda meminta LLM "Ringkas diskusi Hacker News terbaru tentang GPT‑5" — lalu LLM langsung menjawab. Server MCP Oxylabs mewujudkannya dengan menangani pekerjaan membosankan untuk Anda:

Yang dilakukan Oxylabs MCP	Manfaatnya bagi Anda
Menangani penghalang permintaan otomatis dengan jaringan proxy global Oxylabs	Memungkinkan akses ke situs web dan anonimitas
Merender JavaScript di Chrome tanpa antarmuka	Aplikasi satu halaman, beres
Membersihkan HTML → Markdown	Langsung masukkan ke basis data vektor atau prompt
Parser terstruktur opsional (Google, Amazon, dll.)	Akses sekali baris ke target populer

---

🛡️ Lisensi

Didistribusikan di bawah Lisensi MIT — lihat LICENSE untuk detailnya.

---

Tentang Oxylabs

Didirikan pada tahun 2015, Oxylabs adalah platform pengumpulan intelijen web terkemuka di pasar, yang beroperasi dengan standar bisnis, etika, dan kepatuhan tertinggi, serta memungkinkan perusahaan di seluruh dunia memperoleh wawasan berbasis data.

Solusi yang dibuat berdasarkan MCP ini:

Michelin Detour