full-stack-skills/skills/agent-browser/examples/advanced/custom-executable.md

Custom Browser Executable | 自定义浏览器可执行文件

官方文档: https://github.com/vercel-labs/agent-browser/blob/main/README.md

Instructions

This example demonstrates how to use a custom browser executable instead of the bundled Chromium.

Key Concepts

• Custom browser executable path
• Serverless deployment (lightweight builds)
• System browsers
• Custom builds
• Environment variable vs CLI flag

Example: Via CLI Flag

# Use custom browser executable
agent-browser --executable-path /path/to/chromium open example.com
agent-browser --executable-path /path/to/chromium snapshot

Example: Via Environment Variable

# Set custom executable path
export AGENT_BROWSER_EXECUTABLE_PATH=/path/to/chromium

# All commands use the custom executable
agent-browser open example.com
agent-browser snapshot

Example: Serverless Deployment (Vercel/AWS Lambda)

import chromium from '@sparticuz/chromium';
import { BrowserManager } from 'agent-browser';

export async function handler() {
  const browser = new BrowserManager();
  await browser.launch({
    executablePath: await chromium.executablePath(),
    headless: true,
  });
  // ... use browser
}

Example: Using System Chrome

# macOS
agent-browser --executable-path "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" open example.com

# Linux
agent-browser --executable-path /usr/bin/google-chrome open example.com

# Windows
agent-browser --executable-path "C:\Program Files\Google\Chrome\Application\chrome.exe" open example.com

Example: Lightweight Builds

# Use lightweight Chromium build for serverless
export AGENT_BROWSER_EXECUTABLE_PATH=/path/to/lightweight-chromium
agent-browser open example.com

Key Points

• Use --executable-path flag or AGENT_BROWSER_EXECUTABLE_PATH environment variable
• Useful for serverless deployments (lightweight builds like @sparticuz/chromium)
• Can use system browsers or custom builds
• Default bundled Chromium is ~684MB, lightweight builds are ~50MB
• Useful for environments with size constraints