Oxylabs

Oxylabs MCP सर्वर

AI मॉडल और वास्तविक दुनिया के वेब के बीच की कड़ी: एक API जो किसी भी साइट से स्वच्छ, संरचित डेटा प्रदान करता है।

---

📖 अवलोकन

Oxylabs MCP सर्वर AI मॉडल और वेब के बीच एक सेतु प्रदान करता है। यह उन्हें किसी भी 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: किसी वेबसाइट के URLs का मानचित्रण करता है, कीवर्ड या प्रॉम्प्ट द्वारा फ़िल्टर किया गया;
10. generate_schema: ऊपर दिए गए AI टूल के साथ संरचित निष्कर्षण के लिए OpenAPI-फ़ॉर्मेट JSON स्कीमा उत्पन्न करता है।

✅ पूर्वापेक्षाएँ

शुरू करने से पहले, सुनिश्चित करें कि आपके पास निम्नलिखित में से कम से कम एक है:

• Oxylabs Web Scraper API खाता: Oxylabs से अपना उपयोगकर्ता नाम और पासवर्ड प्राप्त करें (1-सप्ताह का निःशुल्क परीक्षण उपलब्ध है);
• Oxylabs AI Studio API कुंजी: Oxylabs AI Studio से अपनी API कुंजी प्राप्त करें (1000 क्रेडिट निःशुल्क)।

सर्वर चलाने के लिए आपको 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	आपकी Oxylabs AI Studio API कुंजी
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 स्ट्रीमेबल-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 auth)
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": "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 पर क्लिक करें और उपरोक्त कॉन्फ़िगरेशन में से एक जोड़ें।

📝 लॉगिंग

सर्वर 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 से डेटा निकालें, जिसमें जटिल सिंगल-पेज एप्लिकेशन शामिल हैं
• हेडलेस ब्राउज़र समर्थन का उपयोग करके गतिशील वेबसाइटों को पूरी तरह से रेंडर करें
• पूर्ण JavaScript रेंडरिंग, केवल HTML, या कुछ भी नहीं चुनें
• यथार्थवादी रेंडरिंग के लिए मोबाइल और डेस्कटॉप व्यूपोर्ट का अनुकरण करें

स्वचालित रूप से AI-तैयार डेटा प्राप्त करें

• बेहतर पठनीयता के लिए HTML को स्वचालित रूप से साफ़ करें और Markdown में परिवर्तित करें
• Google, Amazon और अधिक जैसे लोकप्रिय लक्ष्यों के लिए स्वचालित पार्सर का उपयोग करें

CAPTCHA और भू-प्रतिबंधों का प्रबंधन करें

• उच्च सफलता दर के साथ परिष्कृत स्वचालित अनुरोध प्रबंधन प्रणालियों को नेविगेट करें
• सबसे जटिल वेबसाइटों को भी विश्वसनीय रूप से स्क्रैप करें
• 195+ देशों को कवर करने वाले प्रॉक्सी पूल से स्वचालित रूप से घूमने वाले IP प्राप्त करें

लचीला सेटअप और क्रॉस-प्लेटफ़ॉर्म समर्थन

• आवश्यकता होने पर रेंडरिंग और पार्सिंग विकल्प सेट करें
• डेटा को सीधे AI मॉडल या एनालिटिक्स टूल में फ़ीड करें
• macOS, Windows और Linux पर काम करता है

अंतर्निहित त्रुटि प्रबंधन और अनुरोध प्रबंधन

• व्यापक त्रुटि प्रबंधन और रिपोर्टिंग
• स्मार्ट रेट लिमिटिंग और अनुरोध प्रबंधन

Oxylabs MCP क्यों?  🕸️ ➜ 📦 ➜ 🤖

कल्पना करें कि आप अपने LLM से कहते हैं "GPT‑5 के बारे में नवीनतम Hacker News चर्चा का सारांश दें" – और यह बस उत्तर दे देता है। Oxylabs MCP सर्वर आपके लिए उबाऊ हिस्से करके इसे संभव बनाता है:

Oxylabs MCP क्या करता है	यह आपके लिए क्यों महत्वपूर्ण है
स्वचालित अनुरोध दीवारों का प्रबंधन करता है Oxylabs ग्लोबल प्रॉक्सी नेटवर्क के साथ	वेबसाइट पहुँच और गुमनामी सक्षम करता है
हेडलेस Chrome में JavaScript रेंडर करता है	सिंगल-पेज ऐप्स, व्यवस्थित
HTML → Markdown साफ़ करता है	सीधे वेक्टर DB या प्रॉम्प्ट में डालें
वैकल्पिक संरचित पार्सर (Google, Amazon, आदि)	लोकप्रिय लक्ष्यों तक एक-पंक्ति पहुँच

---

🛡️ लाइसेंस

MIT लाइसेंस के तहत वितरित – विवरण के लिए LICENSE देखें।

---

Oxylabs के बारे में

2015 में स्थापित, Oxylabs एक बाज़ार-अग्रणी वेब इंटेलिजेंस संग्रह प्लेटफ़ॉर्म है, जो उच्चतम व्यावसायिक, नैतिकता और अनुपालन मानकों द्वारा संचालित है, जो दुनिया भर की कंपनियों को डेटा-संचालित अंतर्दृष्टि अनलॉक करने में सक्षम बनाता है।

mcp-name: io.oxylabs/oxylabs-mcp