Stealth Browser
Enterprise
Stealth Browser is Steel's own Chromium fork, for sites with strict bot detection. A session runs on Chrome by default, and Steel injects a fingerprint into it. Stealth Browser sets its fingerprint inside the browser itself. Use it when a site still blocks a session that has a proxy, CAPTCHA solving and Steel's fingerprint. What each plan includes shows which plans have it.
Stealth Browser changes the browser, not the network. It does not change the session's IP address, so use it with a proxy when the site checks the address. Get past bot detection helps you choose the setup that a site needs.
Get access
Stealth Browser is off until Steel turns it on for your organization. Then any session that your organization creates can ask for it.
- On Enterprise, ask your account team or Support to turn it on.
- On another plan, contact sales. Steel can also turn it on for a trial that ends on a set date. When the trial ends, a request for Stealth Browser fails.
To check your access, create a session with Stealth Browser, as in Run a session on Stealth Browser. Without access, the request fails with a 403, as Troubleshooting shows.
Before you begin
Put your Steel API key in the STEEL_API_KEY environment variable. Then install the Steel SDK and Playwright. You do not need playwright install, because the browser runs in Steel.
npm install steel-sdk playwrightpython3 -m venv .venv
source .venv/bin/activate
pip install steel-sdk playwrightIn Go and Rust, install only the SDK, as the Go and Rust SDK pages show. The code that drives the browser uses Playwright, so it is in TypeScript and Python only.
Run a session on Stealth Browser
Add useStealthBrowser to experimentalFeatures when you create the session. The rest of your code does not change. You connect to the session and release it as you do with any session.
const session = await client.sessions.create({
experimentalFeatures: ["useStealthBrowser"],
});session = client.sessions.create(
experimental_features=["useStealthBrowser"],
)session, err := client.Sessions.New(ctx, steel.SessionNewParams{
ExperimentalFeatures: steel.F([]string{"useStealthBrowser"}),
})
if err != nil {
return err
}let session = client
.sessions()
.create(steel_rs::SessionCreateParams {
experimental_features: Some(vec!["useStealthBrowser".to_owned()]),
..Default::default()
})
.await?;This program creates a session on Stealth Browser, prints its browser mode, opens a page, prints the page's title, and releases the session.
import Steel from "steel-sdk";
import { chromium } from "playwright";
const client = new Steel();
const session = await client.sessions.create({
experimentalFeatures: ["useStealthBrowser"],
});
try {
console.log(`Browser mode: ${session.browserMode}`);
const browser = await chromium.connectOverCDP(session.websocketUrl);
const context = browser.contexts()[0];
const page = context.pages()[0] ?? (await context.newPage());
await page.goto("https://example.com");
console.log(`Title: ${await page.title()}`);
await browser.close();
} finally {
await client.sessions.release(session.id);
}from playwright.sync_api import sync_playwright
from steel import Steel
client = Steel()
session = client.sessions.create(experimental_features=["useStealthBrowser"])
try:
print(f"Browser mode: {session.browser_mode}")
with sync_playwright() as playwright:
browser = playwright.chromium.connect_over_cdp(session.websocket_url)
context = browser.contexts[0]
page = context.pages[0] if context.pages else context.new_page()
page.goto("https://example.com")
print(f"Title: {page.title()}")
browser.close()
finally:
client.sessions.release(session.id)Run the program:
npx tsx stealth-browser.mtspython stealth_browser.pyThe program prints the browser mode stealth and the page's title.
Browser mode: stealth
Title: Example DomainCheck that a session runs on Stealth Browser
A session has a browserMode field. It is stealth for a session on Stealth Browser, and standard for a session on the default browser. The session that sessions.create returns has it, and so does a session that you get later by its ID.
const session = await client.sessions.retrieve(sessionId);
console.log(session.browserMode);session = client.sessions.retrieve(session_id)
print(session.browser_mode)session, err := client.Sessions.Get(ctx, sessionID)
if err != nil {
return err
}
fmt.Println(session.BrowserMode)let session = client.sessions().retrieve(&session_id).await?;
println!("{:?}", session.browser_mode);For a session on Stealth Browser, the code prints stealth (Stealth in Rust).
stealthThe browser mode tells you which browser ran. It does not tell you whether a site blocked the session. For that, read the session's signals after it ends, as in Check the signals.
Use Stealth Browser with a proxy and CAPTCHA solving
Stealth Browser works with the other stealth options. This call adds a Steel proxy and CAPTCHA solving:
const session = await client.sessions.create({
experimentalFeatures: ["useStealthBrowser"],
useProxy: true,
solveCaptcha: true,
});session = client.sessions.create(
experimental_features=["useStealthBrowser"],
use_proxy=True,
solve_captcha=True,
)session, err := client.Sessions.New(ctx, steel.SessionNewParams{
ExperimentalFeatures: steel.F([]string{"useStealthBrowser"}),
UseProxy: steel.F[any](true),
SolveCaptcha: steel.F(true),
})
if err != nil {
return err
}let session = client
.sessions()
.create(steel_rs::SessionCreateParams {
experimental_features: Some(vec!["useStealthBrowser".to_owned()]),
use_proxy: Some(serde_json::Value::Bool(true)),
solve_captcha: Some(true),
..Default::default()
})
.await?;In Rust, this code needs cargo add serde_json.
On Stealth Browser, CAPTCHA solving does not detect or solve Cloudflare Turnstile or reCAPTCHA v3. Stealth Browser is built to pass these two without a solver. They do not appear in the CAPTCHA status, and they do not add captcha_encountered to the session's signals. When a Turnstile checkbox stays unchecked on the page for 3 seconds, Steel clicks it as a person would, and Cloudflare decides whether to let the session through. CAPTCHA solving still detects and solves the other types, such as reCAPTCHA v2 and hCaptcha.
stealthConfig.humanizeInteractions works on Stealth Browser as on the default browser. See Make input human-like.
How Stealth Browser differs from the default browser
| Default browser | Stealth Browser | |
|---|---|---|
| Browser | Chrome | Steel's own Chromium fork |
| Fingerprint | Steel injects one into the browser. On a desktop session, it reports a Linux computer. | The browser applies its own. It can report a Windows computer. |
skipFingerprintInjection in stealthConfig | Turns off Steel's fingerprint | Has no effect |
Cloudflare Turnstile and reCAPTCHA v3, with solveCaptcha | Steel detects and solves them | Steel does not detect or solve them |
browserMode | standard | stealth |
| Plans | Every plan | Enterprise |
A session on Stealth Browser can take longer to start than a session on the default browser.
Plans and pricing
Steel bills a session on Stealth Browser as any other session: browser hours, plus proxy bandwidth and CAPTCHA solves when the session uses them. What each plan includes shows which plans have it.
Troubleshooting
The useStealthBrowser experimental feature is not enabled
{
"message": "The useStealthBrowser experimental feature is not enabled for this organization.",
"error": "Forbidden",
"linkToDocs": "https://docs.steel.dev/overview/sessions-api/session-lifecycle"
}Cause: The request asks for Stealth Browser, but your organization has no access to it. Its plan does not include Stealth Browser, Steel has not turned on early access for it, and it has no trial, or its trial ended. The status is 403, and the response has no code.
Fix: Ask for access, as Get access explains. To continue on the default browser, remove useStealthBrowser from experimentalFeatures.
Verify: Create the session again. The response has a session id, and its browserMode is stealth.
core_browser_locked
{
"error": "Forbidden",
"code": "core_browser_locked",
"message": "Core Browser ('useStealthBrowser' in 'experimentalFeatures') is not available on your plan. Remove it from 'experimentalFeatures', or upgrade your plan.",
"param": "experimentalFeatures",
"retryable": false,
"linkToDocs": "https://docs.steel.dev/overview/pricinglimits"
}Cause: Steel turned on early access to Stealth Browser for your organization, but its plan does not include Stealth Browser, and it has no trial. Steel's billing check then refuses the session with 403 and the code core_browser_locked. The message calls Stealth Browser "Core Browser".
Fix: Ask Steel to add Stealth Browser to your plan, as Get access explains. To continue on the default browser, remove useStealthBrowser from experimentalFeatures.
Verify: Create the session again. The response has a session id, and its browserMode is stealth.