proxlane

@proxlane/sdk

AI エージェントに、失敗を正直に伝える Web 取得ツールを提供する MCP サーバーです。

通常の fetch では、本文に CAPTCHA が含まれた状態でエージェントに 200 が返され、エージェントは CAPTCHA の内容を要約してしまいます。このツールは、お使いの Proxlane ゲートウェイ経由で取得し、スクレイピング API を切り替えながら、すべてのレスポンスにブロックページが含まれていないか確認します。エージェントには、読み取り可能なテキストとしてページが返されるか、何が起きたか、再試行する価値があるかを示すエラーが返されます。ブロックページがコンテンツとして返されることはありません。

セットアップ

プロバイダーキーを少なくとも1つ設定した、稼働中のゲートウェイが必要です。コンテナは1つだけです： proxlane.dev/docs/quickstart。

次に、MCP クライアントにサーバーを追加します。Claude Code：

claude mcp add proxlane --env PROXLANE_URL=http://localhost:8787 --env PROXLANE_API_KEY=your-gateway-key -- npx -y @proxlane/[email protected]

Claude Desktop、Cursor、その他のクライアントでは、JSON 設定で同じ3項目を指定します：

{
  "mcpServers": {
    "proxlane": {
      "command": "npx",
      "args": ["-y", "@proxlane/[email protected]"],
      "env": {
        "PROXLANE_URL": "http://localhost:8787",
        "PROXLANE_API_KEY": "your-gateway-key"
      }
    }
  }
}

PROXLANE_API_KEY はゲートウェイ自体のキーであり、プロバイダーのキーではありません。プロバイダーキーはゲートウェイ上に保持されます。上記のように、バージョンを固定してください。固定しない場合、npx -y はその環境変数に設定されたキーを使って、公開済みの最新バージョンを実行します。

呼び出しごとにプロバイダーのクレジットを消費します。render または wait_for を使うと、消費量は数倍になります。このツールは意図的に読み取り専用としてマークされていないため、読み取り専用ツールを自動承認するクライアントでも、毎回確認が求められます。

ツール

fetch_page

引数
url	必須	http または https
render	任意	JavaScript を先に実行します。コストは数倍になります
wait_for	任意	待機する CSS セレクターです。指定すると render も有効になり、要素が表示されない場合、ページ取得は失敗します
country	任意	2文字のコード。例：us
format	text（デフォルト）または html
max_chars	デフォルトは20000	長い結果は切り詰められ、その旨が示されます

失敗時には、結果にエラーのマークが付き、次のように表示されます：

{ "ok": false, "outcome": "SOFT_BLOCK", "class": "blocked", "retryable": true, "chain": "scraperapi:SOFT_BLOCK>brightdata:SOFT_BLOCK" }

class は6種類のいずれかで、種類が増えることはありません。retryable は class に応じて決まります。サイト側の応答（target）や不正なリクエスト（client）は再試行する価値がありませんが、ブロックやプロバイダーの問題は、後であれば再試行する価値がある場合があります。ゲートウェイはすでに利用可能なすべてのプロバイダーを試しているため、すぐに再試行する意味はありません。

独自のプロセスでの使用

import { createServer } from '@proxlane/sdk';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

await createServer({ gatewayUrl: 'http://localhost:8787', apiKey: process.env.PROXLANE_API_KEY! })
	.connect(new StdioServerTransport());

Apache-2.0。