Scalable Remote Browsers
For Your AI Agents

# 1. start a browser (warm pool, managed proxy)
SESSION=$(curl -s -X POST https://api1.crawlnode.com/api/start \
  -H "Token: $CRAWLNODE_TOKEN" -H "Content-Type: application/json" \
  -d '{"proxy":"auto"}' | sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p')

# 2. navigate
curl -s -X POST https://api1.crawlnode.com/api/go \
  -H "Token: $CRAWLNODE_TOKEN" -H "X-Session-Id: $SESSION" \
  -H "Content-Type: application/json" -d '{"url":"https://example.com"}'

# 3. screenshot of the page (WebP bytes); drop "area" for the whole window
curl -s -X POST https://api1.crawlnode.com/api/screenshot \
  -H "Token: $CRAWLNODE_TOKEN" -H "X-Session-Id: $SESSION" \
  -H "Content-Type: application/json" -d '{"area":"viewport"}' -o page.webp

# 4. always destroy
curl -s -X POST https://api1.crawlnode.com/api/destroy \
  -H "Token: $CRAWLNODE_TOKEN" -H "X-Session-Id: $SESSION" \
  -H "Content-Type: application/json" -d '{}'

import json, os, urllib.request

BASE = "https://api1.crawlnode.com"
TOKEN = os.environ["CRAWLNODE_TOKEN"]

def call(path, body, session=None, raw=False):
    headers = {"Token": TOKEN, "Content-Type": "application/json"}
    if session:
        headers["X-Session-Id"] = session
    req = urllib.request.Request(BASE + path, json.dumps(body).encode(), headers)
    with urllib.request.urlopen(req, timeout=90) as res:
        data = res.read()
    return data if raw else json.loads(data)

session = call("/api/start", {"proxy": "auto"})["session_id"]
try:
    call("/api/go", {"url": "https://example.com"}, session)
    with open("page.webp", "wb") as f:  # the page alone; {} captures the whole window
        f.write(call("/api/screenshot", {"area": "viewport"}, session, raw=True))
finally:
    call("/api/destroy", {}, session)

import { writeFile } from "node:fs/promises";

const BASE = "https://api1.crawlnode.com";
const TOKEN = process.env.CRAWLNODE_TOKEN;

async function call(path, body, session) {
  const headers = { Token: TOKEN, "Content-Type": "application/json" };
  if (session) headers["X-Session-Id"] = session;
  const res = await fetch(BASE + path, { method: "POST", headers, body: JSON.stringify(body) });
  if (!res.ok) throw new Error(`${path} -> HTTP ${res.status}`);
  return res;
}

const { session_id } = await (await call("/api/start", { proxy: "auto" })).json();
try {
  await call("/api/go", { url: "https://example.com" }, session_id);
  const shot = await call("/api/screenshot", { area: "viewport" }, session_id); // {} = whole window
  await writeFile("page.webp", Buffer.from(await shot.arrayBuffer()));
} finally {
  await call("/api/destroy", {}, session_id);
}