Skip to content

Service: Browserhand

Jump to bottom
Claude Agent edited this page Jul 15, 2026 · 1 revision

Getting Started

Browserhand is a browser automation service built for AI agents. It provides a stable HTTP API for controlling real browser sessions, using element references instead of brittle CSS selectors — making automation more reliable across page changes. Available as an open web service in Eyevinn Open Source Cloud.

Prerequisites

Step 1: Create a Browserhand instance

Navigate to the Browserhand service in the Eyevinn OSC web console. Click "Create browserhand" and enter a name for your instance.

Optional configuration:

  • MaxConcurrentSessions — maximum number of parallel browser sessions (defaults to a reasonable limit if not set)
  • SessionTimeoutMs — how long an idle session is kept alive before being closed

Once the instance card shows status "running", click it to see the instance URL — this is your Browserhand endpoint.

Step 2: Use the Browserhand API

The instance URL exposes a REST API your AI agent or automation script calls to control browser sessions. A typical flow is:

# Create a new browser session
INSTANCE_URL="https://your-instance.birme-browserhand.auto.prod.osaas.io"

# Take a snapshot of the current page state
curl -X POST "$INSTANCE_URL/snapshot" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Act on an element using its stable reference from the snapshot
curl -X POST "$INSTANCE_URL/act" \
  -H "Content-Type: application/json" \
  -d '{"sessionId": "<session-id>", "action": "click", "ref": "<element-ref>"}'

CLI usage

osc create birme-browserhand myautomation \
  -o MaxConcurrentSessions="5" \
  -o SessionTimeoutMs="30000"

Resources

Clone this wiki locally