Communitygithub.com

agent-browser

AI 代理的瀏覽器自動化 CLI。當使用者需要與網站互動時使用,包括瀏覽頁面、填寫表單、點擊按鈕、截圖、擷取資料、測試網頁應用程式或自動化任何瀏覽器任務。

agent-browser 是什麼?

agent-browser 是一款高效能、以 Rust 原生打造的瀏覽器自動化 CLI,專為 AI 代理(如 Cursor、Claude Code、Codex、Continue、Windsurf 等)設計。它透過 Chrome DevTools Protocol (CDP) 控制 Chrome/Chromium,無需依賴 Playwright 或 Puppeteer,並提供可存取的輔助技術樹快照與精簡的 `@eN` 元素參考,實現可靠且穩定的網頁互動。此工具涵蓋完整的自動化工作流程,包括導航、表單填寫、截圖、資料擷取、狀態持久化、影片錄製,並支援電子郵件驗證(如 Gmail 與 Outlook)及工作階段 Cookie 匯入。此外,agent-browser 提供專用的「專業技能」模組,適用於 Electron 桌面應用程式(VS Code、Slack、Discord、Figma)、Slack 工作區自動化、探索性測試、HAR 記錄以產出獨立 API 客戶端,以及 Vercel Sandbox 微 VM 中的雲端瀏覽器,大幅擴展了 AI 代理的瀏覽器任務邊界。它還內建可觀測性儀表板(連接埠 4848),可獨立執行,讓代理能監控工作階段的狀態與流量,無須直接暴露工作階段的連接埠。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Windsurf
npx skills add https://github.com/vercel-labs/agent-browser/tree/main/skills/agent-browser

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

agent-browser 是做什麼的?

適用於 AI 代理的快速瀏覽器自動化 CLI。透過 CDP 控制 Chrome/Chromium,提供輔助技術樹快照與精簡的 @eN 元素參考。

安裝:npm i -g agent-browser && agent-browser install

入門指引

本檔案為發現用存根,非完整使用指南。在執行任何 agent-browser 指令之前,請先從 CLI 載入實際的工作流程內容:

agent-browser skills get core             # 從這裡開始 — 工作流程、常用模式、疑難排解
agent-browser skills get core --full      # 包含完整的指令參考與範本

CLI 提供的技能內容永遠與已安裝的版本相符,因此說明絕不會過時。本存根中的內容在不同版本之間不會變更,這就是為什麼它僅指向 skills get core。

專業技能

當任務超出瀏覽器網頁範圍時,請載入專業技能:

agent-browser skills get electron          # Electron 桌面應用程式(VS Code、Slack、Discord、Figma 等)
agent-browser skills get slack             # Slack 工作區自動化
agent-browser skills get dogfood           # 探索性測試 / 品質保證 / 錯誤狩獵
agent-browser skills get derive-client     # 錄製 HAR,為網站衍生出獨立的 API 客戶端
agent-browser skills get vercel-sandbox    # 在 Vercel Sandbox 微 VM 中的 agent-browser
agent-browser skills get protected-vercel-deployments  # 存取受保護的 Vercel 部署
agent-browser skills get agentcore         # AWS Bedrock AgentCore 雲端瀏覽器

執行 agent-browser skills list 以查看已安裝版本中所有可用的技能。

為何選擇 agent-browser

  • 快速的原生 Rust CLI,非 Node.js 包裝器
  • 可與任何 AI 代理搭配使用(Cursor、Claude Code、Codex、Continue、Windsurf 等)
  • 無需 Playwright 或 Puppeteer 依賴即可透過 CDP 控制 Chrome/Chromium
  • 使用帶有元素參考的輔助技術樹快照,實現可靠的互動
  • 支援工作階段、驗證保險庫、狀態持久化、影片錄製
  • 針對 Electron 應用程式、Slack、探索性測試、雲端供應商提供專業技能

可觀測性儀表板

儀表板獨立於瀏覽器工作階段執行於連接埠 4848,並可透過代理或轉發的 URL(例如 https://dashboard.agent-browser.localhost)開啟。代理應停留在儀表板來源:工作階段標籤、狀態與串流流量會在內部代理,因此不需要暴露工作階段的連接埠。

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

vercel-labs/agentcore

Run agent-browser on AWS Bedrock AgentCore cloud browsers. Use when the user wants to use AgentCore, run browser automation on AWS, use a cloud browser with AWS credentials, or needs a managed browser session backed by AWS infrastructure. Triggers include "use agentcore", "run on AWS", "cloud browser with AWS", "bedrock browser", "agentcore session", or any task requiring AWS-hosted browser automation.

vercel-labs/derive-client

Reverse-engineer a website's internal API by recording browser traffic into a HAR file, then generate a standalone client or CLI that calls the endpoints directly, with no browser needed after the first recording. Use when asked to "derive a client", "build a CLI for <site>", "reverse engineer this site's API", "record network requests", "turn this site into an API", or when the same site will be automated repeatedly and direct HTTP calls would beat driving the browser every time.

vercel-labs/dogfood

Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.

vercel-labs/electron

Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.

vercel-labs/protected-vercel-deployments

Access and test Vercel deployments protected by Vercel Authentication, SSO, or Deployment Protection with agent-browser. Use when a preview or production URL redirects to a Vercel login page, returns a protection 401 or 403, or needs short-lived Trusted Sources OIDC authentication instead of a static bypass secret or public exception.

vercel-labs/slack

Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include "check my Slack", "what channels have unreads", "send a message to", "search Slack for", "extract from Slack", "find who said", or any task requiring programmatic Slack interaction.

vercel-labs/vercel-sandbox

Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include "Vercel Sandbox browser", "microVM Chrome", "agent-browser in sandbox", "browser automation on Vercel", or any task requiring Chrome in a Vercel Sandbox.

vercel-labs/webmcp-gen

Build and validate experimental WebMCP tools for an existing web page. Use when an agent needs to expose a site's real workflows as page tools, create webmcp.init.js, define deterministic checks, or compare WebMCP with accessibility-tree automation.

相關技能