Skip to content

Automate browser based workflows with AI

Add South Korea (RESIDENTIAL_KR) proxy location support (#4918)

Marc Kelechava88f04e829a98
diff --git a/docs/going-to-production/proxy-geolocation.mdx b/docs/going-to-production/proxy-geolocation.mdx
index 9d7592c39..e3c48ffc8 100644
--- a/docs/going-to-production/proxy-geolocation.mdx
+++ b/docs/going-to-production/proxy-geolocation.mdx
@@ -236,13 +236,14 @@ export const PROXY_LOCATIONS = [
{ code: "ZA", name: "South Africa", value: "RESIDENTIAL_ZA", timezone: "Africa/Johannesburg", flag: "🇿🇦" },
{ code: "IN", name: "India", value: "RESIDENTIAL_IN", timezone: "Asia/Kolkata", flag: "🇮🇳" },
{ code: "PH", name: "Philippines", value: "RESIDENTIAL_PH", timezone: "Asia/Manila", flag: "🇵🇭" },
+ { code: "KR", name: "South Korea", value: "RESIDENTIAL_KR", timezone: "Asia/Seoul", flag: "🇰🇷" },
{ code: "JP", name: "Japan", value: "RESIDENTIAL_JP", timezone: "Asia/Tokyo", flag: "🇯🇵" },
{ code: "AU", name: "Australia", value: "RESIDENTIAL_AU", timezone: "Australia/Sydney", flag: "🇦🇺" },
{ code: "NZ", name: "New Zealand", value: "RESIDENTIAL_NZ", timezone: "Pacific/Auckland", flag: "🇳🇿" },
{ code: "NONE", name: "No Proxy", value: "NONE", timezone: "—", flag: "🚫" },
]
-export const AVAILABLE_COUNTRIES = ["US", "CA", "MX", "AR", "BR", "GB", "IE", "NL", "DE", "FR", "ES", "IT", "TR", "ZA", "IN", "PH", "JP", "AU", "NZ"]
+export const AVAILABLE_COUNTRIES = ["US", "CA", "MX", "AR", "BR", "GB", "IE", "NL", "DE", "FR", "ES", "IT", "TR", "ZA", "IN", "PH", "KR", "JP", "AU", "NZ"]
export const ProxyMapSelector = () => {
const [selected, setSelected] = useState("US")
@@ -575,6 +576,7 @@ Use these enum values for country-level targeting. Each routes through a residen
| `RESIDENTIAL_NL` | Netherlands | Europe/Amsterdam |
| `RESIDENTIAL_NZ` | New Zealand | Pacific/Auckland |
| `RESIDENTIAL_PH` | Philippines | Asia/Manila |
+| `RESIDENTIAL_KR` | South Korea | Asia/Seoul |
| `RESIDENTIAL_TR` | Türkiye | Europe/Istanbul |
| `RESIDENTIAL_ZA` | South Africa | Africa/Johannesburg |
| `NONE` | No proxy | — |
diff --git a/docs/multi-step-automations/workflow-parameters.mdx b/docs/multi-step-automations/workflow-parameters.mdx
index 076b74fa7..28bb49f70 100644
--- a/docs/multi-step-automations/workflow-parameters.mdx
+++ b/docs/multi-step-automations/workflow-parameters.mdx
@@ -587,6 +587,8 @@ curl -X POST "https://api.skyvern.com/v1/run/workflows" \
| `RESIDENTIAL_MX` | Mexico |
| `RESIDENTIAL_NL` | Netherlands |
| `RESIDENTIAL_NZ` | New Zealand |
+| `RESIDENTIAL_PH` | Philippines |
+| `RESIDENTIAL_KR` | South Korea |
| `RESIDENTIAL_TR` | Türkiye |
| `RESIDENTIAL_ZA` | South Africa |
| `NONE` | No proxy |
diff --git a/docs/running-automations/task-parameters.mdx b/docs/running-automations/task-parameters.mdx
index f6ccb4b35..36c5d10b3 100644
--- a/docs/running-automations/task-parameters.mdx
+++ b/docs/running-automations/task-parameters.mdx
@@ -293,6 +293,7 @@ Use this for geo-restricted content or to reduce bot detection.
| `RESIDENTIAL_IT` | Italy |
| `RESIDENTIAL_NL` | Netherlands |
| `RESIDENTIAL_PH` | Philippines |
+| `RESIDENTIAL_KR` | South Korea |
| `RESIDENTIAL_TR` | Turkey |
| `RESIDENTIAL_ISP` | ISP proxy |
| `NONE` | No proxy |
diff --git a/fern/running-tasks/proxy-location.mdx b/fern/running-tasks/proxy-location.mdx
index dc99b5b7e..b4ed9972d 100644
--- a/fern/running-tasks/proxy-location.mdx
+++ b/fern/running-tasks/proxy-location.mdx
@@ -30,6 +30,8 @@ Pass any of the following enum values to `proxy_location`. Each value pins the r
| `RESIDENTIAL_MX` | Mexico |
| `RESIDENTIAL_NL` | Netherlands |
| `RESIDENTIAL_NZ` | New Zealand |
+| `RESIDENTIAL_PH` | Philippines |
+| `RESIDENTIAL_KR` | South Korea |
| `RESIDENTIAL_TR` | Türkiye |
| `RESIDENTIAL_ZA` | South Africa |
| `NONE` | Disable proxy routing (traffic originates from Skyvern’s US datacenters) |
diff --git a/skyvern-frontend/src/api/types.ts b/skyvern-frontend/src/api/types.ts
index 1b5ad35f7..eebc99821 100644
--- a/skyvern-frontend/src/api/types.ts
+++ b/skyvern-frontend/src/api/types.ts
@@ -54,6 +54,7 @@ export const ProxyLocation = {
ResidentialIT: "RESIDENTIAL_IT",
ResidentialNL: "RESIDENTIAL_NL",
ResidentialPH: "RESIDENTIAL_PH",
+ ResidentialKR: "RESIDENTIAL_KR",
ResidentialISP: "RESIDENTIAL_ISP",
None: "NONE",
} as const;
diff --git a/skyvern-frontend/src/util/geoData.ts b/skyvern-frontend/src/util/geoData.ts
index 6f747cb39..f7eff6d2d 100644
--- a/skyvern-frontend/src/util/geoData.ts
+++ b/skyvern-frontend/src/util/geoData.ts
@@ -18,6 +18,7 @@ export const SUPPORTED_COUNTRY_CODES = [
"NL",
"NZ",
"PH",
+ "KR",
"TR",
"ZA",
] as const;
@@ -42,6 +43,7 @@ export const COUNTRY_NAMES: Record<SupportedCountryCode, string> = {
NL: "Netherlands",
NZ: "New Zealand",
PH: "Philippines",
+ KR: "South Korea",
TR: "Turkey",
ZA: "South Africa",
};
@@ -64,6 +66,7 @@ export const COUNTRY_FLAGS: Record<SupportedCountryCode, string> = {
NL: "🇳🇱",
NZ: "🇳🇿",
PH: "🇵🇭",
+ KR: "🇰🇷",
TR: "🇹🇷",
ZA: "🇿🇦",
};
@@ -88,6 +91,7 @@ const PROXY_LOCATION_TO_COUNTRY: Record<string, string> = {
[ProxyLocation.ResidentialNL]: "NL",
[ProxyLocation.ResidentialNZ]: "NZ",
[ProxyLocation.ResidentialPH]: "PH",
+ [ProxyLocation.ResidentialKR]: "KR",
[ProxyLocation.ResidentialTR]: "TR",
[ProxyLocation.ResidentialZA]: "ZA",
};
@@ -111,6 +115,7 @@ const COUNTRY_TO_PROXY_LOCATION: Record<string, ProxyLocation> = {
NL: ProxyLocation.ResidentialNL,
NZ: ProxyLocation.ResidentialNZ,
PH: ProxyLocation.ResidentialPH,
+ KR: ProxyLocation.ResidentialKR,
TR: ProxyLocation.ResidentialTR,
ZA: ProxyLocation.ResidentialZA,
};
diff --git a/skyvern/client/types/proxy_location.py b/skyvern/client/types/proxy_location.py
index 1345bbb6b..948c70a88 100644
--- a/skyvern/client/types/proxy_location.py
+++ b/skyvern/client/types/proxy_location.py
@@ -28,6 +28,7 @@ ProxyLocation = typing.Union[
"RESIDENTIAL_IT",
"RESIDENTIAL_NL",
"RESIDENTIAL_PH",
+ "RESIDENTIAL_KR",
"RESIDENTIAL_ISP",
"NONE",
],
diff --git a/skyvern/schemas/docs/doc_strings.py b/skyvern/schemas/docs/doc_strings.py
index 118832976..51ad0e5b2 100644
--- a/skyvern/schemas/docs/doc_strings.py
+++ b/skyvern/schemas/docs/doc_strings.py
@@ -24,9 +24,16 @@ Available geotargeting options:
- RESIDENTIAL_DE: Germany
- RESIDENTIAL_NZ: New Zealand
- RESIDENTIAL_PH: Philippines
+- RESIDENTIAL_KR: South Korea
- RESIDENTIAL_ZA: South Africa
- RESIDENTIAL_AR: Argentina
- RESIDENTIAL_AU: Australia
+- RESIDENTIAL_BR: Brazil
+- RESIDENTIAL_TR: Turkey
+- RESIDENTIAL_CA: Canada
+- RESIDENTIAL_MX: Mexico
+- RESIDENTIAL_IT: Italy
+- RESIDENTIAL_NL: Netherlands
- RESIDENTIAL_ISP: ISP proxy
- US-CA: California (deprecated, routes through RESIDENTIAL_ISP)
- US-NY: New York (deprecated, routes through RESIDENTIAL_ISP)
diff --git a/skyvern/schemas/runs.py b/skyvern/schemas/runs.py
index dca180940..3bdc7f0a1 100644
--- a/skyvern/schemas/runs.py
+++ b/skyvern/schemas/runs.py
@@ -58,6 +58,7 @@ class ProxyLocation(StrEnum):
RESIDENTIAL_IT = "RESIDENTIAL_IT"
RESIDENTIAL_NL = "RESIDENTIAL_NL"
RESIDENTIAL_PH = "RESIDENTIAL_PH"
+ RESIDENTIAL_KR = "RESIDENTIAL_KR"
RESIDENTIAL_ISP = "RESIDENTIAL_ISP"
NONE = "NONE"
@@ -97,6 +98,7 @@ class ProxyLocation(StrEnum):
cls.RESIDENTIAL_IT,
cls.RESIDENTIAL_NL,
cls.RESIDENTIAL_PH,
+ cls.RESIDENTIAL_KR,
}
@staticmethod
@@ -121,6 +123,7 @@ class ProxyLocation(StrEnum):
ProxyLocation.RESIDENTIAL_IT: 2000,
ProxyLocation.RESIDENTIAL_NL: 2000,
ProxyLocation.RESIDENTIAL_PH: 2000,
+ ProxyLocation.RESIDENTIAL_KR: 2000,
}
return counts.get(proxy_location, 10000)
@@ -146,6 +149,7 @@ class ProxyLocation(StrEnum):
ProxyLocation.RESIDENTIAL_IT: "IT",
ProxyLocation.RESIDENTIAL_NL: "NL",
ProxyLocation.RESIDENTIAL_PH: "PH",
+ ProxyLocation.RESIDENTIAL_KR: "KR",
}
return mapping.get(proxy_location, "US")
@@ -170,6 +174,7 @@ SUPPORTED_GEO_COUNTRIES = frozenset(
"NL",
"NZ",
"PH",
+ "KR",
"TR",
"ZA",
}
@@ -315,6 +320,9 @@ def get_tzinfo_from_proxy(proxy_location: ProxyLocation) -> ZoneInfo | None:
if proxy_location == ProxyLocation.RESIDENTIAL_PH:
return ZoneInfo("Asia/Manila")
+ if proxy_location == ProxyLocation.RESIDENTIAL_KR:
+ return ZoneInfo("Asia/Seoul")
+
if proxy_location == ProxyLocation.RESIDENTIAL_ISP:
return ZoneInfo("America/New_York")