Getting Started

// 1. Navigate to the target page
await callTool("browser-navigate", {
  action: "goto",
  url: "https://example.com/products",
  sessionId,
});

// 2. Take a filtered snapshot (main content only)
const snapshot = await callTool("browser-snapshot", {
  sessionId,
  selector: "main",
  excludeDecorative: true,
});

// 3. Extract article content (clean markdown via Readability)
const article = await callTool("browser-extract", {
  sessionId,
  property: "article",
});

// 4. Or extract specific element text
const heading = await callTool("browser-extract", {
  sessionId,
  property: "text",
  selector: "h1",
});

// 1. Snapshot to find the form
const snapshot = await callTool("browser-snapshot", { sessionId });

// 2. Fill in the form fields using @e refs from the snapshot
await callTool("browser-action", {
  action: "fill",
  selector: "@e12",          // email input
  value: "user@example.com",
  sessionId,
});
await callTool("browser-action", {
  action: "fill",
  selector: "@e14",          // password input
  value: "secure-password",
  sessionId,
});

// 3. Click the submit button
await callTool("browser-action", {
  action: "click",
  selector: "@e18",          // submit button
  sessionId,
});

// 4. Wait for navigation and verify
const result = await callTool("browser-snapshot", { sessionId });

// Use browser-batch to execute multiple operations in one round-trip
const results = await callTool("browser-batch", {
  sessionId,
  actions: [
    { tool: "browser-navigate", params: { action: "goto", url: "https://site-a.com" } },
    { tool: "browser-snapshot", params: { selector: "main", excludeDecorative: true } },
    { tool: "browser-extract", params: { property: "article" } },
  ],
});

// results[0] → navigation confirmation
// results[1] → filtered snapshot
// results[2] → extracted content

// Block images and stylesheets to speed up page loads
await callTool("browser-route", {
  sessionId,
  pattern: "**/*.{png,jpg,gif,svg,css,woff,woff2}",
  action: "abort",
});

// Navigate and extract — pages load faster without media
await callTool("browser-navigate", {
  action: "goto",
  url: "https://example.com/articles",
  sessionId,
});

// Crawl with resource blocking built in
const results = await callTool("browser-crawl", {
  sessionId,
  urls: ["https://example.com/articles"],
  enqueueStrategy: "same-hostname",
  maxRequestsPerCrawl: 50,
  blockedResources: ["image", "stylesheet", "font", "media"],
  expression: "document.querySelector('article')?.innerText",
});

// 1. Set mobile viewport size
await callTool("browser-resize", {
  sessionId,
  width: 390,
  height: 844,
});

// 2. Set mobile user agent and locale
await callTool("browser-emulate", {
  sessionId,
  userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15",
  locale: "en-US",
  colorScheme: "light",
});

// 3. Simulate slow network conditions
await callTool("browser-throttle", {
  sessionId,
  downloadThroughput: 50000,    // 50 KB/s (slow 3G)
  uploadThroughput: 25000,      // 25 KB/s
  latency: 2000,                // 2s RTT
});

// 4. Navigate and screenshot for visual comparison
await callTool("browser-navigate", { action: "goto", url: "https://example.com", sessionId });
const screenshot = await callTool("browser-screenshot", {
  sessionId,
  target: "page",
});

// 5. Check performance metrics
const metrics = await callTool("browser-metrics", { sessionId });
// → { domContentLoaded, domInteractive, firstContentfulPaint, firstPaint, loadComplete }

// 1. Set up clipboard read access
await callTool("browser-evaluate", {
  sessionId,
  expression: "await navigator.clipboard.readText()",
});

// 2. Click a download button and check downloads
await callTool("browser-action", {
  action: "click",
  selector: "@e25",              // "Download PDF" button
  sessionId,
});
const downloads = await callTool("browser-download", {
  sessionId,
  action: "list",          // list all downloads
});

// 3. Upload a file to a file input
await callTool("browser-upload", {
  sessionId,
  selector: "input[type=file]",
  files: ["/path/to/document.pdf"],
});