DocsNavigationgo

go

Browser Go

One-shot browser navigation. Creates context, navigates, extracts HTML, closes context.

When to use go

Use go when you need to drive page navigation and browser history in an automation flow. It is part of Owl Browser's Navigation toolset and runs inside a self-hosted, source-level stealth engine, so every call inherits the same undetectable browser fingerprint as the rest of your automation — no separate anti-detect setup required.

Usage Example

1234567891011
import asyncio
from owl_browser import OwlBrowser, RemoteConfig
# Async usage
async with OwlBrowser(config) as browser:
context = await browser.create_context()
context_id = context["context_id"]
await browser.go(
url="https://example.com"
)

Parameters

Required

urlstringrequired

The full URL to navigate to, including protocol (e.g., 'https://example.com'). Supports http://, https://, file://, and data: URLs

Optional

wait_untilenum
loaddomcontentloadednetworkidle+1 more

When to consider navigation complete: 'load' (wait for load event, default; '' is treated as 'load'), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle), 'fullscroll' (scroll full page to trigger lazy loading, then scroll back to top)

timeoutinteger

Maximum time to wait for navigation in milliseconds. Default: 30000 (30 seconds)

outputenum
htmltextmarkdownpngView+1 more

Output format. html=raw HTML, text=extracted text, markdown=markdown conversion, pngView=viewport screenshot as PNG image, pngFull=fullpage screenshot as PNG image. Default: html

osenum
windowsmacoslinux

Filter profiles by operating system. Options: 'windows', 'macos', 'linux'

use_torboolean

Use TOR proxy for anonymous browsing. Each request gets a unique exit IP. Default: false

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}

Frequently Asked Questions

What does go do?

One-shot browser navigation. Creates context, navigates, extracts HTML, closes context. It belongs to Owl Browser's Navigation category and is available through the REST API, the Python SDK (browser.go()), the Node.js SDK, and the MCP server.

What parameters does go accept?

go accepts 1 required parameter (url) and 5 optional parameters. All parameters are sent as JSON in a POST request to /api/execute/go.

Is go detectable by anti-bot systems like Cloudflare or DataDome?

No. go executes inside Owl Browser's Chromium engine, which applies fingerprint spoofing at the C++ source level rather than through JavaScript patches. Every tool call shares the same consistent, human-like fingerprint, so anti-bot systems such as Cloudflare, DataDome, and Akamai see an ordinary browser.

Related Tools

browser_navigate

Navigate the browser to a specified URL. This is a non-blocking operation that starts navigation and returns immediately. Use browser_wait_for_network_idle or browser_wait_for_selector to wait for the page to fully load. Supports HTTP, HTTPS, file, and data URLs. When wait_until is set (load, networkidle, fullscroll, domcontentloaded) and the page declares WebMCP tools, the response includes a webmcp_tools array containing the full tool definitions (name, description, inputSchema). Use browser_webmcp_call_tool to execute any of these tools directly.

browser_reload

Reload the current page. Optionally bypass the browser cache for a hard reload that fetches all resources fresh from the server. Useful when testing changes or clearing stale cached content.

browser_go_back

Navigate back to the previous page in the browser's history stack. Equivalent to clicking the browser's back button. Does nothing if there is no previous page in history.

browser_go_forward

Navigate forward to the next page in the browser's history stack. Equivalent to clicking the browser's forward button. Only works after using browser_go_back. Does nothing if there is no forward history.

browser_can_go_back

Check if navigation back is possible. Returns true if there is a previous page in the browser history, false otherwise. Use before calling browser_go_back to avoid no-op calls.

browser_can_go_forward

Check if navigation forward is possible. Returns true if there is a next page in the browser history (after going back), false otherwise. Use before calling browser_go_forward.

Browse the full Owl Browser API reference or get started with the Python SDK and Node.js SDK.