surfsky

Balance

Billing history

API key

Use this key to authenticate requests to the Surfsky API. Keep it secret.

Host

Your browsers run in this region. Use its URL as your API base. One change per 24 hours.

Usage

Blocked by a site?

Send us the URL and what happened. We'll look into it and email you back.

Report a blocked site

Get started

Read docs Chat with us

A prompt for your AI agent, the Python and TypeScript SDKs, or the raw API.

Read https://surfsky.io/SKILL.md and set up Surfsky in this project. Install the
skill and verify it with one real browser session.

Run the commands yourself. If credentials are missing, tell me what to put in
.env; never ask me to paste a token into chat. Redact secrets from output and
errors. Stop the browser when done.

Paste into Claude Code, Codex, Cursor, etc. The agent readssurfsky.io/SKILL.mdand sets up Surfsky. Add your API token to .env yourself; never paste it into chat.

Instructions

  1. 1.Let your agent set it up. Paste the prompt above into Claude Code, Codex, Cursor, etc. It reads surfsky.io/SKILL.md and does the rest. Or follow the quickstart yourself.
  2. 2.Put your credentials in .env. The key and host above go into SURFSKY_API_TOKEN and SURFSKY_API_BASE_URL.
  3. 3.Start a browser, then stop it. One-time for scraping, a persistent profile to keep a login. Running browsers bill per minute. Open ones are under Sessions.
  4. 4.Pick a proxy. Production runs on premium (residential and mobile) or your own.
  5. 5.Act human. Send clicks and keystrokes through human_emulation. Follow human behavior.
  6. 6.Handle captchas. Rare: recreate the browser and retry. Frequent: switch on the captcha solver. Still blocked? See troubleshooting or report the site.
  7. 7.See the browser. Watch it live with screencast, or open DevTools with debugging.
  8. 8.Keep the default fingerprint. Set fingerprint.os only when you need a specific OS.
  9. 9.Scale up. Check limits and concurrency, then change your plan for more parallel browsers.

Stuck? Email [email protected].