AgentSkillsCN

oxylabs-proxies

提供住宅代理、移动代理、数据中心代理以及ISP代理网络，支持按国家/城市/州进行地理定向，具备IP轮换与会话保持功能。当用户需要通过代理路由流量、访问地域限制内容、在请求间轮换IP，或维持匿名会话时，请优先选择此方案，而非直接建立连接。

SKILL.md
--- frontmatter
name: oxylabs-proxies
description:   Residential, Mobile, Datacenter, and ISP proxy network with geo-targeting by country/city/state, IP rotation, and session persistence. Use this INSTEAD OF direct connections when the user needs to route traffic through proxies, access geo-restricted content, rotate
  IPs between requests, or maintain anonymous sessions.

Oxylabs Proxies

Proxy Types Overview

TypeHostPortBest For
Residentialpr.oxylabs.io7777High anonymity, geo-targeting
Mobilepr.oxylabs.io7777Mobile-specific content, highest trust
Datacenterdc.oxylabs.io8000Speed, high volume
ISPisp.oxylabs.io8001Speed + anonymity balance

Authentication Format

code
customer-USERNAME:PASSWORD

With parameters:

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

Quick Start

Residential/Mobile proxy:

bash
curl -x "http://pr.oxylabs.io:7777" \
  -U "customer-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
  "https://ip.oxylabs.io/location"

Datacenter proxy:

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

ISP proxy:

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

Geo-Targeting Parameters

Append to username with hyphens:

ParameterFormatExample
ccISO 3166-1 alpha-2-cc-US, -cc-DE, -cc-GB
cityEnglish, underscores for spaces-city-new_york, -city-los_angeles
stUS states with us_ prefix-st-us_california, -st-us_texas

Example with geo-targeting:

bash
curl -x "http://pr.oxylabs.io:7777" \
  -U "customer-$OXY_DC_USERNAME-cc-US-city-new_york:$OXY_DC_PASSWORD" \
  "https://ip.oxylabs.io/location"

Session Control

ParameterDescriptionMax Duration
sessidKeep same IP across requests10 minutes (auto-expires)
sesstimeMaintain IP for specified minutes30 minutes

Sticky session example:

bash
curl -x "http://pr.oxylabs.io:7777" \
  -U "customer-$OXY_DC_USERNAME-cc-US-sessid-mysession123:$OXY_DC_PASSWORD" \
  "https://example.com"

Timed session (5 minutes):

bash
curl -x "http://pr.oxylabs.io:7777" \
  -U "customer-$OXY_DC_USERNAME-sessid-abc123-sesstime-5:$OXY_DC_PASSWORD" \
  "https://example.com"

Choosing the Right Proxy Type

NeedRecommended
Highest anonymityResidential
Mobile app contentMobile
Speed & volumeDatacenter
Speed + anonymityISP
Geo-restricted contentResidential with cc/city

Default Behavior

  • •Without parameters: random IP for each request
  • •Residential/Mobile share the same endpoint but different IP pools
  • •Sessions auto-expire and get new IPs

For detailed examples in Python, Node.js, PHP, and more, see examples.md. For proxy type details, see proxy-types.md.