PluginBench
Skill
Fail
Audit score 45

google-search-browser-use

grasseed/google-search-browser-use

Search Google with a real browser session to get live results and extract page content while avoiding bot blocks.

What is google-search-browser-use?

This skill uses browser-use to perform Google searches, open results, and extract information from live pages. Use it when you need current web results via a real browser session, especially to avoid CAPTCHAs and bot detection.

  • Perform Google searches using a real browser session
  • Open and navigate search results
  • Extract snippets and page content from live websites
  • Reuse existing logged-in browser sessions to reduce CAPTCHAs
  • Fall back to curl/Jina AI for text extraction if needed

How to install google-search-browser-use

npx skills add https://github.com/grasseed/google-search-browser-use --skill google-search-browser-use
Prerequisites
  • browser-use installed (via pip install --user browser-use)
  • Python 3.x available
  • Access to Google and target websites
Claude Code
Cursor
Windsurf
Cline

How to use google-search-browser-use

  1. 1.Verify browser-use is installed by running 'which browser-use' or install via pip if missing
  2. 2.Launch a Google search with 'browser-use --browser real open "https://www.google.com/search?q=YOUR+QUERY"'
  3. 3.Check the page state with 'browser-use --browser real state' to see available results
  4. 4.Click on a search result using 'browser-use --browser real click <index>'
  5. 5.Extract content from the opened page or use curl with Jina AI as a fallback
  6. 6.Close the session with 'browser-use close'

Use cases

Good for
  • Search for current information not in training data
  • Look up live product prices, availability, or reviews
  • Find recent news articles or announcements
  • Extract content from websites that block automated requests
  • Research topics requiring real-time web data
Who it's for
  • Developers needing live web search capabilities
  • Users requiring current information beyond training data
  • Anyone avoiding CAPTCHA challenges during searches

google-search-browser-use FAQ

What should I do if I encounter a CAPTCHA?

Solve it manually in the open browser window. Using a real browser session helps reduce CAPTCHA frequency by reusing your logged-in session.

What if 'browser-use' command is not found?

Run 'python3 -m site --user-base' to find your local bin directory, then use the full path like '${HOME}/Library/Python/3.14/bin/browser-use' (adjust Python version as needed).

How do I extract content if browser-use struggles with parsing?

Use curl with Jina AI as a fallback: 'curl -L "https://r.jina.ai/https://example.com"' to get a text-friendly version of the page.

Does this work with VPNs or proxies?

VPNs or proxies may block Google results and cause timeouts. Ensure your connection is not being blocked by these services.

Can I reuse my existing browser session?

Yes, using '--browser real' mode reuses your logged-in session, which helps reduce CAPTCHAs and bot detection.

Full instructions (SKILL.md)

Source of truth, from grasseed/google-search-browser-use.


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.

    which browser-use
    
  2. Install if Missing: If not found, install it using pip.

    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:

    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:
    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.