Back to docs

Tool Click

Category: Browser Automation · Tier: All

Click an element on the page. Pass _browserToken from the previous tool call to stay on the same page. Without it, clicks go to a blank new browser.

When to Use

Browser automation tools map to human motor interaction research. Click accuracy, form filling, and scroll behavior follow established HCI models.

Parameters

Parameter Type Required Description
selector string Yes Element to click (text content, CSS selector, or description)
force boolean No Allow clicking red-zone elements
verbose boolean No Return available elements on failure

Example

Click the "Sign Up" button on the landing page

Tips

  • Pass _browserToken from a previous tool call to maintain the same browser session
  • The tool returns a _browserToken in its response — pass it to subsequent calls
  • Without _browserToken, each call gets a fresh browser (blank page)

Research

Related

From the Blog