Headful, real builds
Real Chrome, Edge, Brave and Firefox-based browsers with a display, without the headless tells sites check for (case 16). Headful takes 2 threads, headless 1.
The browsers →cdpfleet / AI agents
For AI agents
Let Claude, ChatGPT, Gemini, Cursor or your own agent browse with a real browser on our fleet: the browser and exit country the site should see, a person who can step in for a captcha or a login, and a video of what the agent did.
Add https://cdpfleet.com/mcp as an MCP server or connector in Claude, ChatGPT, Gemini, Claude Code, Codex or Cursor. When the assistant opens a cdpfleet window, sign in and click Allow (OAuth) — nothing to install or copy, and you can disconnect it any time in the dashboard. Scripts and agents without OAuth send an API key as Authorization: Bearer. Step by step for each app: MCP setup.
The assistant then has tools to launch a browser (any of the fleet's browsers, headful by default, with a residential exit by country or your own proxy), navigate, read the page as an accessibility snapshot, click and type, take screenshots, and hand the browser to a person. Each MCP connection gets its own browser; one left idle for 30 minutes is closed.
claude mcp add --transport http cdpfleet https://cdpfleet.com/mcpAn AI coding agent writing a scraper or a test doesn't need MCP — it needs the rules. /skill.md is one page for it: how to launch, connect and close, the browser list from the live fleet, proxies, limits, errors and the gotchas. Point the agent at it, or at /llms.txt for the full index of docs, cases and comparisons.
Read https://cdpfleet.com/skill.md, then write a Playwright script that opens news.ycombinator.com
through a cdpfleet browser and prints the top 5 story titles. My API key is in CDPFLEET_API_KEY.Real Chrome, Edge, Brave and Firefox-based browsers with a display, without the headless tells sites check for (case 16). Headful takes 2 threads, headless 1.
The browsers →A captcha, a login or a one-time code: the agent hands the browser to a person in live view and waits, then carries on in the same page.
Live view →Headful sessions are recorded: replay what the agent saw and did, step by step — the first 15 minutes of each session free on paid plans.
Recordings →A persistent profile keeps cookies, localStorage and IndexedDB between sessions: log in once by hand, and the agent starts signed in next time.
Profiles →"profile": "agent-login" and work in browser.contexts()[0] — that context is saved when the session ends (case 40). On Camoufox the profile also keeps the device fingerprint (case 49).start_url session can be driven by a person in live view while your code joins later and finds the same page (case 58).keep_alive keeps the browser running when the agent disconnects; reconnect to the same wsUrl within inactivity_timeout (up to 24 h) and its pages are where they were.// npm install [email protected]
// Browsers run on cdpfleet, so no `npx playwright install` is needed.
import { chromium } from 'playwright';
const KEY = process.env.CDPFLEET_API_KEY;
// 1. Launch the browser
const res = await fetch('https://starter.cdpfleet.com/chrome/session', {
method: 'POST',
headers: { 'x-api-key': KEY, 'content-type': 'application/json' },
body: JSON.stringify({
proxy: 'http://user:[email protected]:8080',
headless: false,
profile: 'agent-login',
}),
});
if (!res.ok) throw new Error(`launch failed: ${res.status} ${await res.text()}`);
const { wsUrl } = await res.json();
// 2. Connect and drive it
const browser = await chromium.connect(wsUrl, { headers: { 'x-api-key': KEY } });
const context = browser.contexts()[0]; // the saved profile — a new context isn't saved
const page = context.pages()[0] ?? await context.newPage();
await page.goto('https://example.com');
console.log(await page.title());
await browser.close(); // ends the session and stops billing
# pip install playwright==1.60.0 requests
# Browsers run on cdpfleet, so no `playwright install` is needed.
import os
import requests
from playwright.sync_api import sync_playwright
KEY = os.environ["CDPFLEET_API_KEY"]
# 1. Launch the browser
res = requests.post(
"https://starter.cdpfleet.com/chrome/session",
headers={"x-api-key": KEY},
json={
"proxy": "http://user:[email protected]:8080",
"headless": False,
"profile": "agent-login",
},
timeout=60,
)
res.raise_for_status()
ws_url = res.json()["wsUrl"]
# 2. Connect and drive it
with sync_playwright() as p:
browser = p.chromium.connect(ws_url, headers={"x-api-key": KEY})
context = browser.contexts[0] # the saved profile — a new context isn't saved
page = context.pages[0] if context.pages else context.new_page()
page.goto("https://example.com")
print(page.title())
browser.close() # ends the session and stops billing
// Maven: com.microsoft.playwright:playwright:1.60.0 and com.google.code.gson:gson:2.11.0
// Run with PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1: browsers run on cdpfleet.
import com.google.gson.JsonParser;
import com.microsoft.playwright.*;
import java.net.URI;
import java.net.http.*;
import java.util.Map;
public class Example {
public static void main(String[] args) throws Exception {
String key = System.getenv("CDPFLEET_API_KEY");
// 1. Launch the browser
String body = """
{
"proxy": "http://user:[email protected]:8080",
"headless": false,
"profile": "agent-login"
}
""";
HttpResponse<String> res = HttpClient.newHttpClient().send(
HttpRequest.newBuilder(URI.create("https://starter.cdpfleet.com/chrome/session"))
.header("x-api-key", key)
.header("content-type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build(),
HttpResponse.BodyHandlers.ofString());
if (res.statusCode() != 200) {
throw new RuntimeException("launch failed: " + res.statusCode() + " " + res.body());
}
String wsUrl = JsonParser.parseString(res.body()).getAsJsonObject().get("wsUrl").getAsString();
// 2. Connect and drive it
try (Playwright playwright = Playwright.create()) {
Browser browser = playwright.chromium().connect(wsUrl,
new BrowserType.ConnectOptions().setHeaders(Map.of("x-api-key", key)));
BrowserContext context = browser.contexts().get(0); // the saved profile — a new context isn't saved
Page page = context.pages().isEmpty() ? context.newPage() : context.pages().get(0);
page.navigate("https://example.com");
System.out.println(page.title());
browser.close(); // ends the session and stops billing
}
}
}
// dotnet add package Microsoft.Playwright --version 1.60.0
// Browsers run on cdpfleet, so no `playwright install` is needed.
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;
using Microsoft.Playwright;
var key = Environment.GetEnvironmentVariable("CDPFLEET_API_KEY")!;
// 1. Launch the browser
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", key);
var body = """
{
"proxy": "http://user:[email protected]:8080",
"headless": false,
"profile": "agent-login"
}
""";
var res = await http.PostAsync("https://starter.cdpfleet.com/chrome/session",
new StringContent(body, Encoding.UTF8, "application/json"));
if (!res.IsSuccessStatusCode)
throw new Exception($"launch failed: {(int)res.StatusCode} {await res.Content.ReadAsStringAsync()}");
var wsUrl = (await res.Content.ReadFromJsonAsync<JsonElement>()).GetProperty("wsUrl").GetString()!;
// 2. Connect and drive it
using var playwright = await Playwright.CreateAsync();
var browser = await playwright.Chromium.ConnectAsync(wsUrl, new BrowserTypeConnectOptions
{
Headers = new Dictionary<string, string> { ["x-api-key"] = key },
});
var context = browser.Contexts[0]; // the saved profile — a new context isn't saved
var page = context.Pages.Count > 0 ? context.Pages[0] : await context.NewPageAsync();
await page.GotoAsync("https://example.com");
Console.WriteLine(await page.TitleAsync());
await browser.CloseAsync(); // ends the session and stops billing
// go get github.com/playwright-community/[email protected]
//
// One-time driver setup (needs Node.js 18+): playwright-go can no longer download the
// 1.60.0 driver itself, so build it from npm and point PLAYWRIGHT_DRIVER_PATH at it:
// mkdir -p ~/.cache/pw-driver-1.60.0 && cd ~/.cache/pw-driver-1.60.0 &&
// curl -sL https://registry.npmjs.org/playwright-core/-/playwright-core-1.60.0.tgz | tar xz &&
// ln -sf "$(command -v node)" node
// export PLAYWRIGHT_DRIVER_PATH=~/.cache/pw-driver-1.60.0
// Browsers run on cdpfleet, so no browsers are downloaded (SkipInstallBrowsers).
package main
import (
"encoding/json"
"fmt"
"io"
"log"
"net/http"
"os"
"strings"
"github.com/playwright-community/playwright-go"
)
func main() {
key := os.Getenv("CDPFLEET_API_KEY")
// 1. Launch the browser
body := `{
"proxy": "http://user:[email protected]:8080",
"headless": false,
"profile": "agent-login"
}`
req, _ := http.NewRequest("POST", "https://starter.cdpfleet.com/chrome/session", strings.NewReader(body))
req.Header.Set("x-api-key", key)
req.Header.Set("content-type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
if res.StatusCode != http.StatusOK {
msg, _ := io.ReadAll(res.Body)
log.Fatalf("launch failed: %s %s", res.Status, msg)
}
var session struct {
WsURL string `json:"wsUrl"`
}
if err := json.NewDecoder(res.Body).Decode(&session); err != nil {
log.Fatal(err)
}
// 2. Connect and drive it (Install fetches only the Playwright driver, once)
opts := &playwright.RunOptions{SkipInstallBrowsers: true}
if err := playwright.Install(opts); err != nil {
log.Fatal(err)
}
pw, err := playwright.Run(opts)
if err != nil {
log.Fatal(err)
}
defer pw.Stop()
browser, err := pw.Chromium.Connect(session.WsURL, playwright.BrowserTypeConnectOptions{
Headers: map[string]string{"x-api-key": key},
})
if err != nil {
log.Fatal(err)
}
context := browser.Contexts()[0] // the saved profile — a new context isn't saved
var page playwright.Page
if pages := context.Pages(); len(pages) > 0 {
page = pages[0]
} else if page, err = context.NewPage(); err != nil {
log.Fatal(err)
}
if _, err := page.Goto("https://example.com"); err != nil {
log.Fatal(err)
}
title, _ := page.Title()
fmt.Println(title)
browser.Close() // ends the session and stops billing
}
keep_alive, and request data may be used to improve the service — don't sign in to real accounts on it.