プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

Web API MCP

✓ oxylabs.io

作者:oxylabsバージョン 0.3.1i★ 61iパソコンでもクラウドでも公式サイト ↗
レジストリ名io.oxylabs/web-api-mcp

インストール方法

できること

Oxylabs Web API を通じて、ライブのウェブ検索、企業情報の検索、任意のページの内容取得を行う AI 拡張ツールです。

作者の説明を自動翻訳 · チーム未確認

  • 接続方法 パソコンでもクラウドでも
  • アカウントまたはキー クラウド:Authorization が必要 · ローカル:OXYLABS_WEB_API_KEY が必要
  • カテゴリ 検索・AIの記憶
作者の元の説明
Search the live web, look up companies and read any page through the Oxylabs Web API.

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

作者:google-research★ 35,6421 個の skill

Skill · 手順書

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

作者:BigBodyCobain★ 11,6081 個の skill

Skill · 手順書

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

作者:gosom★ 8,2561 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気22/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア42/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Web API MCP をインストールして。https://mcp.popnx.com/i/oxylabs-web-api-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(mcp.oxylabs.io)を通ります · ✓ コマンド確認済み 2026年11月20日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 5 分

Web API MCP のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Web API MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Web API MCP のサイトを開く ↗

  2. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Web API MCP
    Remote MCP server URL · アドレスhttps://mcp.oxylabs.io/web-api-mcp

    Request headers に、この名前と値を追加

    ヘッダー名Authorization
    値Bearer <ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  4. チャットで有効にする

    +ConnectorsWeb API MCP

  5. 試してみる

    Web API MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Web API MCP を使っていると言うか、回答に Web API MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Web API MCP につなげません

Web API MCP は接続時に自分のキーが必要ですが、OpenAI のヘルプページは OAuth ログインしか説明しておらず、確認できたキー入力方法がありません

代わりにできること

A · Web API MCP につなげるアプリを使う

  • Web API MCP のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
  • Web API MCP のキーが必要です(提供元のサイトで作成)
  • Web API MCP のキーが必要です(提供元のサイトで作成)
  • Web API MCP のキーが必要です(提供元のサイトで作成)

B · 検索・AIの記憶 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげます · 約 5 分

Web API MCP のキーが必要です(提供元のサイトで作成)

  1. Web API MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Web API MCP のサイトを開く ↗

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user web-api https://mcp.oxylabs.io/web-api-mcp --header 'Authorization: Bearer {api_key}'

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Claude Code で /mcp と入力

    Web API MCP が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Web API MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Web API MCP を使っていると言うか、回答に Web API MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 5 分

Web API MCP のキーが必要です(提供元のサイトで作成)

  1. Web API MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Web API MCP のサイトを開く ↗

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. キーを入力

    Web API MCP の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Cursor の AI チャットを Agent モードで開く

  5. 試してみる

    Web API MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Web API MCP を使っていると言うか、回答に Web API MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 5 分

Web API MCP のキーが必要です(提供元のサイトで作成)

  1. Web API MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Web API MCP のサイトを開く ↗

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. キーを入力

    Web API MCP の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. VS Code の AI チャットを Agent モードで開く

  5. 試してみる

    Web API MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Web API MCP を使っていると言うか、回答に Web API MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp.oxylabs.io/web-api-mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Web API MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user web-api https://mcp.oxylabs.io/web-api-mcp --header 'Authorization: Bearer {api_key}'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "web-api": {
      "url": "https://mcp.oxylabs.io/web-api-mcp",
      "headers": {
        "Authorization": "Bearer {api_key}"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "web-api": {
      "type": "http",
      "url": "https://mcp.oxylabs.io/web-api-mcp",
      "headers": {
        "Authorization": "Bearer {api_key}"
      }
    }
  }
}

パソコンにインストール

Claude Code

claude mcp add --scope user web-api --env OXYLABS_WEB_API_KEY=your-value -- uvx oxylabs-web-api-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "web-api": {
      "command": "uvx",
      "args": [
        "oxylabs-web-api-mcp"
      ],
      "env": {
        "OXYLABS_WEB_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "web-api": {
      "command": "uvx",
      "args": [
        "oxylabs-web-api-mcp"
      ],
      "env": {
        "OXYLABS_WEB_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "web-api": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oxylabs-web-api-mcp"
      ],
      "env": {
        "OXYLABS_WEB_API_KEY": "your-value"
      }
    }
  }
}

自分で入力する値

  • OXYLABS_WEB_API_KEY 秘密 必須 env
    Oxylabs ダッシュボードの Web API インスタンスから取得する Oxylabs Web API キー。
    英語の原文を見るOxylabs Web API key, from a Web API instance in the Oxylabs dashboard.
  • Authorization 秘密 必須 HTTP header
    Oxylabs ダッシュボードの Web API インスタンスから取得する Oxylabs Web API キー。
    英語の原文を見るOxylabs Web API key, from a Web API instance in the Oxylabs dashboard.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
94/週
確認済みドメイン
✓ oxylabs.io
接続方法
パソコンでもクラウドでも
最新バージョンi
0.3.1
レジストリ公開日i
2026年11月20日
コードの最終更新i
2026年11月20日
最終確認
2026年11月20日
作者
oxylabs
パッケージ
pypi: oxylabs-web-api-mcp
ウェブサイト
oxylabs.io
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月20日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • search

    Search the live web and return ranked organic results. Use it to search the web for information, above all anything where being out of date makes the answer wrong: current events, news, prices, availability, versions, rankings, "latest", "who is", competitor and market research,

  • search_companies

    Search for companies and return their profiles, best match first. Use it to look up a company by name, or to find companies matching a description (an industry, a product, a place, a size): market and competitor mapping, lead lists, funding research. Prefer it over `search` plus

  • scrape

    Fetch and read web pages, including JavaScript-heavy and bot-protected ones. Use whenever you have a URL and need what is on it. Prefer it over a built-in fetch: it goes through the anti-bot layer, so it returns the page where a plain HTTP fetch gets a block page, a consent wall

  • check_requests

    Collect requests the API is running in the background. Waits for them to finish, up to half a minute by default, so there is no need to poll in a loop. Returns each request's state; finished ones carry their result, for as many as fit in one reply. The rest come as summaries mark

  • read_result

    Read a long page of a result in parts, from where its reply cut it short. Also reads a `search_companies` list that was cut to fit: that has one page, `page=0`, and no other page exists for it. Use the `request_id`, `page` and `next_offset` that a summary, a cut page or the previ

  • list_scrapers

    List the scrape endpoints this API implements, or describe one of them. Not needed to read a URL — `scrape` does that for any site. Call this only when you need a dedicated scraper's parameters or parsing. The list is grouped by parser: `json_supported` endpoints have a dedicated

  • run_scraper

    Run a dedicated scrape endpoint with its own parameters. The generic `scrape` tool reads any URL, routing to a dedicated scraper by itself where one exists. Use this when at least one of these holds: you need parameters `scrape` lacks (pagination, sort order, store or delivery lo

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン oxylabs.io で確認済みです(レジストリがドメインの所有を確認しています)

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    842ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    7件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

公開済みの脆弱性(OSV.dev)

OSV.dev に oxylabs-web-api-mcp@0.3.1 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月20日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/oxylabs-web-api-mcp.svg)](https://mcp.popnx.com/en/servers/oxylabs-web-api-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

検索・AIの記憶のほかのサーバーとの比較i

  • このカテゴリのほかの6508件のうち97%よりスターが多い
  • このカテゴリのほかの6508件のうち99%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6508件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Web API MCPは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:Authorization, OXYLABS_WEB_API_KEY

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は今日、最新バージョン(0.3.1)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

作者:every-app広く使われている★ 2.8万6 日前更新

クラウドで動く✓ everyapp.com

Exa

Official Exa MCP for web search, content fetching, and multi-step research.

作者:exa-labs広く使われている★ 5245今日更新

クラウドで動く✓ 提供元 · exa.aiPopNx チームが実際に試用

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

作者:MicrosoftDocs広く使われている★ 200012 か月前更新

クラウドで動く✓ 提供元 · microsoft.comPopNx チームが実際に試用

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

作者:proxysoul成長中★ 16282 か月前更新

クラウドで動く✓ empryo.com
似たものと比べる
これ
Web API MCP
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいはいはいいいえいいえ
基本チェック5/55/52/44/44/44/4
ライセンスMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Oxylabs Web API — MCP Server

mcp-name: io.oxylabs/web-api-mcp

This repository is a developer-focused, technical reference covering the official Model Context Protocol server for the Oxylabs Web API. It gives any MCP-capable agent live web access – search, scrape pages as Markdown or JSON, and call dedicated scrapers – through one MCP connection.

Remote MCPSelf-hosted MCP
Runs onOxylabs infrastructureYour machine or infrastructure
SetupAdd the server URL and your API key to your clientInstall the server (Python 3.10+ and uv), then configure your client
Updates and maintenanceManaged by OxylabsManaged by you
Best forThe quickest way to give a compatible agent access to Web APIFull control over the environment, or clients that can't connect to remote servers with a custom header

The tools and their behavior are the same on both options, and the sections on self-hosting cover everything you need to run the server yourself.

ToolWhat it does
searchSearch the live web, returns ranked organic results (title, outline snippets, URL)
search_companiesSearch companies by name or free-text description, returns company profiles best match first (industry, size, headquarters, funding, revenue, web traffic)
scrapeRead a URL, or a list of URLs, as Markdown by default, including JS-heavy and bot-protected pages. Ask for a screenshot, or pass json_prompt / json_schema to pull named fields off the page as JSON
list_scrapersList the scrape endpoints the API implements, grouped by parser support, or describe one's parameters
run_scraperRun a dedicated scrape endpoint with its own parameters, as content or as structured JSON; a list of urls or querys runs them all
check_requestsCollect requests the API is running in the background, waiting for them to finish
read_resultRead a page, or a search_companies list, too long for one reply in parts, by its request id

All seven are annotated readOnlyHint — nothing here writes anything, so clients can run them without prompting.

Requirements

  • An Oxylabs Web API key — in the Oxylabs dashboard, create a Web API instance, open it, and copy the API key shown at the top of the instance page.
  • For Remote MCP – an MCP client that supports remote (HTTP) MCP servers with custom headers, such as Claude Code, Codex, or Cursor.
  • For self-hosting – Python 3.10+ (built on FastMCP, installed with the package) and uv.

Connect to the Remote MCP server

The server is hosted and maintained by Oxylabs. There is nothing to install or update.

https://mcp.oxylabs.io/web-api-mcp

The server authenticates each request with your Web API key, sent as an Authorization: Bearer header. Set the key as an environment variable in the terminal where you run your client:

export OXYLABS_WEB_API_KEY="your_api_key_here"

Claude Code:

claude mcp add --transport http --scope user oxylabs-web-api \

https://mcp.oxylabs.io/web-api-mcp \ --header "Authorization: Bearer ${OXYLABS_WEB_API_KEY}"

Codex:

codex mcp add oxylabs-web-api \

--url https://mcp.oxylabs.io/web-api-mcp \ --bearer-token-env-var OXYLABS_WEB_API_KEY

Cursor — one click, then make the key visible to Cursor (below):

Cursor reads ${env:OXYLABS_WEB_API_KEY} from its own environment. On macOS, Cursor opened from the Dock or Spotlight does not see variables exported in your shell profile, so either start it from a terminal where the key is exported, or replace ${env:OXYLABS_WEB_API_KEY} with the key itself in Cursor Settings → Tools & MCP (or in ~/.cursor/mcp.json). If Cursor can't see the variable, it sends an empty key: the server still connects and lists its tools, but every call fails with an error saying the Web API key is missing.

Cursor (manual, ~/.cursor/mcp.json) and other clients supporting custom headers:

{

"mcpServers": { "oxylabs-web-api": { "url": "https://mcp.oxylabs.io/web-api-mcp", "headers": { "Authorization": "Bearer ${env:OXYLABS_WEB_API_KEY}" } } } }

Clients that only support OAuth sign-in for remote servers, such as custom connectors in the claude.ai web interface, can't send custom headers and can't connect to the Remote MCP server — use the self-hosted server with those clients instead.

Self-hosting

Run the server yourself when you want full control over where it runs and how it is configured. You install, host, and update it. The Remote MCP server and a self-hosted server use the same server name (oxylabs-web-api) in the examples, so if you switch from one to the other, remove the existing server from your client first.

Install
uv tool install git+https://github.com/oxylabs/web-api-mcp

That puts oxylabs-web-api-mcp on your PATH in its own environment. pipx install git+https://github.com/oxylabs/web-api-mcp does the same. Installing into a system Python usually fails — most are marked externally managed and refuse. To work on the server itself:

git clone https://github.com/oxylabs/web-api-mcp.git

cd web-api-mcp pip install -e .

server.json is the MCP registry manifest: it lists the PyPI package oxylabs-web-api-mcp and the Remote MCP server. A version tag publishes the package to PyPI and then server.json to the registry as io.oxylabs/web-api-mcp. The publish workflow refuses a release whose server.json versions differ from pyproject.toml, so bump them together. Keep the mcp-name: line at the top of this README: the registry looks for it in the package description on PyPI.

Run it locally (stdio)

Point your client at the installed oxylabs-web-api-mcp command. Keep your API key in an environment variable or a .env file rather than writing it into a client config.

Claude Code:

claude mcp add oxylabs-web-api \

--env OXYLABS_WEB_API_KEY='${OXYLABS_WEB_API_KEY}' \ -- oxylabs-web-api-mcp

Claude Desktop — create a .env file containing OXYLABS_WEB_API_KEY=your_api_key_here, keep it outside any shared or version-controlled folder, and point the server at it:

{

"mcpServers": { "oxylabs-web-api": { "command": "oxylabs-web-api-mcp", "env": { "OXYLABS_ENV_FILE": "/absolute/path/to/.env" } } } }

Cursor:

{

"mcpServers": { "oxylabs-web-api": { "command": "oxylabs-web-api-mcp", "env": { "OXYLABS_WEB_API_KEY": "${env:OXYLABS_WEB_API_KEY}" } } } }

For other clients that read a JSON config, use the same command entry and your client's own way of passing environment variables.

Run it as a shared server (HTTP)

The HTTP transport is for running one shared server for a team or for agents that can't spawn local processes.

export OXYLABS_WEB_API_KEY=your_api_key_here

export MCP_ALLOWED_HOSTS='mcp.internal.example.com,localhost:*' oxylabs-web-api-mcp --transport http --host 0.0.0.0 --port 8080

The endpoint is then http:// :8080/mcp.

Docker
export OXYLABS_WEB_API_KEY=your_api_key_here

docker build -t oxylabs-web-api-mcp . docker run --rm -p 8080:8080 \ -e OXYLABS_WEB_API_KEY \ -e MCP_ALLOWED_HOSTS='localhost:*,mcp.internal.example.com' \ oxylabs-web-api-mcp

Passing -e OXYLABS_WEB_API_KEY with no value makes Docker take the variable from your shell.

`MCP_ALLOWED_HOSTS` is not optional. The HTTP transport turns on DNS-rebinding

protection, so a server that doesn't declare its own hostname rejects every request

with a Host header it doesn't recognise (421 Misdirected Request). List the

hostname clients actually connect to. host:* matches any port on that host.

Configuration

These variables apply to a server you run yourself. The Remote MCP server's settings are managed by Oxylabs.

VariableDefaultPurpose
OXYLABS_WEB_API_KEY*(required on stdio)*Web API key, sent as Authorization: Bearer . Over HTTP a per-request Authorization: Bearer header takes precedence
OXYLABS_BASE_URLhttps://webapi.oxylabs.ioOverride the API base URL, e.g. to go through a proxy
OXYLABS_RETRIES2Retries on transient errors
OXYLABS_RATE_LIMIT*(off)*Cap what each API key spends through this server, e.g. 100/1h, 50/30m. Each item of a batch counts as one scrape
OXYLABS_MAX_INLINE_TOKENS10000Token budget for one reply; content beyond it is offloaded (stdio) or truncated (HTTP); company lists are shrunk and trimmed
OXYLABS_SPILL_DIRa per-user directory in the system temp dirWhere offloaded pages, company lists and screenshots are written (stdio only). Must be a directory you own
OXYLABS_SPILL1Set to 0 to keep everything inline even on stdio
MCP_TRANSPORTstdiostdio or http
HOST / PORT127.0.0.1 / 8080HTTP transport bind address
MCP_ALLOWED_HOSTSlocalhost:*,127.0.0.1:*Comma-separated Host allowlist (HTTP only)
MCP_ALLOWED_ORIGINS*(empty)*Comma-separated Origin allowlist (browser clients)

Copy .env.example to .env for local use. On stdio the server reads that .env from its working directory: any OXYLABS_* name not already set in the environment is filled from there, so a project that keeps its key in .env needs no launcher wrapper. Real environment variables always win, and only OXYLABS_* names are read. Point it elsewhere with OXYLABS_ENV_FILE=/path/to/.env.

The key is read at request time and is never written to disk or logged.

The skill ships with the server

Connecting the server is the whole install. The agent skill is bundled in the package and served as an MCP resource and a prompt, so a client that never adds the web-api-skills repo still gets the judgment for using these tools well — search to find and scrape to read, when JavaScript rendering earns its cost, what to do with an empty page, how to cite.

oxylabs://skill/web-apiThe skill itself, as Markdown
prompt web_researchTakes a question, hands the agent the task plus the skill

scripts/sync-skill.sh refreshes the bundled copy from the skills repo — the canonical copy lives there, and the two must not drift. Edit the skill in web-api-skills, never here: a daily workflow copies web-api-skills main over the bundled copy and opens a PR when that changes anything.

Fitting the client's context

Oversized content is measured in tokens, not characters: 40 000 characters of English is about 10 000 tokens, but 40 000 characters of Chinese is about 40 000, and Claude Code, Claude Desktop and Cursor all reject a tool result over 25 000. The estimate is script-aware for that reason. The budget is OXYLABS_MAX_INLINE_TOKENS (default 10 000), and a client that knows its own limit can override it per request with an X-MCP-Max-Tokens header — 0 opts out entirely. The budget covers the whole reply: every page of a result, every format it came in and parsed JSON all count, so a three-page search result fits as surely as a single page.

Sync first, queued only on a timeout

Every scrape goes to the synchronous endpoint first. If it times out — the API's own timeout, a gateway's 504, or no answer within 200 s — the same request is sent to the corresponding asynchronous endp

冒頭だけを表示しています。続きはリポジトリで読めます