Docsbrowser_search

browser_search

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.

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.search(

query="value"

)

Parameters

Required

querystringrequired

The search query string (e.g., 'best restaurants in NYC', 'python tutorial')

Optional

providerenum

duckduckgogoogle

Search engine provider. 'duckduckgo' uses DuckDuckGo HTML-lite, 'google' uses Google Search. Default: duckduckgo

pagestring

Page number for paginated results (1-based). Default: 1. For Google: appends &start=((page-1)*10). For DuckDuckGo: appends &s=((page-1)*10)

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>
}