Oxylabs MCP Server
Official
📖 개요
Oxylabs MCP 서버는 AI 모델과 웹 사이의 다리 역할을 합니다. 이를 통해 모든 URL을 스크래핑하고, JavaScript가 많이 사용된 페이지를 렌더링하며, AI 사용을 위한 콘텐츠를 추출하고 형식화하며, CAPTCHA를 관리하고, 195개 이상의 국가에서 지역 제한 웹 데이터에 액세스할 수 있습니다.
이 서버는 AI 어시스턴트를 외부 도구 및 데이터에 연결하기 위한 개방형 표준인 Model Context Protocol (MCP)을 기반으로 구축되었습니다.
Related MCP server: Decodo MCP Server
🛠️ MCP 도구
Oxylabs MCP는 함께 또는 독립적으로 사용할 수 있는 두 가지 도구 세트를 제공합니다:
Oxylabs Web Scraper API 도구
universal_scraper: 선택적 JavaScript 렌더링, 지역 타겟팅, Markdown/HTML/링크 출력과 함께 모든 URL을 스크래핑합니다;
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 웹 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 streamable-HTTP 전송도 지원합니다. 다음으로 시작하세요:
MCP_TRANSPORT=streamable-http MCP_HOST=0.0.0.0 MCP_PORT=8000 uvx oxylabs-mcpHTTP 전송을 사용하면 자격 증명이 환경 변수 대신 요청별로 전달됩니다:
자격 증명 | 전달 방법 |
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 정리 | 벡터 DB 또는 프롬프트에 바로 투입 |
선택적 구조화 파서 (Google, Amazon 등) | 인기 대상에 대한 원클릭 액세스 |
🛡️ 라이선스
MIT 라이선스에 따라 배포됩니다 – 자세한 내용은 LICENSE를 참조하세요.
Oxylabs 소개
2015년에 설립된 Oxylabs는 최고 수준의 비즈니스, 윤리 및 규정 준수 표준을 기반으로 하는 시장 선도적인 웹 인텔리전스 수집 플랫폼으로, 전 세계 기업이 데이터 기반 인사이트를 확보할 수 있도록 지원합니다.

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