Oxylabs MCP Server

resmi

Oxylabs Web API ile web sitelerini kazıyın, dinamik işleme ve yapılandırılmış veri çıkarma için ayrıştırmayı destekler.

Dokümantasyon

Oxylabs + MCP

Oxylabs MCP Sunucusu

Yapay zeka modelleri ile gerçek dünya web'i arasındaki eksik halka: herhangi bir siteden temiz, yapılandırılmış veri sunan tek bir API.

📖 Genel Bakış

Oxylabs MCP sunucusu, yapay zeka modelleri ile web arasında bir köprü sağlar. Herhangi bir URL'yi kazımalarını, JavaScript ağırlıklı sayfaları işlemelerini, yapay zeka kullanımı için içerik çıkarmalarını ve biçimlendirmelerini, CAPTCHA'yı yönetmelerini ve 195'ten fazla ülkeden coğrafi kısıtlamalı web verilerine erişmelerini sağlar.

🛠️ MCP Araçları

Oxylabs MCP, birlikte veya bağımsız olarak kullanılabilen iki araç seti sunar:

Oxylabs Web Scraper API Araçları

universal_scraper: Genel web sitesi kazıma için Oxylabs Web Scraper API'sini kullanır;
google_search_scraper: Google Arama'dan sonuç çıkarmak için Oxylabs Web Scraper API'sini kullanır;
amazon_search_scraper: Amazon arama sonuç sayfalarını kazımak için Oxylabs Web Scraper API'sini kullanır;
amazon_product_scraper: Bireysel Amazon ürün sayfalarından veri çıkarmak için Oxylabs Web Scraper API'sini kullanır.

Oxylabs AI Studio Araçları

ai_scraper: Yapay zeka destekli veri çıkarma ile herhangi bir URL'den JSON veya Markdown formatında içerik kazır;
ai_crawler: Bir isteme dayanarak bir web sitesini tarar ve birden fazla sayfada Markdown veya JSON formatında veri toplar;
ai_browser_agent: İsteme dayanarak bir tarayıcıyı kontrol eder ve Markdown, JSON, HTML veya ekran görüntüsü formatlarında veri döndürür;
ai_search: Yapay zeka destekli içerik çıkarma ile web'de URL'leri ve içeriklerini arar.

✅ Ön Koşullar

Başlamadan önce, en az birine sahip olduğunuzdan emin olun:

Oxylabs Web Scraper API Hesabı: Kullanıcı adınızı ve şifrenizi Oxylabs adresinden edinin (1 haftalık ücretsiz deneme mevcuttur);
Oxylabs AI Studio API Anahtarı: API anahtarınızı Oxylabs AI Studio adresinden edinin. (1000 ücretsiz kredi).

📦 Yapılandırma

Ortam Değişkenleri

Oxylabs MCP sunucusu aşağıdaki ortam değişkenlerini destekler:

Ad	Açıklama	Varsayılan
`OXYLABS_USERNAME`	Oxylabs Web Scraper API kullanıcı adınız
`OXYLABS_PASSWORD`	Oxylabs Web Scraper API şifreniz
`OXYLABS_AI_STUDIO_API_KEY`	Oxylabs AI Studio API anahtarınız
`LOG_LEVEL`	İstemciye döndürülen günlükler için günlük seviyesi	`INFO`

Sağlanan kimlik bilgilerine bağlı olarak, sunucu ilgili araçları otomatik olarak sunacaktır:

Yalnızca OXYLABS_USERNAME ve OXYLABS_PASSWORD sağlanırsa, sunucu Web Scraper API araçlarını sunar;
Yalnızca OXYLABS_AI_STUDIO_API_KEY sağlanırsa, sunucu AI Studio araçlarını sunar;
Hem OXYLABS_USERNAME hem OXYLABS_PASSWORD hem de OXYLABS_AI_STUDIO_API_KEY sağlanırsa, sunucu tüm araçları sunar.

❗❗❗ Önemli not: Web Scraper API veya Oxylabs AI Studio kimlik bilgileriniz yoksa, ilgili ortam değişkeni yer tutucularını silin. Yer tutucu değerleri bırakmak, çalışmayan araçların sunulmasına neden olur.

uvx ile Yapılandırma

uvx paket yöneticisini yükleyin:

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

VEYA:

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

Aşağıdaki yapılandırmayı kullanın:

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD",
        "OXYLABS_AI_STUDIO_API_KEY": "OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }
}

uv ile Yapılandırma

uv paket yöneticisini yükleyin:

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

VEYA:

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

Aşağıdaki yapılandırmayı kullanın:

{
  "mcpServers": {
    "oxylabs": {
      "command": "uv",
      "args": [
        "--directory",
        "/<Absolute-path-to-folder>/oxylabs-mcp",
        "run",
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD",
        "OXYLABS_AI_STUDIO_API_KEY": "OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }
}

Smithery Oauth2 ile Yapılandırma

https://smithery.ai/server/@oxylabs/oxylabs-mcp; adresine gidin
İlgili istemci için Oxylabs MCP yapılandırmasını yüklemek üzere Otomatik seçeneğine tıklayın;
VEYA aşağıdaki yapılandırmayı kullanın:

  {
    "mcpServers": {
      "oxylabs": {
        "url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp"
      }
    }
  }

Oauth2 akışı ile Oxylabs MCP kimliğini doğrulamak için talimatları izleyin

Smithery Sorgu Parametreleri ile Yapılandırma

İstemciniz Oauth2 kimlik doğrulamasını desteklemiyorsa, Oxylabs kimlik doğrulama parametrelerini doğrudan URL'de iletebilirsiniz

  {
    "mcpServers": {
      "oxylabs": {
        "url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp?oxylabsUsername=OXYLABS_USERNAME&oxylabsPassword=OXYLABS_PASSWORD&oxylabsAiStudioApiKey=OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }

Claude Desktop ile Manuel Kurulum

Claude → Ayarlar → Geliştirici → Yapılandırmayı Düzenle yoluna gidin ve yukarıdaki yapılandırmalardan birini claude_desktop_config.json dosyasına ekleyin.

Cursor AI ile Manuel Kurulum

Cursor → Ayarlar → Cursor Ayarları → MCP yoluna gidin. Yeni global MCP sunucusu ekle seçeneğine tıklayın ve yukarıdaki yapılandırmalardan birini ekleyin.

📝 Günlük Kaydı

Sunucu, notification/message olaylarında araç çağrıları hakkında ek bilgi sağlar

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

🛡️ Lisans

MIT Lisansı altında dağıtılmaktadır – ayrıntılar için LICENSE dosyasına bakın.

Oxylabs Hakkında

2015 yılında kurulan Oxylabs, en yüksek iş, etik ve uyumluluk standartlarıyla yönlendirilen, dünya çapındaki şirketlerin veri odaklı içgörüler elde etmesini sağlayan, pazarda lider bir web istihbaratı toplama platformudur.

_{☕ ile Oxylabs tarafından yapıldı. MCP size bir hafta sonu kazandırdıysa bize bir ⭐ vermekten çekinmeyin.}

✨ Temel Özellikler

Herhangi bir siteden içerik kazıyın

Karmaşık tek sayfa uygulamaları da dahil olmak üzere herhangi bir URL'den veri çıkarın
Headless tarayıcı desteği kullanarak dinamik web sitelerini tamamen işleyin
Tam JavaScript işleme, yalnızca HTML veya hiçbiri seçeneklerinden birini seçin
Gerçekçi işleme için Mobil ve Masaüstü görünümlerini taklit edin

Otomatik olarak yapay zekaya hazır veri elde edin

Daha iyi okunabilirlik için HTML'i otomatik olarak temizleyin ve Markdown'a dönüştürün
Google, Amazon ve daha fazlası gibi popüler hedefler için otomatik ayrıştırıcılar kullanın

CAPTCHA ve coğrafi kısıtlamaları yönetin

Yüksek başarı oranıyla karmaşık otomatik istek yönetim sistemlerinde gezinin
En karmaşık web sitelerini bile güvenilir bir şekilde kazıyın
195'ten fazla ülkeyi kapsayan bir proxy havuzundan otomatik olarak dönen IP'ler alın

Esnek kurulum ve platformlar arası destek

Gerekirse işleme ve ayrıştırma seçeneklerini ayarlayın
Verileri doğrudan yapay zeka modellerine veya analitik araçlarına besleyin
macOS, Windows ve Linux'ta çalışır

Yerleşik hata yönetimi ve istek yönetimi

Kapsamlı hata yönetimi ve raporlama
Akıllı hız sınırlama ve istek yönetimi

Neden Oxylabs MCP? 🕸️ ➜ 📦 ➜ 🤖

LLM'nize "GPT‑5 hakkındaki en son Hacker News tartışmasını özetle" dediğinizi ve onun basitçe yanıtladığını hayal edin.
MCP (Multi‑Client Proxy), sıkıcı kısımları sizin için yaparak bunu gerçekleştirir:

Oxylabs MCP'nin Yaptıkları	Sizin İçin Neden Önemli
Otomatik istek duvarlarını yönetir Oxylabs küresel proxy ağı ile	Web sitesi erişimi ve anonimlik sağlar
JavaScript'i işler headless Chrome'da	Tek sayfa uygulamalar, çözüldü
HTML'i → JSON'a temizler	Doğrudan vektör veritabanlarına veya istemlere aktarın
İsteğe bağlı yapılandırılmış ayrıştırıcılar (Google, Amazon, vb.)	Popüler hedeflere tek satırda erişim

mcp-name: io.oxylabs/oxylabs-mcp