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
- If you have not already done so, sign up for an Eyevinn OSC account
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"