agentgo-dev/agentgo-browser

Browser Automation with AgentGo Cloud Browsers

AgentGo provides a distributed cloud browser cluster. Connect via WebSocket using chromium.connect() from [email protected].

Note: Must use [email protected] exactly — newer versions have protocol incompatibilities with AgentGo's server.

Get an API key

Register at https://app.agentgo.live/ — free credits included, no credit card required.

export AGENTGO_API_KEY=your_api_key_here

Install

npm install [email protected]
# or
pnpm add [email protected]

Quick start

import { chromium } from "playwright"; // must be [email protected]

const options = { _apikey: process.env.AGENTGO_API_KEY };
const serverUrl = `wss://app.browsers.live?launch-options=${encodeURIComponent(JSON.stringify(options))}`;

const browser = await chromium.connect(serverUrl);
const page = await browser.newPage();

await page.goto("https://example.com");
const title = await page.title();
console.log(title);

await browser.close();

Connection helper

import { chromium } from "playwright";

export async function connectAgentGo() {
  if (!process.env.AGENTGO_API_KEY)
    throw new Error("AGENTGO_API_KEY is not set");
  const opts = encodeURIComponent(JSON.stringify({ _apikey: process.env.AGENTGO_API_KEY }));
  return chromium.connect(`wss://app.browsers.live?launch-options=${opts}`);
}

Basic interactions

const browser = await connectAgentGo();
const page = await browser.newPage();

await page.goto("https://example.com");
await page.click("button#submit");
await page.fill("input[name=email]", "[email protected]");
await page.press("input[name=email]", "Enter");
await page.screenshot({ path: "screenshot.png" });

await browser.close();

Extract data

const browser = await connectAgentGo();
const page = await browser.newPage();
await page.goto("https://news.ycombinator.com");

const items = await page.$$eval(".titleline a", els =>
  els.map(a => ({ title: a.textContent, href: (a as HTMLAnchorElement).href }))
);

await browser.close();
return items;

Multiple pages (parallel)

const browser = await connectAgentGo();
const [page1, page2] = await Promise.all([browser.newPage(), browser.newPage()]);

await Promise.all([
  page1.goto("https://site-a.com"),
  page2.goto("https://site-b.com"),
]);

await browser.close();

Always close in finally

const browser = await connectAgentGo();
try {
  const page = await browser.newPage();
  await doWork(page);
} finally {
  await browser.close();
}

Specific Tasks

• Connection & auth references/connection.md
• Session management references/session-management.md
• Running Playwright code references/running-code.md

Tips & Anti-Detection

• General anti-bot bypass references/tips-general.md — mobile emulation, human-like typing, cookie auth, natural navigation
• X (Twitter) references/tips-x-twitter.md — iPhone context, cookie auth, reply workflow, key selectors