Skip to content

Install

Surfsky is a cloud service with no local agent to install. Access is entirely via the CDP WebSocket endpoint or the REST API using your API key from the dashboard.

Step 1: Get an API Key

Sign up at https://surfsky.io/ (free tier available, no credit card required). Your API key is shown in the dashboard.

Step 2: Install a Framework (if not already present)

Connect using any standard browser automation framework. Install whichever you use:

Playwright (Node.js)

bash
npm install playwright

Puppeteer (Node.js)

bash
npm install puppeteer-core

Selenium (Python)

bash
pip install selenium

chromedp (Go)

bash
go get github.com/chromedp/chromedp

Step 3: Set Your API Key

Store the key in an environment variable rather than hardcoding it:

bash
export SURFSKY_API_KEY=your_api_key_here

No other local installation is required. The cloud browser instances are provisioned on Surfsky's infrastructure and exposed via a WebSocket URL you connect to from your script.