WebBrowser Tools

Search for a page with WebSearchTools and open it in a local browser with WebBrowserTools.

webbrowser_tools.py
"""
Webbrowser Tools
=============================

Demonstrates webbrowser tools.
"""

from agno.agent import Agent
from agno.models.google import Gemini
from agno.tools.webbrowser import WebBrowserTools
from agno.tools.websearch import WebSearchTools

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------


# Example 1: Enable specific WebBrowser functions
agent = Agent(
    model=Gemini("gemini-2.0-flash"),
    tools=[WebBrowserTools(enable_open_page=True), WebSearchTools()],
    instructions=[
        "Find related websites and pages using DuckDuckGo",
        "Use web browser to open the site",
    ],
    markdown=True,
)

# Example 2: Enable all WebBrowser functions
agent_all = Agent(
    model=Gemini("gemini-2.0-flash"),
    tools=[WebBrowserTools(all=True), WebSearchTools()],
    instructions=[
        "Find related websites and pages using DuckDuckGo",
        "Use web browser to open the site with full functionality",
    ],
    markdown=True,
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    agent.print_response(
        "Find an article explaining MCP and open it in the web browser."
    )

Before running, replace both Gemini("gemini-2.0-flash") instances with Gemini(id="gemini-3.6-flash"); Google has shut down Gemini 2.0 Flash. Run on a machine with a configured desktop browser. WebBrowserTools asks the operating system to open a URL; it cannot inspect or interact with the page. all=True enables the same single open_page function.

Run the Example

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

Install dependencies

uv pip install -U agno ddgs google-genai

Export your Google API key

export GOOGLE_API_KEY="your_google_api_key_here"

Run the example

Save the code above as webbrowser_tools.py, then run:

python webbrowser_tools.py

Full source: cookbook/91_tools/webbrowser_tools.py