tb_openBrowser
Start a remote WebDriver browser session on TestingBot for desktop or mobile web pages. Returns a sessionId and live view URL; pass a tunnel identifier to reach localhost or private sites.
Instructions
Start a remote browser session on TestingBot via WebDriver. Handles BOTH desktop browsers (Chrome/Edge/Safari/Firefox on Win/macOS/Linux) AND mobile browsers (Chrome on Android, Safari on iOS). For a mobile browser task, set deviceName and platformVersion — the session is still WebDriver/chromedriver-backed, so tb_navigate / tb_snapshot / tb_screenshot / tb_click work directly with no native-context juggling. By default a mobile session runs on an EMULATOR (Android) / SIMULATOR (iOS); set realDevice: true to run on a physical device instead — ALWAYS do this when the user asks for a 'real device', 'physical device', or 'real hardware'. Prefer this over appium_session_management for any task whose goal is loading a web page in a browser, even on mobile. Reserve appium_session_management for native-app testing (.apk/.ipa). Local or private sites (localhost, 127.0.0.1, 10.x/192.168.x, intranet hosts): the remote browser can only reach these through a running TestingBot Tunnel, and only when this session names that tunnel via tunnelIdentifier — without it the session silently goes direct and the page fails to load. Returns a sessionId for subsequent tool calls and a liveViewUrl the human can open to watch the agent drive in real time. Burns TestingBot minutes — call tb_closeBrowser when done.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"browserName": "<browserName>",
"platform": "<platform>"
},
"name": "tb_openBrowser"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Human-readable session name (shown in dashboard) | |
| build | No | Build identifier for grouping | |
| platform | Yes | Platform/OS. Desktop codes like 'WIN11', 'VENTURA', 'macOS Ventura', or for mobile pass 'Android' or 'iOS' (and also set deviceName + platformVersion). | |
| deviceName | No | Mobile device name (e.g. 'Google Pixel 8', 'iPhone 15 Pro'). REQUIRED for mobile-browser sessions. Triggers Appium-style capabilities under the hood, but the resulting session is still WebDriver — use tb_navigate / tb_snapshot etc. as usual. | |
| realDevice | No | Run on a physical device instead of an emulator/simulator (mobile only). Set true whenever the user asks for a 'real device' or 'physical device'. Ignored for desktop. If the requested physical device is unavailable, this tool returns (without starting a session) a list of available alternatives plus the option to wait or use an emulator — relay those choices to the user. | |
| browserName | Yes | Browser engine | |
| automationName | No | Mobile automation engine override. Defaults: 'UiAutomator2' for Android, 'XCUITest' for iOS. Only set this if you have a specific reason. | |
| browserVersion | No | Browser version (desktop only, default: 'latest'). Ignored for mobile. | latest |
| platformVersion | No | Mobile OS version (e.g. '14' for Android 14, '17' for iOS 17). Pair with deviceName. | |
| screenResolution | No | Screen resolution for desktop sessions (e.g., '1920x1080'). Ignored for mobile. | |
| tunnelIdentifier | No | Identifier of a running TestingBot Tunnel (the value it was started with via --tunnel-identifier, or the one startTunnel returned) to route this session through. REQUIRED to open localhost / private-network URLs. Defaults to the TESTINGBOT_TUNNEL_IDENTIFIER environment variable when set. |