Skip to main content

Tools Reference

Complete list of browser automation tools available to the Vibe AI agent.

Navigate to a specific URL.

{
"name": "navigate_to_url",
"args": { "url": "https://amazon.com" }
}

Browser history navigation.

{
"name": "navigate",
"args": { "action": "back" } // back, forward, refresh
}

Search the web using Google or DuckDuckGo.

{
"name": "web_search",
"args": { "query": "best laptop 2024" }
}

Interaction Tools

click_by_index

Click an element by its index number from page content.

{
"name": "click_by_index",
"args": { "index": 5 }
}

fill_by_index

Fill a form field by index.

{
"name": "fill_by_index",
"args": { "index": 3, "value": "search query" }
}

select_by_index

Select a dropdown option by index.

{
"name": "select_by_index",
"args": { "index": 2, "value": "Option Text" }
}

keypress

Send keyboard keys.

{
"name": "keypress",
"args": { "keys": ["Enter"] }
}

scroll

Scroll the page.

{
"name": "scroll",
"args": { "direction": "down", "pixels": 500 }
}

hover_element

Hover over an element to trigger tooltips/menus.

{
"name": "hover_element",
"args": { "index": 7 }
}

Tab Management

list_tabs

Get all open browser tabs.

{
"name": "list_tabs",
"args": {}
}

create_new_tab

Open a new tab.

{
"name": "create_new_tab",
"args": { "url": "https://google.com" }
}

switch_to_tab

Switch to a specific tab by ID.

{
"name": "switch_to_tab",
"args": { "tabId": 123 }
}

Content Tools

get_page_content

Get the current page's text content with element indices.

{
"name": "get_page_content",
"args": {}
}

Returns indexed content like:

[1] Search box (input)
[2] "Sign In" (link)
[3] "Products" (link)
...

take_screenshot

Capture a screenshot of the current page.

{
"name": "take_screenshot",
"args": { "fullPage": false }
}

Parallel Execution

subagent

Spawn a child agent for isolated task execution.

{
"name": "subagent",
"args": {
"systemPrompt": "Find the price of the first product on this page"
}
}

parallel

Execute multiple tool calls simultaneously.

{
"name": "parallel",
"args": {
"tool_uses": [
{ "name": "subagent", "args": { "systemPrompt": "Get price from site A" } },
{ "name": "subagent", "args": { "systemPrompt": "Get price from site B" } }
]
}
}

Wait Tools

wait

Wait for a specified time.

{
"name": "wait",
"args": { "milliseconds": 2000 }
}

wait_for_element

Wait for an element to appear.

{
"name": "wait_for_element",
"args": { "selector": "#results", "timeout": 5000 }
}

Advanced Tools

inject_js

Execute JavaScript on the page.

{
"name": "inject_js",
"args": { "code": "document.querySelector('#btn').click()" }
}

web_fetch

Fetch content from a URL without navigation.

{
"name": "web_fetch",
"args": { "url": "https://api.example.com/data" }
}

password_manager

Retrieve saved credentials (extension only).

{
"name": "password_manager",
"args": { "action": "get", "domain": "example.com" }
}

Tool Selection Tips

  1. Use indices - click_by_index and fill_by_index are more reliable than CSS selectors
  2. Check page content first - Always call get_page_content to see available elements
  3. Use subagents for complex tasks - Break down multi-site comparisons into parallel subagents
  4. Wait after navigation - Pages need time to load after navigate_to_url