feat(tools): add use_browser tool to Strands tools repository (#102)

* feat(tools): add use_browser tool to Strands tools repository

* test(use_browser): add more unit testing for use_browser tool

* feat(tools): add retry and multi-tab support to use_browser tool

Adding functionality so use_browser tool has some retry functionality and supports multiple tabs and switching between them.

* feat: add more retry logic and environment variables

* fix(use_browser): fix screenshot error and using Playwright specific errors for better error handling

* fix(use_browser): fix logs and fix how actions are being called, now actions are only called with their required arguments

* fix(use_browser): fix merge conflicts in README file

* Delete src/strands_tools/use_computer.py

* test(use_browser): add more unit testing for use_browser tool

* Update use_browser.py

* test(use_browser): add more unit testing for use_browser tool

* fix(use_browser): fix merge conflicts in README file

* feat(use_browser): Added BrowserApiMethods class which has all the browser actions as methods

* feat: Updating readme and pyproject.toml

* feat: Adding use_browser tool

* fix: fixing README file

* fix: fixing dependencies for testing

* fix: cleaning logs and updating README file

* fix: fixing log statements to pass all checks

Author: jimbrub

README.md

@@ -53,7 +53,8 @@ Strands Agents Tools provides a powerful set of tools for your agents to use. It
 - 🧠 **Advanced Reasoning** - Tools for complex thinking and reasoning capabilities
 - 🐝 **Swarm Intelligence** - Coordinate multiple AI agents for parallel problem solving with shared memory
 - 🔄 **Multiple tools in Parallel**  - Call multiple other tools at the same time in parallel with Batch Tool
-  
+- 🔍 **Browser Tool** - Tool giving an agent access to perform automated actions on a browser (chromium)
+
 ## 📦 Installation
 
 ### Quick Install
@@ -121,6 +122,7 @@ Below is a comprehensive table of all available tools, how to use them with an a
 | use_llm | `agent.tool.use_llm(prompt="Analyze this data", system_prompt="You are a data analyst")` | Create nested AI loops with customized system prompts for specialized tasks |
 | workflow | `agent.tool.workflow(action="create", name="data_pipeline", steps=[{"tool": "file_read"}, {"tool": "python_repl"}])` | Define, execute, and manage multi-step automated workflows |
 | batch| `agent.tool.batch(invocations=[{"name": "current_time", "arguments": {"timezone": "Europe/London"}}, {"name": "stop", "arguments": {}}])` | Call multiple other tools in parallel. |
+| use_browser | `agent.tool.use_browser(action="navigate", url="https://www.example.com")	` | Web scraping, automated testing, form filling, web automation tasks |
 
 \* *These tools do not work on windows*
 
@@ -301,6 +303,32 @@ result = agent.tool.batch(
 )
 ```
 
+### Use Browser
+```python
+from strands import Agent
+from strands_tools import use_browser
+
+agent = Agent(tools=[use_browser])
+
+# Simple navigation
+result = agent.tool.use_browser(action="navigate", url="https://example.com")
+
+# Sequential actions for form filling
+result = agent.tool.use_browser(actions=[
+    {"action": "navigate", "args": {"url": "https://example.com/login"}},
+    {"action": "type", "args": {"selector": "#username", "text": "[email protected]"}},
+    {"action": "click", "args": {"selector": "#submit"}}
+])
+
+# Web scraping with content extraction
+result = agent.tool.use_browser(actions=[
+    {"action": "navigate", "args": {"url": "https://example.com/data"}},
+    {"action": "get_text", "args": {"selector": ".content"}},
+    {"action": "click", "args": {"selector": ".next-page"}},
+    {"action": "get_html", "args": {"selector": "main"}}
+])
+```
+
 ## 🌍 Environment Variables Configuration
 
 Agents Tools provides extensive customization through environment variables. This allows you to configure tool behavior without modifying code, making it ideal for different environments (development, testing, production).
@@ -443,6 +471,20 @@ The Mem0 Memory Tool supports three different backend configurations:
 | FILE_READ_USE_GIT_DEFAULT | Default setting for using git in time machine mode | true |
 | FILE_READ_NUM_REVISIONS_DEFAULT | Default number of revisions to show in time machine mode | 5 |
 
+#### Use Browser Tool
+
+| Environment Variable | Description | Default | 
+|----------------------|-------------|---------|
+| STRANDS_DEFAULT_WAIT_TIME | Default setting for wait time with actions | 1 |
+| STRANDS_BROWSER_MAX_RETRIES | Default number of retries to perform when an action fails | 3 |
+| STRANDS_BROWSER_RETRY_DELAY | Default retry delay time for retry mechanisms | 1 |
+| STRANDS_BROWSER_SCREENSHOTS_DIR | Default directory where screenshots will be saved | screenshots |
+| STRANDS_BROWSER_USER_DATA_DIR | Default directory where data for reloading a browser instance is stored | ~/.browser_automation |
+| STRANDS_BROWSER_HEADLESS | Default headless setting for launching browsers | false |
+| STRANDS_BROWSER_WIDTH | Default width of the browser | 1280 |
+| STRANDS_BROWSER_HEIGHT | Default height of the browser | 800 |
+
+
 ## Contributing ❤️
 
 We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for details on:

pyproject.toml

@@ -68,6 +68,8 @@ dev = [
     "responses>=0.6.1,<1.0.0",
     "mem0ai>=0.1.104,<1.0.0",
     "opensearch-py>=2.8.0,<3.0.0",
+    "nest-asyncio>=1.5.0,<2.0.0",
+    "playwright>=1.42.0,<2.0.0",
 ]
 docs = [
     "sphinx>=5.0.0,<6.0.0",
@@ -112,7 +114,10 @@ extra-dependencies = [
     "pytest>=8.0.0,<9.0.0",
     "pytest-cov>=4.1.0,<5.0.0",
     "pytest-xdist>=3.0.0,<4.0.0",
-    "responses>=0.6.1,<1.0.0"
+    "responses>=0.6.1,<1.0.0",
+    "pytest_asyncio>=0.23.0,<1.0.0",
+    "nest-asyncio>=1.5.0,<2.0.0",
+    "playwright>=1.42.0,<2.0.0"
 ]
 extra-args = [
     "-n",
@@ -134,7 +139,6 @@ run-cov = [
 cov-combine = []
 cov-report = []
 
-
 [tool.hatch.envs.default.scripts]
 list = [
     "echo 'Scripts commands available for default env:'; hatch env show --json | jq --raw-output '.default.scripts | keys[]'"