name: google-search-browser-use
description: Use browser-use to perform Google searches, open results, and extract key information from live pages. Use when the user asks to "search Google", "look this up on Google", or needs current web results via a real browser session (often to avoid bot blocks).

Google Search Browser Use

Overview

Run Google searches with browser-use (prefer real browser mode), open results, and extract the relevant snippets or page content. This skill leverages the user's existing browser session to reduce CAPTCHAs.

Prerequisites

Before running the search, ensure the environment is ready:

1. Check Installation:
   Verify if browser-use is available in the current PATH.
   bash which browser-use

2. Install if Missing:
   If not found, install it using pip.
   bash python3 -m pip install --user browser-use

3. Locate Binary:
   If the command is still not found after installation, it is likely in the user's local bin directory. Retrieve the path dynamically:
   bash python3 -m site --user-base # The binary is typically at <USER_BASE>/bin/browser-use

Workflow

1) Launch a Google search (Real Browser Mode)

Use the real browser to reuse the user’s logged-in session.

Option A: Standard Execution

browser-use --browser real open "https://www.google.com/search?q=YOUR+QUERY"

Option B: Explicit Path Execution
If Option A fails (command not found), use the full path found in Prerequisites:

# Example (adjust based on 'python3 -m site --user-base' output):
${HOME}/Library/Python/3.14/bin/browser-use --browser real open "https://www.google.com/search?q=YOUR+QUERY"

(Note: Replace 3.14 with your current Python version if different)

2) Inspect results and parse

Once the browser is open:

# Check current page state
browser-use --browser real state

# Click on a search result (use index from state output)
browser-use --browser real click <index>

3) Extract or Summarize

• Goal: Provide a short summary (3-6 bullets) with source citations.
• Fallback: If browser-use struggles with parsing, use curl with Jina AI for a text-friendly version:
  bash curl -L "https://r.jina.ai/https://example.com"

4) Close the Session

browser-use close

Troubleshooting

• CAPTCHAs: If encountered, solve them manually in the open browser window.
• Path Issues: If browser-use cannot be called directly, always prefer finding the path via python3 -m site --user-base rather than guessing.
• Connection: Ensure no VPN/Proxy is blocking Google results if timeouts occur.