SkillHub

browser-use-api

v1.0.1

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.

Sourced from ClawHub, Authored by jfrux

Installation

Please help me install the skill `browser-use-api` from SkillHub official store. npx skills add jfrux/browser-use-api

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)