Skip to main content
Navigation actions control how the agent moves between pages and searches the web. Search for a query using a search engine.
​
query
string
required
The search query to execute
​
engine
string
default:"duckduckgo"
Search engine to use. Options: duckduckgo, google, bingDefault is duckduckgo because it has fewer captchas.

​
Example

from browser_use import Agent, Browser, ChatBrowserUse

agent = Agent(
    task="Search for 'browser automation' on Google",
    llm=ChatBrowserUse(),
    browser=Browser()
)

await agent.run()
Implementation: browser_use.tools.service:365
Navigate to a specific URL.
​
url
string
required
The URL to navigate to. Must include protocol (http:// or https://)
​
new_tab
bool
default:"False"
Whether to open the URL in a new tab

​
Example

from browser_use import Agent, Browser, ChatBrowserUse

agent = Agent(
    task="Go to https://example.com and open https://github.com in a new tab",
    llm=ChatBrowserUse(),
    browser=Browser()
)

await agent.run()
Implementation: browser_use.tools.service:411

​
go_back

Navigate back in browser history.
This action takes no parameters.

​
Example

from browser_use import Agent, Browser, ChatBrowserUse

agent = Agent(
    task="Visit example.com, then go back",
    llm=ChatBrowserUse(),
    browser=Browser()
)

await agent.run()
Implementation: browser_use.tools.service:455