Docsbrowser_go

browser_go

Use browser_go when you need to automate a browser task. It is part of Owl Browser's automation 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 browser_go do?

One-shot browser navigation tool. Creates a new context, navigates to the URL, waits for page load, extracts the HTML, and closes the context. Optimized for single-page scraping or rendering tasks. Callable as POST /execute/browser_go or the GET /go?url=... convenience endpoint (page requests are always GET). It belongs to Owl Browser's browser automation category and is available through the REST API, the Python SDK (browser.go()), the Node.js SDK, and the MCP server.

What parameters does browser_go accept?

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

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

No. browser_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_search

One-shot web search tool. Creates a new context, navigates to the search engine, waits for results, extracts structured JSON search results (titles, URLs, snippets), and closes the context. Supports Google and DuckDuckGo with pagination.

browser_set_content

Set the page's HTML content directly. Replaces the current page content with the provided HTML. The page URL will be 'about:blank'. Useful for rendering HTML templates, testing, or injecting content without making a network request.

browser_create_context

Create a new isolated browser context with its own cookies, storage, and optional proxy configuration. Each context acts as an independent browser session. Use this to create multiple isolated browsing sessions, configure proxy/Tor connections, load browser profiles with saved fingerprints, and enable/disable LLM features. Returns a context_id to use with other browser 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_observe

Agent-native page observation. Returns the compacted OwlMark render (text-only structural view of the page), a handle table of interactive elements with stable tokens, page metadata, and a token estimate. Pass a handle token (e.g. 'b3') or 'pm:N' to browser_click/browser_type. Requires the context to be created with render_mode 'agent' or 'both'. ~20-100x fewer tokens than a screenshot for AI agent page understanding.

browser_click

Click on an element using CSS selector, XY coordinates, or natural language description. Supports semantic element finding using AI - describe what you want to click (e.g., 'login button', 'search icon') and the system will locate the right element. Simulates a real mouse click with proper event dispatch. Optionally hold the mouse button for press-and-hold interactions using hold_ms.

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