proxies

Name: proxies
Author: oxylabs

317stars1forks

How to install proxies?

oxylabs/agent-skills/proxies

$npx -y skills add oxylabs/agent-skills --skill proxies

Installs into the current project.

Summary

Oxylabs proxy networks: Residential, Mobile, shared Datacenter/ISP, and Dedicated Datacenter/ISP proxies with geo-targeting, IP rotation, session persistence, and port-based sticky IPs. Use when routing traffic through proxies, building scrapers with proxy auth, rotating or stick

Files · 1

View on GitHub

SKILL.md

1	# Oxylabs Proxies
2
3	## Proxy Types Overview
4
5	\| Type \| Host \| Port \| Best For \|
6	\|------\|------\|------\|----------\|
7	\| Residential \| `pr.oxylabs.io` \| `7777` \| High anonymity, geo-targeting \|
8	\| Mobile \| `pr.oxylabs.io` \| `7777` \| Mobile-specific content, highest trust \|
9	\| Datacenter (shared) \| `dc.oxylabs.io` \| `8000` rotation / `8001+` assigned/static \| Speed, high volume \|
10	\| ISP (shared) \| `isp.oxylabs.io` \| `8000` rotation / `8001+` assigned/static \| Speed + anonymity balance \|
11	\| Dedicated Datacenter \| `ddc.oxylabs.io` \| `8000` rotation / `8001+` assigned/static \| Owned IPs, port-based access \|
12	\| Dedicated ISP \| `disp.oxylabs.io` \| `8000` rotation / `8001+` assigned/static \| Owned ISP IPs, ASN locked \|
13
14	Residential/Mobile use `pr.oxylabs.io:7777` with username session parameters. Datacenter/ISP and Dedicated self-service products use proxy-list ports starting at `8001` for assigned/static IPs and `8000` for automatic rotation.
15
16	## Environment Variables
17
18	Use credentials for the specific proxy product family:
19
20	\| Product family \| Variables \| Username prefix \|
21	\|----------------\|-----------\|-----------------\|
22	\| Residential, Mobile \| `OXY_RES_USERNAME`, `OXY_RES_PASSWORD` \| `customer-` \|
23	\| Datacenter, ISP, Dedicated Datacenter, Dedicated ISP \| `OXY_DC_USERNAME`, `OXY_DC_PASSWORD` \| `user-` for self-service/shared \|
24
25	## Authentication Format
26
27	```
28	customer-USERNAME:PASSWORD # Residential, Mobile
29	user-USERNAME:PASSWORD # Shared Datacenter, Shared ISP
30	```
31
32	Dedicated proxy auth (Self-Service vs Enterprise) is in [dedicated-datacenter.md](dedicated-datacenter.md) and [dedicated-isp.md](dedicated-isp.md).
33
34	Use separate credentials for Residential/Mobile (`OXY_RES_USERNAME`, `OXY_RES_PASSWORD`) and Datacenter/ISP (`OXY_DC_USERNAME`, `OXY_DC_PASSWORD`).
35
36	With parameters:
37	```
38	customer-USERNAME-cc-US-city-new_york-sessid-abc123:PASSWORD
39	```
40
41	## Quick Start
42
43	Residential/Mobile proxy:
44	```bash
45	curl -x "pr.oxylabs.io:7777" \
46	-U "customer-$OXY_RES_USERNAME:$OXY_RES_PASSWORD" \
47	"https://ip.oxylabs.io/location"
48	```
49
50	Datacenter proxy:
51	```bash
52	curl -x "dc.oxylabs.io:8000" \
53	-U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
54	"https://ip.oxylabs.io/location"
55	```
56
57	ISP proxy:
58	```bash
59	curl -x "isp.oxylabs.io:8001" \
60	-U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
61	"https://ip.oxylabs.io/location"
62	```
63
64	For Datacenter, ISP, Dedicated Datacenter, and Dedicated ISP proxies, use dashboard proxy-list ports starting at `8001` for assigned/static IPs; the first listed IP uses `8001`. Switch to port `8000` only when the task calls for automatic rotation.
65
66	## Geo-Targeting Parameters
67
68	For Residential/Mobile, append username parameters with hyphens unless noted:
69
70	\| Parameter \| Format \| Example \|
71	\|-----------\|--------\|---------\|
72	\| `cc` \| ISO 3166-1 alpha-2 \| `-cc-US`, `-cc-DE`, `-cc-GB` \|
73	\| `city` \| English, underscores for spaces \| `-city-new_york`, `-city-los_angeles` \|
74	\| `st` \| US states with `us_` prefix \| `-st-us_california`, `-st-us_texas` \|
75	\| `postalcode` \| 5-digit US ZIP, pair with `cc-US` \| `-cc-US-postalcode-90210` \|
76	\| `ASN` \| Residential/Mobile carrier ASN \| `-ASN-21928` \|
77	\| `X-Oxylabs-Geolocation` \| Proxy header `lat:lon;radius_miles` \| `49.9235:-97.0811;10` \|
78
79	ZIP targeting is US-only. Coordinate radius cannot be lower than 10 miles. If both country and ASN are used, country applies.
80
81	Example with geo-targeting:
82	```bash
83	curl -x "pr.oxylabs.io:7777" \
84	-U "customer-$OXY_RES_USERNAME-cc-US-city-new_york:$OXY_RES_PASSWORD" \
85	"https://ip.oxylabs.io/location"
86	```
87
88	For Shared Datacenter/ISP country rotation, use `-country-US` with `user-` credentials on the rotation port.
89
90	## Session Control
91
92	\| Parameter \| Description \| Notes \|
93	\|-----------\|-------------\|-------\|
94	\| `sessid` \| Keep the same IP across requests \| Standard session is 10 minutes or up to 60s of inactivity \|
95	\| `sessid_oneip` \| Bind the session to one exact exit node \| Returns `502` if that IP becomes unavailable \|
96	\| `sesstime` \| Set session duration in minutes with `sessid` or `sessid_oneip` \| Residential backconnect supports up to 1440 minutes; some entry modes cap lower \|
97
98	Sticky session example:
99	```bash
100	curl -x "pr.oxylabs.io:7777" \
101	-U "customer-$OXY_RES_USERNAME-cc-US-sessid-mysession123:$OXY_RES_PASSWORD" \
102	"https://example.com"
103	```
104
105	Timed session (5 minutes):
106	```bash
107	curl -x "pr.oxylabs.io:7777" \
108	-U "customer-$OXY_RES_USERNAME-sessid-abc123-sesstime-5:$OXY_RES_PASSWORD" \
109	"https://example.com"
110	```
111
112	## Choosing the Right Proxy Type
113
114	\| Need \| Recommended \|
115	\|------\|-------------\|
116	\| Highest anonymity \| Residential \|
117	\| Mobile app cont

People who liked this also viewed

6 picks

Type

proxies

317stars1forks

View on GitHub

How to install proxies?

oxylabs/agent-skills/proxies

$npx -y skills add oxylabs/agent-skills --skill proxies

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Oxylabs Proxies
2
3	## Proxy Types Overview
4
5	\| Type \| Host \| Port \| Best For \|
6	\|------\|------\|------\|----------\|
7	\| Residential \| `pr.oxylabs.io` \| `7777` \| High anonymity, geo-targeting \|
8	\| Mobile \| `pr.oxylabs.io` \| `7777` \| Mobile-specific content, highest trust \|
9	\| Datacenter (shared) \| `dc.oxylabs.io` \| `8000` rotation / `8001+` assigned/static \| Speed, high volume \|
10	\| ISP (shared) \| `isp.oxylabs.io` \| `8000` rotation / `8001+` assigned/static \| Speed + anonymity balance \|
11	\| Dedicated Datacenter \| `ddc.oxylabs.io` \| `8000` rotation / `8001+` assigned/static \| Owned IPs, port-based access \|
12	\| Dedicated ISP \| `disp.oxylabs.io` \| `8000` rotation / `8001+` assigned/static \| Owned ISP IPs, ASN locked \|
13
14	Residential/Mobile use `pr.oxylabs.io:7777` with username session parameters. Datacenter/ISP and Dedicated self-service products use proxy-list ports starting at `8001` for assigned/static IPs and `8000` for automatic rotation.
15
16	## Environment Variables
17
18	Use credentials for the specific proxy product family:
19
20	\| Product family \| Variables \| Username prefix \|
21	\|----------------\|-----------\|-----------------\|
22	\| Residential, Mobile \| `OXY_RES_USERNAME`, `OXY_RES_PASSWORD` \| `customer-` \|
23	\| Datacenter, ISP, Dedicated Datacenter, Dedicated ISP \| `OXY_DC_USERNAME`, `OXY_DC_PASSWORD` \| `user-` for self-service/shared \|
24
25	## Authentication Format
26
27	```
28	customer-USERNAME:PASSWORD # Residential, Mobile
29	user-USERNAME:PASSWORD # Shared Datacenter, Shared ISP
30	```
31
32	Dedicated proxy auth (Self-Service vs Enterprise) is in [dedicated-datacenter.md](dedicated-datacenter.md) and [dedicated-isp.md](dedicated-isp.md).
33
34	Use separate credentials for Residential/Mobile (`OXY_RES_USERNAME`, `OXY_RES_PASSWORD`) and Datacenter/ISP (`OXY_DC_USERNAME`, `OXY_DC_PASSWORD`).
35
36	With parameters:
37	```
38	customer-USERNAME-cc-US-city-new_york-sessid-abc123:PASSWORD
39	```
40
41	## Quick Start
42
43	Residential/Mobile proxy:
44	```bash
45	curl -x "pr.oxylabs.io:7777" \
46	-U "customer-$OXY_RES_USERNAME:$OXY_RES_PASSWORD" \
47	"https://ip.oxylabs.io/location"
48	```
49
50	Datacenter proxy:
51	```bash
52	curl -x "dc.oxylabs.io:8000" \
53	-U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
54	"https://ip.oxylabs.io/location"
55	```
56
57	ISP proxy:
58	```bash
59	curl -x "isp.oxylabs.io:8001" \
60	-U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
61	"https://ip.oxylabs.io/location"
62	```
63
64	For Datacenter, ISP, Dedicated Datacenter, and Dedicated ISP proxies, use dashboard proxy-list ports starting at `8001` for assigned/static IPs; the first listed IP uses `8001`. Switch to port `8000` only when the task calls for automatic rotation.
65
66	## Geo-Targeting Parameters
67
68	For Residential/Mobile, append username parameters with hyphens unless noted:
69
70	\| Parameter \| Format \| Example \|
71	\|-----------\|--------\|---------\|
72	\| `cc` \| ISO 3166-1 alpha-2 \| `-cc-US`, `-cc-DE`, `-cc-GB` \|
73	\| `city` \| English, underscores for spaces \| `-city-new_york`, `-city-los_angeles` \|
74	\| `st` \| US states with `us_` prefix \| `-st-us_california`, `-st-us_texas` \|
75	\| `postalcode` \| 5-digit US ZIP, pair with `cc-US` \| `-cc-US-postalcode-90210` \|
76	\| `ASN` \| Residential/Mobile carrier ASN \| `-ASN-21928` \|
77	\| `X-Oxylabs-Geolocation` \| Proxy header `lat:lon;radius_miles` \| `49.9235:-97.0811;10` \|
78
79	ZIP targeting is US-only. Coordinate radius cannot be lower than 10 miles. If both country and ASN are used, country applies.
80
81	Example with geo-targeting:
82	```bash
83	curl -x "pr.oxylabs.io:7777" \
84	-U "customer-$OXY_RES_USERNAME-cc-US-city-new_york:$OXY_RES_PASSWORD" \
85	"https://ip.oxylabs.io/location"
86	```
87
88	For Shared Datacenter/ISP country rotation, use `-country-US` with `user-` credentials on the rotation port.
89
90	## Session Control
91
92	\| Parameter \| Description \| Notes \|
93	\|-----------\|-------------\|-------\|
94	\| `sessid` \| Keep the same IP across requests \| Standard session is 10 minutes or up to 60s of inactivity \|
95	\| `sessid_oneip` \| Bind the session to one exact exit node \| Returns `502` if that IP becomes unavailable \|
96	\| `sesstime` \| Set session duration in minutes with `sessid` or `sessid_oneip` \| Residential backconnect supports up to 1440 minutes; some entry modes cap lower \|
97
98	Sticky session example:
99	```bash
100	curl -x "pr.oxylabs.io:7777" \
101	-U "customer-$OXY_RES_USERNAME-cc-US-sessid-mysession123:$OXY_RES_PASSWORD" \
102	"https://example.com"
103	```
104
105	Timed session (5 minutes):
106	```bash
107	curl -x "pr.oxylabs.io:7777" \
108	-U "customer-$OXY_RES_USERNAME-sessid-abc123-sesstime-5:$OXY_RES_PASSWORD" \
109	"https://example.com"
110	```
111
112	## Choosing the Right Proxy Type
113
114	\| Need \| Recommended \|
115	\|------\|-------------\|
116	\| Highest anonymity \| Residential \|
117	\| Mobile app cont

People who liked this also viewed

6 picks

Type