IA proxies (#59)

* IA proxies

* Reorder

Author: juecd

browsers/proxies.mdx

@@ -2,9 +2,9 @@
 title: "Stealth Mode"
 ---
 
-Kernel browsers can be configured to `stealth` mode, which adds a high performant residential proxy and auto-CAPTCHA solver to your instances.
+Kernel browsers can be configured to `stealth` mode, which adds our recommended proxy configuration to your browser instances. It also adds a `reCAPTCHA solver` to the browser, so it automatically solves [reCAPTCHAs](https://www.google.com/recaptcha/api2/demo) on your behalf.
 
-To turn on stealth mode, set its flag in your app code when instantiating Kernel:
+To turn on stealth mode, set its flag when instantiating Kernel browsers:
 
 <CodeGroup>
 ```typescript Typescript/Javascript
@@ -23,4 +23,6 @@ kernel_browser = client.browsers.create(invocation_id=ctx.invocation_id, stealth
     [Anthropic Computer Use](/quickstart#sample-apps-reference) stops when it runs into a CAPTCHA. Use Kernel's auto-captcha solver by adding this to your prompt:
 
     `"If you see a CAPTCHA or similar test, just wait for it to get solved automatically by the browser."`
-</Info>
+</Info>
+
+If you're looking for proxy-level configuration with Kernel browsers, see [Proxies](/proxies/overview).

browsers/stealth.mdx

@@ -56,26 +56,30 @@
             "pages": [
               "browsers/create-a-browser",
               "browsers/headless",
-              "browsers/stealth",
               "browsers/standby",
               "browsers/persistence",
               "browsers/profiles",
-              "browsers/proxies",
               "browsers/termination",
               "browsers/file-io",
               "browsers/live-view",
-              "browsers/replays"
-            ]
-          },
-          {
-            "group": "Proxies",
-            "pages": [
-              "proxies/overview",
-              "proxies/datacenter",
-              "proxies/isp",
-              "proxies/residential",
-              "proxies/mobile",
-              "proxies/custom"
+              "browsers/replays",
+              {
+                "group": "Bot Anti-Detection",
+                "pages": [
+                  "browsers/stealth",
+                  {
+                    "group": "Proxies",
+                    "pages": [
+                      "proxies/overview",
+                      "proxies/custom",
+                      "proxies/mobile",
+                      "proxies/residential",
+                      "proxies/isp",
+                      "proxies/datacenter"
+                    ]
+                  }
+                ]
+              }
             ]
           },
           {

docs.json

@@ -6,9 +6,9 @@ Custom proxies allow you to use your own proxy servers with Kernel browsers. Thi
 
 ## Configuration
 
-<Note>
+<Tip>
 Currently, only HTTPS proxies are supported for custom proxy configurations.
-</Note>
+</Tip>
 
 Specify the host, port, and optional authentication credentials for your proxy server:
 
@@ -63,6 +63,6 @@ browser = client.browsers.create(
 - **`username`** - Username for proxy authentication
 - **`password`** - Password for proxy authentication (minimum 5 characters)
 
-<Note>
+<Info>
 When creating a proxy with authentication, provide the password. The API response will only indicate if a password exists (`has_password: true`) but won't return the actual password for security reasons.
-</Note>
+</Info>

proxies/custom.mdx

@@ -2,7 +2,7 @@
 title: "ISP Proxies"
 ---
 
-ISP (Internet Service Provider) proxies combine the speed of datacenter proxies with better legitimacy, as they use IP addresses assigned by real ISPs. They offer a good balance between performance and detection avoidance.
+ISP (Internet Service Provider) proxies combine the speed of datacenter proxies with better legitimacy, as they use IP addresses assigned by real ISPs.
 
 ## Configuration
 

proxies/isp.mdx

@@ -55,15 +55,15 @@ browser = client.browsers.create(
 ## Configuration Parameters
 
 - **`country`** - ISO 3166 country code
-- **`carrier`** - Mobile carrier name (e.g., `verizon`, `att`, `tmobile`)
+- **`carrier`** - Mobile carrier name (see available carriers below)
 - **`state`** - Two-letter state code. Only supported for US and Australia. Cannot be used with `city`
 - **`city`** - City name (lowercase, no spaces, e.g., `newyork`, `losangeles`). Required if `zip` is provided
 - **`zip`** - US ZIP code (5 digits). Requires `city` to be provided
 - **`asn`** - Autonomous System Number. Mutually exclusive with geo-location targeting
 
 ## Supported Carriers
 
-Major carriers worldwide are supported, including:
+Major carriers worldwide are supported:
 
 **US Carriers:**
 - `att` - AT&T
@@ -81,6 +81,4 @@ Major carriers worldwide are supported, including:
 - `docomo` - NTT Docomo
 - `chinamobile` - China Mobile
 - `airtel` - Bharti Airtel
-- `telstra` - Telstra
-
-[View all supported carriers in the API reference]
+- `telstra` - Telstra

proxies/mobile.mdx

@@ -1,32 +1,26 @@
 ---
-title: "Proxies Overview"
+title: "Overview"
 ---
 
 import CreateProxySnippet from '/snippets/openapi/post-proxies.mdx';
 import ListProxiesSnippet from '/snippets/openapi/get-proxies.mdx';
 import DeleteProxySnippet from '/snippets/openapi/delete-proxies-id.mdx';
 
-Kernel proxies enable you to route browser traffic through different types of proxy servers, providing enhanced privacy, geographic flexibility, and bot detection avoidance. Proxies can be created once and reused across multiple browser sessions.
+Kernel proxies enable you to route browser traffic through different types of proxy servers, providing enhanced privacy, flexibility, and bot detection avoidance. Proxies can be created once and reused across multiple browser sessions.
 
 ## Proxy Types
 
-Kernel supports five types of proxies, ranked by quality for avoiding bot detection (from best to worst):
+Kernel supports five types of proxies, ranked by quality (from best to worst):
 
-1. **Mobile** - Traffic routed through mobile carrier networks
-2. **Residential** - Traffic routed through residential ISP connections
-3. **ISP** - Traffic routed through ISP data centers
-4. **Datacenter** - Traffic routed through commercial data centers
-5. **Custom** - Your own proxy servers
+0. [**Custom**](/proxies/custom) - Your own proxy servers
+1. [**Mobile**](/proxies/mobile) - Traffic routed through mobile carrier networks
+2. [**Residential**](/proxies/residential) - Traffic routed through residential ISP connections
+3. [**ISP**](/proxies/isp) - Traffic routed through ISP data centers
+4. [**Datacenter**](/proxies/datacenter) - Traffic routed through commercial data centers
 
 ## 1. Create a proxy
 
-<Info>
-First, install the Kernel SDK:
-- Typescript/Javascript: `npm install @onkernel/sdk`
-- Python: `pip install kernel`
-</Info>
-
-Create a proxy configuration that can be reused across browser sessions:
+Create a proxy configuration from the types above that can be reused across browser sessions:
 
 <CreateProxySnippet />
 
@@ -88,6 +82,6 @@ When no longer needed, delete the proxy configuration:
 
 <DeleteProxySnippet />
 
-<Note>
-Deleting a proxy does not affect existing browser sessions that are using it. The proxy configuration is only removed from your organization.
-</Note>
+<Info>
+Deleting a proxy does not affect existing browser sessions that are currently using it. The configuration is only removed from your organization so it can't be used in future browser sessions.
+</Info>

proxies/overview.mdx

@@ -2,7 +2,7 @@
 title: "Residential Proxies"
 ---
 
-Residential proxies route traffic through real residential IP addresses, making them highly effective at avoiding bot detection. They support advanced targeting options including city, state, and operating system.
+Residential proxies route traffic through real residential IP addresses. They support advanced targeting options including city, state, and operating system.
 
 ## Configuration