Oxylabs
About
Scrape websites with Oxylabs Web API, supporting dynamic rendering and parsing for structured data extraction.
Details
- Transport
- SSE
- License
- MIT
Explore
<details>
<summary><strong> Scrape content from any site</strong></summary>
<br>
- Extract data from any URL, including complex single-page applications
- Fully render dynamic websites using headless browser support
- Choose full JavaScript rendering, HTML-only, or none
- Emulate Mobile and Desktop viewports for realistic rendering
</details>
<details>
<summary><strong> Automatically get AI-ready data</strong></summary>
<br>
- Automatically clean and convert HTML to Markdown for improved readability
- Use automated parsers for popular targets like Google, Amazon, and more
</details>
<details>
<summary><strong> Manage CAPTCHA & geo-restrictions</strong></summary>
<br>
- Navigate sophisticated automated request management systems with high success rate
- Reliably scrape even the most complex websites
- Get automatically rotating IPs from a proxy pool covering 195+ countries
</details>
<details>
<summary><strong> Flexible setup & cross-platform support</strong></summary>
<br>
- Set rendering and parsing options if needed
- Feed data directly into AI models or analytics tools
- Works on macOS, Windows, and Linux
</details>
<details>
<summary><strong> Built-in error handling and request management</strong></summary>
<br>
- Comprehensive error handling and reporting
- Smart rate limiting and request management
</details>
---
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OxylabsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Before you begin, make sure you have at least one of the following:
- Oxylabs Web Scraper API Account: Obtain your username and password from Oxylabs (1-week free trial available);
- Oxylabs AI Studio API Key: Obtain your API key from Oxylabs AI Studio. (1000 credits free).
Oxylabs MCP server supports the following environment variables:
| Name | Description | Default |
|----------------------------|-----------------------------------------------|---------|
| OXYLABS_USERNAME | Your Oxylabs Web Scraper API username | |
| OXYLABS_PASSWORD | Your Oxylabs Web Scraper API password | |
| OXYLABS_AI_STUDIO_API_KEY| Your Oxylabs AI Studio API key | |
| LOG_LEVEL | Log level for the logs returned to the client | INFO |
Based on provided credentials, the server will automatically expose the corresponding tools:
- If only OXYLABS_USERNAME and OXYLABS_PASSWORD are provided, the server will expose the Web Scraper API tools;
- If only OXYLABS_AI_STUDIO_API_KEY is provided, the server will expose the AI Studio tools;
- If both OXYLABS_USERNAME and OXYLABS_PASSWORD and OXYLABS_AI_STUDIO_API_KEY are provided, the server will expose all tools.
❗❗❗ Important note: if you don't have Web Scraper API or Oxylabs AI studio credentials, delete the corresponding environment variables placeholders.
Leaving placeholder values will result in exposed tools that do not work.
- Install the uvx package manager:
- Install the uv package manager:
- Go to https://smithery.ai/server/@oxylabs/oxylabs-mcp;
- Click _Auto_ to install the Oxylabs MCP configuration for the respective client;
- OR use the following config:
{
"mcpServers": {
"oxylabs": {
"url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp"
}
}
}
- Follow the instructions to authenticate Oxylabs MCP with Oauth2 flow
In case your client does not support the Oauth2 authentication, you can pass the Oxylabs authentication parameters directly in url
{
"mcpServers": {
"oxylabs": {
"url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp?oxylabsUsername=OXYLABS_USERNAME&oxylabsPassword=OXYLABS_PASSWORD&oxylabsAiStudioApiKey=OXYLABS_AI_STUDIO_API_KEY"
}
}
}
Navigate to Claude → Settings → Developer → Edit Config and add one of the configurations above to the claude_desktop_config.json file.
Navigate to Cursor → Settings → Cursor Settings → MCP. Click Add new global MCP server and add one of the configurations above.
Oxylabs MCP provides two sets of tools that can be used together or independently:
1. universal_scraper: Uses Oxylabs Web Scraper API for general website scraping;
2. google_search_scraper: Uses Oxylabs Web Scraper API to extract results from Google Search;
3. amazon_search_scraper: Uses Oxylabs Web Scraper API to scrape Amazon search result pages;
4. amazon_product_scraper: Uses Oxylabs Web Scraper API to extract data from individual Amazon product pages.
5. ai_scraper: Scrape content from any URL in JSON or Markdown format with AI-powered data extraction;
6. ai_crawler: Based on a prompt, crawls a website and collects data in Markdown or JSON format across multiple pages;
7. ai_browser_agent: Based on prompt, controls a browser and returns data in Markdown, JSON, HTML, or screenshot formats;
8. ai_search: Search the web for URLs and their contents with AI-powered content extraction.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"oxylabs": {
"oxylabs_scraper_uvx": {
"command": "uvx",
"args": [
"oxylabs-mcp"
],
"env": {
"OXYLABS_USERNAME": "OXYLABS_USERNAME",
"OXYLABS_PASSWORD": "OXYLABS_PASSWORD"
}
}
}
}
}McpServers
{
"oxylabs_scraper_uvx": {
"command": "uvx",
"args": [
"oxylabs-mcp"
],
"env": {
"OXYLABS_USERNAME": "OXYLABS_USERNAME",
"OXYLABS_PASSWORD": "OXYLABS_PASSWORD"
}
}
}About Oxylabs
Established in 2015, Oxylabs is a market-leading web intelligence collection
platform, driven by the highest business, ethics, and compliance standards,
enabling companies worldwide to unlock data-driven insights.
<div align="center">
<sub>
Made with ☕ by <a href="https://oxylabs.io">Oxylabs</a>. Feel free to give us a ⭐ if MCP saved you a weekend.
</sub>
</div>
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
