Merge branch 'main' into mason/seo-geo-recipes-troubleshooting

Author: masnwilliams

browsers/create-a-browser.mdx

@@ -19,7 +19,7 @@ Use our SDK to create a browser:
 
 <CreateBrowserSnippet />
 
-## 2. Connect to the browser with the Chrome DevTools Protocol
+## 2. Connect over CDP
 
 Then, you can connect to the browser with any Chrome DevTools Protocol framework, such as Playwright or Puppeteer.
 

careers/customer-engineer.mdx

@@ -0,0 +1,66 @@
+---
+title: "Customer Engineer"
+---
+
+- 🌆 **Location: SF**
+- 💰 **Salary: $150,000 - $225,000 + 0.35 - 0.75%+ equity**
+- 💻 **Skills: Typescript, Python, SDKs, CLIs, Open Source Software, DevRel, Customer Engineering**
+
+## About Kernel
+
+We're building *the* developer platform that lets AI agents use real applications, starting with browsers. Our edge is an infrastructure platform that's extensible, observable, and built for scale from day one. We've shipped foundational tech, landed paying customers, and are well-funded while still in stealth.
+
+Our **serverless platform** handles the hard stuff: autoscaling reliable browser infrastructure, observability, and the messy details of web interaction so developers can focus on what their agents do, not how they do it. **Kernel makes AI tangible, practical, and powerful** — allowing developers to deploy agents that can truly interact with the digital world.
+
+**If you're interested in building critical infrastructure for the next generation of AI applications, we'd love to chat.** One line of code deploys any web agent to our cloud. The rest is up to you.
+
+## About the role
+
+As a **Founding Customer Engineer** at Kernel, you'll be part builder, part solutions engineer, and fully embedded with our customers' engineering teams.
+
+This is a **hands-on engineering role**: you'll spend **~50% of your time coding** open source tools, customer integrations, and the rest helping developers succeed. You'll be the [Alex Albert](https://x.com/alexalbert__) of Kernel, pushing the AI industry forward by showing what is possible.
+
+## What you'll do
+
+- Support **enterprise customers** with hands-on solutions engineering
+- Engage with our **community** on GitHub, Slack, and Twitter, answering questions and amplifying cool projects
+- Contribute to Kernel's **technical blog**, developing content that educates, inspires, and grows developer adoption
+- Build **OSS tools, libraries, demos, and integrations** that make Kernel's devEx more powerful and easier to use
+- Influence Kernel's **culture, product, and direction** as a founding team member
+
+## What we're looking for
+
+- **You ship**: tools, projects, ideas—anything that pushes the ecosystem forward
+- **You code (and vibe code)**: strong engineering background who cares about great devEx (our inspirations: Modal, Supabase, PlanetScale)
+- **You get developers**: you know what excites them, what annoys them, and how to speak their language
+- **You want impact**: you're energized by small, high impact teams and want to build something that delights software engineers
+
+## What you can expect as a Kernel
+
+- **Industry-competitive salary**
+- **Above market equity**
+- Premium **medical + dental coverage** + dependent coverage
+- Small, trusting team of **senior + staff engineers**
+- Default async—**minimal bureaucracy**, only two meetings a week
+- **$1k / mo budget** for LLM usage fees #vibecheck
+- **Daily lunches** on us
+- **Unlimited PTO**
+- 401k + company match
+- Relocation assistance
+
+## Hiring process
+
+We have a simple process focused on real world collaboration and jointly getting to know each other:
+
+1. 30 minute **intro calls** with each of Kernel's co-founders (1 hour total)
+2. Half-day on-site (virtual or in-person) working with our team and co-founders on relevant challenges.
+3. **Offer!**
+
+## How to apply
+
+Add Catherine on [LinkedIn](https://www.linkedin.com/in/juecd/) and include:
+
+1. Your resumé
+2. Past projects, work, and GitHub
+
+We can't wait to hear from you!

careers/devrel-engineer.mdx

@@ -3,7 +3,7 @@ title: "DevRel Engineer"
 ---
 
 - 🌆 **Location: SF**
-- 💰 **Salary: $150,000 - $235,000 + 0.35 - 0.75%+ equity**
+- 💰 **Salary: $150,000 - $225,000 + 0.35 - 0.75%+ equity**
 - 💻 **Skills: Typescript, Python, SDKs, CLIs, Open Source Software, DevRel**
 
 ## About Kernel

careers/intro.mdx

@@ -16,4 +16,5 @@ Our **serverless platform** handles the hard stuff: autoscaling reliable browser
 - [Founding Backend Engineer](/careers/backend-engineer)
 - [Software Engineer - New Grad](/careers/engineer-new-grad)
 - [Founding DevRel Engineer](/careers/devrel-engineer)
+- [Founding Customer Engineer](/careers/customer-engineer)
 - [Founding Technical Content Marketer](/careers/technical-content-marketer)

docs.json

@@ -72,7 +72,6 @@
                     "pages": [
                       "proxies/overview",
                       "proxies/custom",
-                      "proxies/mobile",
                       "proxies/residential",
                       "proxies/isp",
                       "proxies/datacenter"
@@ -150,6 +149,7 @@
               "careers/backend-engineer",
               "careers/engineer-new-grad",
               "careers/devrel-engineer",
+              "careers/customer-engineer",
               "careers/technical-content-marketer"
             ]
           }

introduction.mdx

@@ -3,11 +3,11 @@ title: "Introduction"
 description: "Browsers-as-a-service API for web agents, automations, and more"
 ---
 
-Kernel is a developer platform that provides Crazy Fast Browser Infrastructure for browser automations and web agents. Our API and MCP server allow you to instantly launch browsers in the cloud without managing infrastructure.
+Kernel is a developer platform that provides Crazy Fast Browsers-as-a-Service for browser automations and web agents. Our API and MCP server allow you to instantly launch browsers in the cloud without managing infrastructure.
 
-## kernel.browsers.create()
+## Connect over CDP
 
-If you are already familiar with browser vendors, you can immediately start using our browsers with `kernel.browsers.create()`. We return a CDP url that you can connect any Playwright or Puppeteer automation to.
+If you are already familiar with browser vendors, you can immediately start using our browsers with `kernel.browsers.create()`. We return a **CDP url** that you can connect any Playwright or Puppeteer automation to.
 
 <Info>
 Install the Kernel SDK with `npm install @onkernel/sdk` or `uv pip install kernel`
@@ -17,14 +17,14 @@ Install the Kernel SDK with `npm install @onkernel/sdk` or `uv pip install kerne
 
 ```typescript Typescript/Javascript
 import { Kernel } from '@onkernel/sdk';
-const kernel = new Kernel();
+const kernel = new Kernel({api_key: 'your_api_key'});
 const kernelBrowser = await kernel.browsers.create();
 const browser = await chromium.connectOverCDP(kernelBrowser.cdp_ws_url);
 ```
 
 ```python Python
-import kernel
-client = Kernel()
+from kernel import Kernel
+client = Kernel(api_key='your_api_key')
 kernel_browser = client.browsers.create()
 browser = await chromium.connectOverCDP(kernel_browser.cdp_ws_url)
 ```

proxies/custom.mdx

@@ -21,6 +21,7 @@ const kernel = new Kernel();
 const proxy = await kernel.proxies.create({
   type: 'custom',
   name: 'my-private-proxy',
+  protocol: 'https',
   config: {
     host: 'proxy.example.com',
     port: 443,
@@ -41,6 +42,7 @@ client = kernel.Kernel()
 proxy = client.proxies.create(
     type='custom',
     name='my-private-proxy',
+    protocol='https',
     config={
         'host': 'proxy.example.com',
         'port': 443,

proxies/mobile.mdx

@@ -10,13 +10,14 @@ Kernel proxies enable you to route browser traffic through different types of pr
 
 ## Proxy Types
 
-Kernel supports five types of proxies, ranked by quality (from best to worst):
+Kernel supports four types of proxies:
 
-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. [**Datacenter**](/proxies/datacenter) - Traffic routed through commercial data centers
+2. [**ISP**](/proxies/isp) - Traffic routed through data centers, using residential IP addresses leased from from internet service providers
+3. [**Residential**](/proxies/residential) - Traffic routed through real residential IP addresses
+4. [**Custom**](/proxies/custom) - Your own proxy servers
+
+Datacenter has the fastest speed, while residential is least detectable. ISP is a balance between the two options, with less-flexible geotargeting. Kernel recommends to use the first option in the list that works for your use case.
 
 ## 1. Create a proxy
 

proxies/overview.mdx

@@ -16,12 +16,10 @@ const kernel = new Kernel();
 
 const proxy = await kernel.proxies.create({
   type: 'residential',
-  name: 'my-california-residential',
+  name: 'my-la-residential',
   config: {
     country: 'US',
-    city: 'sanfrancisco',
-    zip: '94102',
-    os: 'windows'
+    city: 'los_angeles'
   }
 });
 
@@ -36,12 +34,10 @@ client = kernel.Kernel()
 
 proxy = client.proxies.create(
     type='residential',
-    name='my-california-residential',
+    name='my-la-residential',
     config={
         'country': 'US',
-        'city': 'sanfrancisco',
-        'zip': '94102',
-        'os': 'windows'
+        'city': 'los_angeles'
     }
 )
 
@@ -54,9 +50,8 @@ browser = client.browsers.create(
 
 ## Configuration Parameters
 
-- **`country`** - ISO 3166 country code
-- **`state`** - Two-letter state code. Only supported for US and Australia. Cannot be used with `city`
-- **`city`** - City name (lowercase, no spaces, e.g., `sanfrancisco`, `newyork`). Required if `zip` is provided
-- **`zip`** - US ZIP code (5 digits). Requires `city` to be provided
-- **`os`** - Operating system: `windows`, `macos`, or `android`
-- **`asn`** - Autonomous System Number. Mutually exclusive with geo-location targeting
+- **`country`** - ISO 3166 country code. Must be provided when providing other targeting options.
+- **`state`** - Two-letter state code. Only supported for US.
+- **`city`** - City name (lowercase, no spaces, e.g., `sanfrancisco`, `newyork`).
+- **`zip`** - US ZIP code (5 digits). Conflicts with city and state.
+- **`asn`** - Autonomous System Number. Conflicts with city and state.