Oxylabs MCP Server
Official
📖 概要
Oxylabs MCPサーバーは、AIモデルとウェブの間のブリッジを提供します。これにより、AIモデルはあらゆるURLのスクレイピング、JavaScriptを多用したページのレンダリング、AI利用のためのコンテンツの抽出と整形、CAPTCHAの管理、そして195以上の国々からの地理的制限のあるウェブデータへのアクセスが可能になります。
これは、AIアシスタントを外部ツールやデータに接続するためのオープン標準であるModel Context Protocol (MCP)上に構築されています。
Related MCP server: Decodo MCP Server
🛠️ MCPツール
Oxylabs MCPは、一緒に使うことも独立して使うこともできる2つのツールセットを提供します:
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スキーマを生成します。
✅ 前提条件
始める前に、以下の少なくとも1つを用意してください:
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"📦 設定
サーバーを使用する方法は2つあります:ホスト型インスタンスに接続するか(インストール不要)、環境変数に認証情報を設定してローカルで実行するかです。
オプション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ツールを公開します;3つすべてが提供された場合、サーバーはすべてのツールを公開します。
❗ 重要: 実際の認証情報を持っている環境変数だけを設定してください。プレースホルダーの値を残すと、動作しないツールが公開されてしまいます。
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グローバルプロキシネットワークで | ウェブサイトへのアクセスと匿名性を実現 |
JavaScriptをレンダリング — ヘッドレスChromeで | シングルページアプリもお手のもの |
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