Do I need to change my existing Stagehand code to use Steel?

No — your act, extract, and observe calls stay the same. The only change is constructing Stagehand with env: "LOCAL" and Steel's CDP URL in localBrowserLaunchOptions.cdpUrl.

How do I connect Stagehand to a Steel browser session?

Create a session with client.sessions.create(), then set cdpUrl inside localBrowserLaunchOptions to the session's websocketUrl with your apiKey appended, and call stagehand.init().

Does Stagehand work with Steel's proxies, stealth mode, and CAPTCHA solving?

Yes — set them when creating the Steel session (e.g. useProxy, solveCaptcha, stealthConfig on sessions.create). Stagehand connects over CDP and is unaware of how the session was provisioned.

Run Stagehand on Steel Cloud Browsers

Run Stagehand on Steel cloud browsers. Write automations in natural language with act, extract, and observe. Stealth and proxies are managed for you.

Stagehand is an open-source library for writing browser automations in natural language using act, extract, and observe calls. The Steel integration drives Stagehand against a Steel cloud session, so you can replace fragile selectors with instructions like "click the login button" or "extract the top 3 stories". Same API in TypeScript or Python.

Good fit for research, scraping, and form workflows.

Requirements

Steel API Key: Active Steel subscription
OpenAI API Key: Stagehand's default model provider
Runtime: Node.js 20+ or Python 3.10+

Connect Steel to Stagehand

Pass Steel's CDP URL as localBrowserLaunchOptions.cdpUrl:

Typescript

import { Stagehand } from "@browserbasehq/stagehand";
import Steel from "steel-sdk";

const client = new Steel({ steelAPIKey: STEEL_API_KEY });
const session = await client.sessions.create({});

const stagehand = new Stagehand({
  env: "LOCAL",
  localBrowserLaunchOptions: {
    cdpUrl: `${session.websocketUrl}&apiKey=${STEEL_API_KEY}`,
  },
  model: { modelName: "openai/gpt-5", apiKey: OPENAI_API_KEY },
});
await stagehand.init();

Full runnable starter: Steel + Stagehand recipe →

FAQ

Resources

Stagehand documentation – Official documentation for Stagehand
Steel Sessions API reference – Technical details for managing Steel browser sessions
Steel Discord – Get help and share what you build