Launch prices end 31 Dec. Subscribe before then and keep yours · Lock my price

Local API and Playwright for an antidetect browser

Start a profile over Clout Browser’s Local API, read its CDP endpoint, and connect Playwright to the real fingerprinted browser instead of a new one.

To drive an antidetect profile with Playwright, start the profile over Clout Browser’s Local API and connect Playwright to the CDP address in the reply. The script then controls the same browser, with the same identity, that you would open by hand, instead of launching a new one with a new fingerprint.

Turn it on

Open MCP & Local API, set Enable Local API and save. The default port is 50326 and the app shows the actual address. Token authentication is on by default: send it as X-API-Key or Authorization: Bearer, and prefer a header so the token stays out of URLs. The API serves this computer’s profiles only.

List, then start

Take profile IDs from a list response; do not guess one from a Creator’s name. POST /api/v2/browser-profile/list takes profile_id, profile_no, group_id and paging. POST /api/v2/browser-profile/start launches the profile, or returns the endpoint of one that is already open.

Connect Playwright

A successful v2 start returns the CDP WebSocket at data.ws.puppeteer. Connect to it rather than starting a second browser, which would have a new identity:

import { chromium } from 'playwright';

const response = await fetch(`${baseUrl}/api/v2/browser-profile/start`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({ profile_id: profileId }),
});
const reply = await response.json();
if (reply.code !== 0) throw new Error(reply.msg);
const browser = await chromium.connectOverCDP(reply.data.ws.puppeteer);

baseUrl, token and profileId are values your integration supplies. Stop the profile through the API when you finish, so the normal session capture and cleanup run.

Read the envelope

Most replies carry code, msg and data. A failed operation normally returns HTTP 200 with code: -1, so check code, not the status line. A bad token returns 401.

v1 for old scripts, v2 for new ones

The v1 routes match AdsPower’s Local API: start, stop and list browsers, and manage users and groups. A script written for AdsPower carries on once it points at Clout’s address and key (the AdsPower move). For a new integration, v2 is the clearer contract. The cloutctl command line does the same jobs from a terminal.

An example

A nightly script checks that twenty profiles are still signed in. It lists the profiles in one group, starts each with v2, connects Playwright over CDP, opens the site, reads whether the account menu is there, and stops the profile through the API so its session is captured. Any profile whose start returns code: -1 is logged with its msg instead of being retried in a loop.

What to do next

Enable the Local API and run the snippet above against one test profile. The complete route tables are in the Local API reference; to let an AI agent do this for you, see the MCP server.

Set it up in Clout Browser
  1. Invite your team

    By email or Telegram username, from Team. Seats are in every plan.

  2. Pick a rank

    Owner, Admin, Manager or Employee, with reusable permission groups.

  3. Share folders

    Each teammate opens the folders they work on and nothing else.

  4. Automate the rest

    The Local API, cloutctl and the MCP server open the same profiles for scripts and AI agents.

FAQ

Questions, answered.

Something else? Ask us on Telegram. We answer fast and we don’t bite.

How do I connect Playwright to a Clout Browser profile?
Call POST /api/v2/browser-profile/start with the profile_id, then pass data.ws.puppeteer from the reply to chromium.connectOverCDP.
What port does the Local API use?
The default is 50326; the setting accepts 1024 to 65535 and the app shows the actual address.
Do my AdsPower scripts work with Clout Browser?
The v1 routes match AdsPower’s Local API for browsers, users and groups. Point the scripts at Clout’s address and key.

Run every account in its own browser.

Download free, import your profiles in minutes and pay $9 a month for 100 of them. Every plan is free for 3 days.

  • 100 profiles for $9 a month
  • Imports AdsPower, Multilogin, Dolphin, GoLogin, Kameleo
  • Mac, Windows and Linux
Get my fleet planDownload freeOne profile free forever. No credit card for the download.
Keep reading

Related guides.

Your accounts deserve a better browser.

One profile free for as long as you like. Every plan free for 3 days. Cancel any time.