mcpField
P
proxies

proxies

github.com/oxylabsクラウド・DevOps87783 回インストール2 週間前に更新
リポジトリ

proxies について

proxies は Oxylabs プロキシの設定ガイドです。住宅、モバイル、データセンター、ISP、専用プロキシを必要とするユーザー向けに、接続プロトコル、地域指定、認証、セッション制御を説明します。

主な機能

  1. 01共有および専用プロキシの設定
  2. 02HTTP、HTTPS、SOCKS5、HTTP/3 に対応
  3. 03国、都市、州、郵便番号による指定
  4. 04セッションパラメーターによる IP の維持と固定
  5. 05ポートによるローテーション IP と固定 IP の選択

活用シーン

  1. 01リクエストに適したプロキシとプロトコルの選択
  2. 02プロキシ通信の対象地域の指定
  3. 03リクエスト間のセッション維持や固定 IP の利用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/oxylabs/agent-skills --skill proxies

インストール後、Claude Code で/proxiesを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

dedicated-datacenter.md
dedicated-isp.md
examples.md
proxy-types.md

詳細

Oxylabs プロキシ

プロキシタイプの概要

タイプホストポート最適な用途
レジデンシャルpr.oxylabs.io7777高い匿名性、地域ターゲティング
モバイルpr.oxylabs.io7777モバイル固有のコンテンツ、最高レベルの信頼性
データセンター（共有）dc.oxylabs.io8000 ローテーション / 8001+ 割り当て／固定高速、大量処理
ISP（共有）isp.oxylabs.io8000 ローテーション / 8001+ 割り当て／固定高速性と匿名性のバランス
専用データセンターddc.oxylabs.io8000 ローテーション / 8001+ 割り当て／固定所有 IP、ポートベースのアクセス
専用 ISPdisp.oxylabs.io8000 ローテーション / 8001+ 割り当て／固定所有する ISP IP、ASN 固定

レジデンシャル／モバイルでは、ユーザー名のセッションパラメーターとともに pr.oxylabs.io:7777 を使用します。データセンター／ISP および専用セルフサービス製品では、割り当て済み／固定 IP 用のプロキシリストポートは 8001 から始まり、自動ローテーションには 8000 を使用します。

環境変数

対象のプロキシ製品ファミリーの認証情報を使用してください。

製品ファミリー変数ユーザー名のプレフィックス
レジデンシャル、モバイルOXY_RES_USERNAME、OXY_RES_PASSWORDcustomer-
データセンター、ISP、専用データセンター、専用 ISPOXY_DC_USERNAME、OXY_DC_PASSWORDセルフサービス／共有では user-

認証形式

customer-USERNAME:PASSWORD    # Residential, Mobile
user-USERNAME:PASSWORD          # Shared Datacenter, Shared ISP

専用プロキシの認証（セルフサービスとエンタープライズ）については、dedicated-datacenter.md と dedicated-isp.md を参照してください。

レジデンシャル／モバイル（OXY_RES_USERNAME、OXY_RES_PASSWORD）とデータセンター／ISP（OXY_DC_USERNAME、OXY_DC_PASSWORD）には、それぞれ別の認証情報を使用してください。

パラメーターを指定する場合：

customer-USERNAME-cc-US-city-new_york-sessid-abc123:PASSWORD

クイックスタート

レジデンシャル／モバイルプロキシ：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME:$OXY_RES_PASSWORD" \
  "https://ip.oxylabs.io/location"

データセンタープロキシ：

curl -x "dc.oxylabs.io:8000" \
  -U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
  "https://ip.oxylabs.io/location"

ISP プロキシ：

curl -x "isp.oxylabs.io:8001" \
  -U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
  "https://ip.oxylabs.io/location"

データセンター、ISP、専用データセンター、専用 ISP のプロキシでは、ダッシュボードのプロキシリストにある 8001 から始まるポートを、割り当て済み／固定 IP 用に使用してください。リストの先頭にある IP には 8001 を使用します。タスクで自動ローテーションが必要な場合に限り、ポートを 8000 に切り替えてください。

プロトコル（レジデンシャル）

プロトコルトランスポートエントリーポイント使用する場面
HTTPTCPpr.oxylabs.io:7777デフォルトです。一般的なライブラリやサードパーティ製ソフトウェアでサポートされています
HTTPSTCPhttps://pr.oxylabs.io:7777プロキシへの接続が完全に暗号化されます
SOCKS5TCP and UDPsocks5h://pr.oxylabs.io:7777クライアントが SOCKS5 を必要とする場合
HTTP/3(MASQUE) UDP (QUIC)masque.oxylabs.io:50000ネイティブ HTTP/3、UDP、UDP 経由の DNS、WebRTC／SIP／ゲームのトラフィック

標準的な HTTP または HTTPS（TCP）リクエストだけが必要な場合は、メインエンドポイント pr.oxylabs.io:7777 を使用してください。MASQUE では QUIC 接続の確立に伴うオーバーヘッドが発生するため、UDP またはネイティブ HTTP/3 トランスポートが必要な場合にのみ使用する価値があります。

UDP 接続経由では、Google は制限対象です（MASQUE と SOCKS5 UDP に適用されます）。

地域ターゲティングパラメーター

レジデンシャル／モバイルでは、特に記載がない限り、ユーザー名にハイフンでパラメーターを追加します。

パラメーター形式例
ccISO 3166-1 alpha-2-cc-US、-cc-DE、-cc-GB
city英語、スペースはアンダースコアに置き換え-city-new_york、-city-los_angeles
stus_ プレフィックス付きの米国の州-st-us_california、-st-us_texas
postalcode米国の 5 桁 ZIP コード。cc-US と組み合わせます-cc-US-postalcode-90210
ASNレジデンシャル／モバイルのキャリア ASN-ASN-21928
X-Oxylabs-Geolocationプロキシヘッダー lat:lon;radius_miles49.9235:-97.0811;10

ZIP コードによるターゲティングは米国のみです。座標の半径は 10 マイル未満にできません。国と ASN の両方を指定した場合は、国が適用されます。

地域ターゲティングの例：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME-cc-US-city-new_york:$OXY_RES_PASSWORD" \
  "https://ip.oxylabs.io/location"

共有データセンター／ISP の国別ローテーションには、ローテーションポートで user- 認証情報とともに -country-US を使用してください。

セッション制御

パラメーター説明備考
sessidリクエスト間で同じ IP を維持します標準セッションは 10 分、または無操作状態が 60 秒続くまでです
sessid_oneipセッションを特定の出口ノード 1 つに固定しますその IP が利用できなくなると 502 を返します
sesstimesessid または sessid_oneip を使って、セッション時間を分単位で設定しますResidential のバックコネクトは最大 1440 分に対応しています。一部のエントリーモードでは、より短い時間に制限されます

スティッキーセッションの例：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME-cc-US-sessid-mysession123:$OXY_RES_PASSWORD" \
  "https://example.com"

時間指定セッション（5 分）：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME-sessid-abc123-sesstime-5:$OXY_RES_PASSWORD" \
  "https://example.com"

適切なプロキシタイプの選び方

ニーズ推奨
最高レベルの匿名性Residential
モバイルアプリのコンテンツMobile
速度とデータ量Datacenter
速度と匿名性ISP
所有権のある専用 IPDedicated Datacenter または Dedicated ISP
地域制限のあるコンテンツcc／city／postalcode を指定した Residential／Mobile、または適切な場合は国／割り当て済みポートで指定した DC／ISP

デフォルトの動作

  • パラメーターを指定しない場合：リクエストごとにランダムな IP を使用します
  • Residential／Mobile は同じエンドポイントを共有しますが、IP プールは異なります
  • セッションは自動的に期限切れになり、新しい IP が割り当てられます

その他のリソース

コメント

Markdown 対応