Start your first session with Selenium

Connect Selenium WebDriver to Browserbase cloud browsers. Run cross-browser automation at scale with session recording and observability.

Get started with a Selenium Node.js template

Get started with Browserbase and Selenium in Node.js.

Get started with a Selenium Python template

Get started with Browserbase and Selenium in Python.

1. Get your API key

   Your API key and Project ID are displayed in the Dashboard Navigation row:

   

   Copy your API key from the input fields, then update your .env file by adding entries for BROWSERBASE_API_KEY.

   Alternatively, you can temporarily set the environment variables with a single bash command by prefixing it with BROWSERBASE_API_KEY=<your_api_key> in your terminal.

2. Install Selenium

   Node.js

   npm i selenium-webdriver @browserbasehq/sdk
   

   Python

   pip install selenium browserbase
   
3. Update your code or clone a template

   Running your existing code with Browserbase only requires a few line changes:

   Node.js

   import http from "http";
   import { Builder } from "selenium-webdriver";
   import Browserbase from "@browserbasehq/sdk";
   
   const bb = new Browserbase({
     apiKey: process.env.BROWSERBASE_API_KEY,
   });
   
   const session = await bb.sessions.create();
   console.log(`Session created, id: ${session.id}`);
   
   console.log("Starting remote browser...");
   
   const customHttpAgent = new http.Agent({});
   (customHttpAgent as any).addRequest = (req: any, options: any) => {
     req.setHeader("x-bb-signing-key", session.signingKey);
     (http.Agent.prototype as any).addRequest.call(customHttpAgent, req, options);
   };
   
   const driver = new Builder()
     .forBrowser("chrome")
     .usingHttpAgent(customHttpAgent)
     .usingServer(session.seleniumRemoteUrl)
     .build();
   
   await driver.get("https://www.browserbase.com");
   
   const debugUrl = await bb.sessions.debug(session.id);
   console.log(
     `Session started, live debug accessible here: ${debugUrl.debuggerUrl}.`,
   );
   
   console.log("Taking a screenshot!");
   await driver.takeScreenshot();
   
   console.log("Shutting down...");
   await driver.quit();
   
   console.log(
     `Session complete! View recording at https://browserbase.com/sessions/${session.id}`,
   );
   

   Set your BROWSERBASE_API_KEY in the environment variables.

   Python

   from typing import Dict
   
   from selenium import webdriver
   from selenium.webdriver.remote.remote_connection import RemoteConnection
   from browserbase import Browserbase
   import os
   
   BROWSERBASE_API_KEY = os.environ["BROWSERBASE_API_KEY"]
   
   bb = Browserbase(api_key=BROWSERBASE_API_KEY)
   
   
   class BrowserbaseConnection(RemoteConnection):
       session_id: str
   
       def __init__(self, session_id: str, *args, **kwargs):
           super().__init__(*args, **kwargs)
           self.session_id = session_id
   
       def get_remote_connection_headers(
           self, parsed_url: str, keep_alive: bool = False
       ) -> Dict[str, str]:
           headers = super().get_remote_connection_headers(parsed_url, keep_alive)
           headers["x-bb-api-key"] = BROWSERBASE_API_KEY
           headers["session-id"] = self.session_id
           return headers
   
   
   def run() -> None:
       session = bb.sessions.create()
       connection = BrowserbaseConnection(session.id, session.selenium_remote_url)
       driver = webdriver.Remote(
           command_executor=connection, options=webdriver.ChromeOptions()
       )
   
       print(f"Live debug URL: https://browserbase.com/sessions/{session.id}")
   
       try:
           driver.get("https://www.sfmoma.org")
           print(f"At URL: {driver.current_url} | Title: {driver.title}")
       finally:
           driver.quit()
   
   
   if __name__ == "__main__":
       run()
   

   Set your BROWSERBASE_API_KEY in the environment variables.

   Get started with a Selenium template

   Get started with Browserbase and Selenium in Python.

   
   
4. Inspect the completed session

   Find your recent sessions on the overview dashboard:

   

   Select a session to inspect it with the Session Inspector.

Start building

Using browser sessions

Learn how to connect to and interact with browser sessions effectively.

Managing sessions

Understand how to properly end sessions and manage their lifecycle.