Navigation Actions

Actions for navigating web pages and controlling browser history

Navigation actions control how the agent moves between pages and searches the web.

search

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, bing

Default 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

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

---

Related Actions

• Interaction Actions - Click, input, and interact with page elements
• Extraction Actions - Extract data from pages