browser_navigate

Description

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.

Usage Example

CURL

POST `/api/execute/browser_navigate`

curl -X POST \
 -H "Authorization: Bearer <token>" \
 -H "Content-Type: application/json" \
 -d '{

"context_id": "ctx_000001",

"url": "https://example.com"

}' \
http://localhost:8080/api/execute/browser_navigate

Python SDK

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.navigate(
        context_id=context_id,
        url="https://example.com"
    )

Node.js SDK

import { OwlBrowser } from '@olib-ai/owl-browser-sdk';

// Async usage

const ctx = await browser.createContext();
const contextId = ctx.context_id;
await browser.navigate({
    context_id: contextId,
    url: 'https://example.com'
});

Parameters

Required

• context_id string required
  The unique identifier of the browser context to navigate (e.g., 'ctx_000001')
• url string required
  The full URL to navigate to, including protocol (e.g., 'https://example.com'). Supports http://, https://, file://, and data: URLs

Optional

• wait_until enum
  When to consider navigation complete: '' (return immediately, default), 'load' (wait for load event), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle), 'fullscroll' (scroll full page to trigger lazy loading, then scroll back to top)
• timeout string
  Maximum time to wait for navigation in milliseconds. Only used when wait_until is set. Default: 30000 (30 seconds)

Response

Returns a JSON object with the operation result.

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