Oxylabs MCP Server
Official
📖 概述
Oxylabs MCP 服务器在 AI 模型与网络之间架起了一座桥梁。它使 AI 模型能够抓取任意 URL、渲染 JavaScript 密集型页面、提取并格式化内容以供 AI 使用、处理 CAPTCHA,以及访问来自 195 多个国家/地区的受地理限制的网络数据。
它基于模型上下文协议(MCP)构建,这是用于将 AI 助手连接到外部工具和数据的开放标准。
Related MCP server: Decodo MCP Server
🛠️ MCP 工具
Oxylabs MCP 提供两组工具,可以一起使用,也可以独立使用:
Oxylabs Web Scraper API 工具
universal_scraper:抓取任意 URL,支持可选的 JavaScript 渲染、地理定位以及 Markdown/HTML/链接输出;
google_search_scraper:从 Google 搜索中提取结果,支持可选解析为结构化 JSON;
amazon_search_scraper:抓取 Amazon 搜索结果页面,支持可选解析为结构化 JSON;
amazon_product_scraper:从单个 Amazon 产品页面提取数据。
Oxylabs AI Studio 工具
ai_scraper:使用 AI 驱动的提取功能从任意 URL 抓取内容,支持 JSON、CSV、Markdown 或 TOON 格式;
ai_crawler:根据提示从起始 URL 爬取网站,并跨多个页面收集数据;
ai_browser_agent:根据提示控制真实浏览器——导航、点击、填写表单——并返回结果;
ai_search:搜索网络,并可选择返回每个结果的 Markdown 内容;
ai_map:映射网站的 URL,可按关键词或提示进行过滤;
generate_schema:为上述 AI 工具生成 OpenAPI 格式的 JSON 模式,用于结构化提取。
✅ 前提条件
在开始之前,请确保你拥有以下至少一项:
Oxylabs Web Scraper API 账户:从 Oxylabs 获取你的用户名和密码(提供 1 周免费试用);
Oxylabs AI Studio API 密钥:从 Oxylabs AI Studio 获取你的 API 密钥(提供 1000 个免费积分)。
要在本地运行服务器(下面的选项 2),你还需要 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"📦 配置
有两种使用服务器的方式:连接到托管实例(无需安装)或使用环境变量中的凭据在本地运行。
选项 1:托管服务器(无需安装)
Oxylabs 在以下地址运行托管 MCP 服务器:
https://mcp.oxylabs.io/mcp凭据通过请求标头传递:
凭据 | 标头 |
Web Scraper API |
|
Web Scraper API(替代方案) |
|
AI Studio |
|
使用 Claude Code 进行设置:
claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \
--header "Authorization: Basic $(echo -n 'YOUR_USERNAME:YOUR_PASSWORD' | base64)" \
--header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"使用 Cursor 或任何支持带自定义标头的远程 MCP 服务器的客户端进行设置:
{
"mcpServers": {
"oxylabs": {
"url": "https://mcp.oxylabs.io/mcp",
"headers": {
"Authorization": "Basic <base64 of username:password>",
"X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
}
}
}
}该服务器也列在 Smithery 上。
注意: 仅支持远程服务器 OAuth 的客户端(例如,在 claude.ai Web UI 中添加自定义连接器)尚无法传递标头——OAuth 登录在我们的路线图上。 请暂时在这些客户端上使用下面的本地设置。
选项 2:本地运行
环境变量
Oxylabs MCP 服务器支持以下环境变量:
名称 | 描述 | 默认值 |
| 你的 Oxylabs Web Scraper API 用户名 | |
| 你的 Oxylabs Web Scraper API 密码 | |
| 你的 Oxylabs AI Studio API 密钥 | |
| 返回给客户端的日志的日志级别 |
|
根据提供的凭据,服务器会自动暴露相应的工具:
如果仅提供
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 |
|
Web Scraper API(替代方案) |
|
AI Studio |
|
示例客户端配置:
{
"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 或两者都不选
模拟移动和桌面视口以实现真实渲染
自动清理 HTML 并将其转换为 Markdown,以提高可读性
使用针对 Google、Amazon 等热门目标的自动化解析器
以高成功率导航复杂的自动化请求管理系统
可靠地抓取即使是最复杂的网站
从覆盖 195 多个国家/地区的代理池中获取自动轮换的 IP
如果需要,设置渲染和解析选项
将数据直接输入 AI 模型或分析工具
适用于 macOS、Windows 和 Linux
全面的错误处理和报告
智能速率限制和请求管理
为什么选择 Oxylabs MCP? 🕸️ ➜ 📦 ➜ 🤖
想象一下告诉你的 LLM "总结一下关于 GPT‑5 的最新 Hacker News 讨论" —— 而它直接就能回答。 Oxylabs MCP 服务器通过为你完成繁琐的部分来实现这一点:
Oxylabs MCP 的作用 | 为什么对你很重要 |
使用 Oxylabs 全球代理网络管理自动化请求墙 | 实现网站访问和匿名性 |
在无头 Chrome 中渲染 JavaScript | 单页应用,已排序 |
清理 HTML → Markdown | 直接放入向量数据库或提示中 |
可选的结构化解析器(Google、Amazon 等) | 一键访问热门目标 |
🛡️ 许可证
根据 MIT 许可证分发——有关详细信息,请参阅 LICENSE。
关于 Oxylabs
Oxylabs 成立于 2015 年,是一个市场领先的网络情报收集平台,以最高的业务、道德和合规标准为驱动,帮助全球公司释放数据驱动的洞察力。

mcp-name: io.oxylabs/oxylabs-mcp
Available Tools
10 toolsai_browser_agentCRead-onlyInspect
Run the browser agent and return the data in the specified format.
This tool is useful if you need navigate around the website and do some actions. It allows navigating to any url, clicking on links, filling forms, scrolling, etc. Finally it returns the data in the specified format. Schema is required only if output_format is json, csv or toon. 'task_prompt' describes what browser agent should achieve
Inputs: url (required), task_prompt (required), schema, geo_location, +1 more. Returns: result
ai_crawlerCRead-onlyInspect
Tool useful for crawling a website from starting url and returning data in a specified format.
Schema is required only if output_format is json, csv or toon. 'render_javascript' is used to render javascript heavy websites. 'return_sources_limit' is used to limit the number of sources to return, for example if you expect results from single source, you can set it to 1.
Inputs: url (required), user_prompt (required), schema, geo_location, +3 more. Returns: result
ai_mapDRead-onlyInspect
Tool useful for mapping website's URLs.
Inputs: url (required), limit, user_prompt, geo_location, +5 more. Returns: result
ai_scraperARead-onlyInspect
Scrape the contents of the web page and return the data in the specified format.
Schema is required only if output_format is json or csv. 'render_javascript' is used to render javascript heavy websites.
Inputs: url (required), schema, geo_location, output_format, +1 more. Returns: result
ai_searchARead-onlyInspect
Search the web based on a provided query.
'return_content' is used to return markdown content for each search result. If 'return_content' is set to True, you don't need to use ai_scraper to get the content of the search results urls, because it is already included in the search results. if 'return_content' is set to True, prefer lower 'limit' to reduce payload size.
Inputs: query (required), limit, geo_location, return_content, +1 more. Returns: result
amazon_product_scraperARead-onlyInspect
Scrape Amazon products.
Supports content parsing, different user agent types, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as currency and getting more accurate pricing data with auto select variant.
Inputs: query (required), parse, domain, locale, +6 more. Returns: result
amazon_search_scraperBRead-onlyInspect
Scrape Amazon search results.
Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as category id, merchant id, currency.
Inputs: query (required), pages, parse, domain, +9 more. Returns: result
generate_schemaCRead-onlyInspect
Generate a json schema in openapi format.
Inputs: app_name (required), user_prompt (required). Returns: result
google_search_scraperARead-onlyInspect
Scrape Google Search results.
Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats.
Inputs: query (required), limit, pages, parse, +8 more. Returns: result
universal_scraperBRead-onlyInspect
Get a content of any webpage.
Supports browser rendering, parsing of certain webpages and different output formats.
Inputs: url (required), render, geo_location, output_format, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Several tools have heavily overlapping purposes: ai_scraper and universal_scraper both claim to scrape any webpage content, while ai_crawler and ai_browser_agent both navigate websites and extract data. ai_search and google_search_scraper also cover similar territory, making selection ambiguous without very careful reading.
Names are descriptive and readable, but they follow two different conventions: an ai_ prefix group (ai_crawler, ai_scraper, ai_search, ai_map, ai_browser_agent) and a target_suffix group (google_search_scraper, amazon_search_scraper, amazon_product_scraper, universal_scraper). Only generate_schema stands apart with a clear verb_noun pattern.
Ten tools is well-scoped for a web scraping and search server covering generic scraping, search, browser automation, URL mapping, schema generation, and Amazon-specific extraction. Each tool represents a distinct product capability, even if some overlap exists.
The tool surface covers the core needs of the domain: general search, Google-specific search, generic page scraping, crawling, browser-driven interaction, site mapping, and Amazon search/product scraping. There are no obvious dead ends for common web data acquisition workflows.
Maintenance
Related MCP Connectors
Fetch and extract data from any public web page, even JS-rendered or anti-bot protected
Scraping API for Google Search, Maps, Flights, Jobs, YouTube, LinkedIn, Trustpilot and more.
Oxylabs MCP — Oxylabs Web Scraper API (oxylabs.io)
Scrape any website, extract structured data, and collect web content at scale with AI agents
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables web scraping and document processing with JavaScript execution, anti-detection measures, batch processing, and structured data extraction. Supports multiple formats including markdown, HTML, screenshots, and handles PDFs with OCR capabilities.44 PyPI4MIT
- AlicenseAqualityBmaintenanceEnables web scraping and data extraction from websites with geographic flexibility, privacy features, and anti-detection capabilities. Supports scraping general websites, Google Search, Amazon Search, and Reddit with customizable parameters for rendering, geolocation, and locale.33859 npm41ISC
- AlicenseAqualityDmaintenanceEnables AI agents to scrape any website by providing tools for JavaScript rendering, antibot bypass, and automatic captcha solving. It supports synchronous, asynchronous, and batch scraping operations with built-in proxy rotation.535 PyPIMIT
- AlicenseAqualityAmaintenanceEnables web scraping, structured data extraction, and screenshot capture with automatic anti-bot bypass, supporting JavaScript rendering, proxy rotation, and tiered pricing.262,618 npm2MIT