🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Browser Use API

by @jfrux

Cloud browser automation via Browser Use API. Use when you need AI-driven web browsing, scraping, form filling, or multi-step web tasks without local browser control. Triggers on "browser use", "cloud browser", "scrape website", "automate web task", or when local browser isn't available/suitable.

Versionv1.0.1
Downloads3,714
Installs7
Stars⭐ 3
TERMINAL
clawhub install browser-use-api

πŸ“– About This Skill


name: browser-use version: 1.0.0 description: Cloud browser automation via Browser Use API. Use when you need AI-driven web browsing, scraping, form filling, or multi-step web tasks without local browser control. Triggers on "browser use", "cloud browser", "scrape website", "automate web task", or when local browser isn't available/suitable. metadata: {"clawdbot":{"emoji":"🌐","requires":{"env":["BROWSER_USE_API_KEY"]}}}

Browser Use

Cloud-based AI browser automation. Send a task in plain English, get structured results.

Quick Start

# Submit task
curl -s -X POST https://api.browser-use.com/api/v2/tasks \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "Go to example.com and extract the main heading"}'

Poll for result (replace TASK_ID)

curl -s "https://api.browser-use.com/api/v2/tasks/TASK_ID" \ -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"

Helper Script

Use scripts/browser-use.sh for simpler execution:

# Run task and wait for result
./scripts/browser-use.sh "Go to hacker news and get the top 3 stories"

Just submit (don't wait)

./scripts/browser-use.sh --no-wait "Search Google for AI news"

API Reference

Create Task

POST https://api.browser-use.com/api/v2/tasks

Body:

{
  "task": "Plain English description of what to do",
  "llm": "gemini-3-flash-preview"  // optional, default is fast model
}

Response:

{
  "id": "task-uuid",
  "sessionId": "session-uuid"
}

Get Task Status

GET https://api.browser-use.com/api/v2/tasks/{taskId}

Response fields:

  • status: pending | started | finished | failed
  • output: Result text when finished
  • steps: Array of actions taken (with screenshots)
  • cost: Cost in dollars (e.g., "0.02")
  • isSuccess: Boolean result
  • Stop Task

    POST https://api.browser-use.com/api/v2/tasks/{taskId}/stop
    

    Pricing

    ~$0.01-0.05 per task depending on complexity. Check balance:

    curl -s https://api.browser-use.com/api/v2/credits \
      -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"
    

    When to Use

  • Complex multi-step web workflows
  • Sites that block simple scraping
  • Form filling and submissions
  • When you need screenshots of steps
  • When local browser control isn't available
  • When NOT to Use

  • Simple page fetches (use web_fetch instead)
  • When you have local browser access (use browser tool)
  • Rapid/high-volume scraping (use Code Use or local scraping)
  • ⚑ When to Use

    TriggerAction
    - Sites that block simple scraping
    - Form filling and submissions
    - When you need screenshots of steps
    - When local browser control isn't available

    πŸ’‘ Examples

    # Submit task
    curl -s -X POST https://api.browser-use.com/api/v2/tasks \
      -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"task": "Go to example.com and extract the main heading"}'

    Poll for result (replace TASK_ID)

    curl -s "https://api.browser-use.com/api/v2/tasks/TASK_ID" \ -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"