Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
Shorter tools
Magnus Müller55d10605fd0c
diff --git a/browser_use/tools/service.py b/browser_use/tools/service.pyindex 8e24773e9..3e7b526a6 100644--- a/browser_use/tools/service.py+++ b/browser_use/tools/service.py@@ -131,10 +131,10 @@ class Tools(Generic[Context]):'bing': f'https://www.bing.com/search?q={encoded_query}',}- if params.search_engine.lower() not in search_engines:- return ActionResult(error=f'Unsupported search engine: {params.search_engine}. Options: duckduckgo, google, bing')+ if params.engine.lower() not in search_engines:+ return ActionResult(error=f'Unsupported search engine: {params.engine}. Options: duckduckgo, google, bing')- search_url = search_engines[params.search_engine.lower()]+ search_url = search_engines[params.engine.lower()]# Simple tab logic: use current tab by defaultuse_new_tab = False@@ -149,13 +149,13 @@ class Tools(Generic[Context]):)await eventawait event.event_result(raise_if_any=True, raise_if_none=False)- memory = f"Searched {params.search_engine.title()} for '{params.query}'"+ memory = f"Searched {params.engine.title()} for '{params.query}'"msg = f'🔍 {memory}'logger.info(msg)return ActionResult(extracted_content=memory, long_term_memory=memory)except Exception as e:- logger.error(f'Failed to search {params.search_engine}: {e}')- return ActionResult(error=f'Failed to search {params.search_engine} for "{params.query}": {str(e)}')+ logger.error(f'Failed to search {params.engine}: {e}')+ return ActionResult(error=f'Failed to search {params.engine} for "{params.query}": {str(e)}')@self.registry.action('Navigate to URL.',@@ -313,7 +313,7 @@ class Tools(Generic[Context]):TypeTextEvent(node=node,text=params.text,- clear_existing=params.clear_existing,+ clear_existing=params.clear,is_sensitive=has_sensitive_data,sensitive_key_name=sensitive_key_name,)@@ -683,18 +683,18 @@ You will be given a query and the markdown of a webpage that has been filtered t# Look up the node from the selector map if index is provided# Special case: index 0 means scroll the whole page (root/body element)node = None- if params.frame_element_index is not None and params.frame_element_index != 0:- node = await browser_session.get_element_by_index(params.frame_element_index)+ if params.frame_idx is not None and params.frame_idx != 0:+ node = await browser_session.get_element_by_index(params.frame_idx)if node is None:# Element does not exist- msg = f'Element index {params.frame_element_index} not found in browser state'+ msg = f'Element index {params.frame_idx} not found in browser state'return ActionResult(error=msg)direction = 'down' if params.down else 'up'target = ('the page'- if params.frame_element_index is None or params.frame_element_index == 0- else f'element {params.frame_element_index}'+ if params.frame_idx is None or params.frame_idx == 0+ else f'element {params.frame_idx}')# Get actual viewport height for more accurate scrolling@@ -715,11 +715,11 @@ You will be given a query and the markdown of a webpage that has been filtered tlogger.debug(f'Failed to get viewport height, using fallback 1000px: {e}')# For multiple pages (>=1.0), scroll one page at a time to ensure each scroll completes- if params.num_pages >= 1.0:+ if params.pages >= 1.0:import asyncio- num_full_pages = int(params.num_pages)- remaining_fraction = params.num_pages - num_full_pages+ num_full_pages = int(params.pages)+ remaining_fraction = params.pages - num_full_pagescompleted_scrolls = 0@@ -761,19 +761,19 @@ You will be given a query and the markdown of a webpage that has been filtered texcept Exception as e:logger.warning(f'Fractional scroll failed: {e}')- if params.num_pages == 1.0:+ if params.pages == 1.0:long_term_memory = f'Scrolled {direction} {target} by one page ({viewport_height}px)'else:- long_term_memory = f'Scrolled {direction} {target} by {completed_scrolls:.1f} pages (requested: {params.num_pages}, {viewport_height}px per page)'+ long_term_memory = f'Scrolled {direction} {target} by {completed_scrolls:.1f} pages (requested: {params.pages}, {viewport_height}px per page)'else:# For fractional pages <1.0, do single scroll- pixels = int(params.num_pages * viewport_height)+ pixels = int(params.pages * viewport_height)event = browser_session.event_bus.dispatch(ScrollEvent(direction='down' if params.down else 'up', amount=pixels, node=node))await eventawait event.event_result(raise_if_any=True, raise_if_none=False)- long_term_memory = f'Scrolled {direction} {target} by {params.num_pages} pages ({viewport_height}px per page)'+ long_term_memory = f'Scrolled {direction} {target} by {params.pages} pages ({viewport_height}px per page)'msg = f'🔍 {long_term_memory}'logger.info(msg)@@ -1170,10 +1170,10 @@ WRONG: document.querySelector('#id').value""",memory += f' - {len_text - len_max_memory} more characters'attachments = []- if params.files_to_display:+ if params.files:if self.display_files_in_done_text:file_msg = ''- for file_name in params.files_to_display:+ for file_name in params.files:if file_name == 'todo.md':continuefile_content = file_system.display_file(file_name)@@ -1186,7 +1186,7 @@ WRONG: document.querySelector('#id').value""",else:logger.warning('Agent wanted to display files but none were found')else:- for file_name in params.files_to_display:+ for file_name in params.files:if file_name == 'todo.md':continuefile_content = file_system.display_file(file_name)diff --git a/browser_use/tools/views.py b/browser_use/tools/views.pyindex 44fab1347..692757c6f 100644--- a/browser_use/tools/views.py+++ b/browser_use/tools/views.py@@ -31,14 +31,14 @@ class ClickElementAction(BaseModel):class InputTextAction(BaseModel):- index: int = Field(ge=1, description='from browser_state')+ index: int = Field(ge=1, description='index')text: str- clear_existing: bool = Field(default=True, description='True to clear, False to append')+ clear: bool = Field(default=True, description='1=clear, 0=append')class DoneAction(BaseModel):text: str = Field(description='summary for user')- success: bool = Field(description='True if completed')+ success: bool = Field(description='True if user_request completed successfully')files_to_display: list[str] | None = Field(default=[], description='files to display')@@ -46,22 +46,22 @@ T = TypeVar('T', bound=BaseModel)class StructuredOutputAction(BaseModel, Generic[T]):- success: bool = Field(default=True, description='True if finished, False if not')+ success: bool = Field(default=True, description='1=done')data: Tclass SwitchTabAction(BaseModel):- tab_id: str = Field(min_length=4, max_length=4, description="from browser_state ('Tab <tab_id>')")+ tab_id: str = Field(min_length=4, max_length=4, description='4-char id')class CloseTabAction(BaseModel):- tab_id: str = Field(min_length=4, max_length=4, description="from browser_state ('Tab <tab_id>')")+ tab_id: str = Field(min_length=4, max_length=4, description='4-char id')class ScrollAction(BaseModel):- down: bool = Field(description='True=down, False=up')- num_pages: float = Field(default=1.0, description='pages to scroll (0.5=half, 1=page, 10=bottom)')- frame_element_index: int | None = Field(default=None, description='index for specific container')+ down: bool = Field(description='1=down, 0=up')+ pages: float = Field(default=1.0, description='0.5=half, 1=pg, 10=bottom')+ frame_index: int | None = Field(default=None, description='container index')class SendKeysAction(BaseModel):@@ -69,7 +69,7 @@ class SendKeysAction(BaseModel):class UploadFileAction(BaseModel):- index: int = Field(description='from browser_state')+ index: int = Field(description='index')path: str@@ -78,15 +78,13 @@ class ExtractPageContentAction(BaseModel):class NoParamsAction(BaseModel):- """Accepts any input, discards it, returns empty model."""-model_config = ConfigDict(extra='ignore')class GetDropdownOptionsAction(BaseModel):- index: int = Field(ge=1, description='dropdown from browser_state')+ index: int = Field(ge=1, description='index')class SelectDropdownOptionAction(BaseModel):- index: int = Field(ge=1, description='dropdown from browser_state')- text: str = Field(description='exact text/value to select')+ index: int = Field(ge=1, description='index')+ text: str = Field(description='exact text/value')