AgentSkillsCN

Agent Browser

一款基于Rust的快速无头浏览器自动化CLI工具，内置Node.js回退机制，支持AI智能体通过结构化命令实现页面导航、点击操作、文本输入与屏幕截图。

SKILL.md
--- frontmatter
name: Agent Browser
description: A fast Rust-based headless browser automation CLI with Node.js fallback that enables AI agents to navigate, click, type, and snapshot pages via structured commands.
read_when:
  - Automating web interactions
  - Extracting structured data from pages
  - Filling forms programmatically
  - Testing web UIs
metadata: {"clawdbot":{"emoji":"🌐","requires":{"bins":["node","npm"]}}}

Agent Browser

A fast Rust-based headless browser automation CLI with Node.js fallback that enables AI agents to navigate, click, type, and snapshot pages via structured commands.

Installation

npm recommended

bash
npm install -g agent-browser
agent-browser install
agent-browser install --with-deps

From Source

bash
git clone https://github.com/vercel-labs/agent-browser
cd agent-browser
pnpm install
pnpm build
agent-browser install

Quick Start

bash
agent-browser open example.com
agent-browser snapshot
agent-browser click @e2
agent-browser fill @e3 "test@example.com"
agent-browser get text @e1
agent-browser screenshot page.png
agent-browser close

Core Commands

Navigation

bash
agent-browser open <url>
agent-browser back
agent-browser forward
agent-browser reload

Interaction

bash
agent-browser click <sel>
agent-browser dblclick <sel>
agent-browser focus <sel>
agent-browser type <sel> <text>
agent-browser fill <sel> <text>
agent-browser clear <sel>
agent-browser press <key>
agent-browser keydown <key>
agent-browser keyup <key>
agent-browser hover <sel>
agent-browser select <sel> <val>
agent-browser check <sel>
agent-browser uncheck <sel>
agent-browser drag <src> <tgt>
agent-browser upload <sel> <files>

Extraction and Info

bash
agent-browser snapshot
agent-browser get text <sel>
agent-browser get html <sel>
agent-browser get value <sel>
agent-browser get attr <sel> <attr>
agent-browser get title
agent-browser get url
agent-browser get count <sel>
agent-browser get box <sel>
agent-browser screenshot [path]
agent-browser pdf <path>

Check State

bash
agent-browser is visible <sel>
agent-browser is enabled <sel>
agent-browser is checked <sel>

Find Elements

  • •agent-browser find role <role> <action> [value]
  • •agent-browser find text <text> <action>
  • •agent-browser find label <label> <action> [value]
  • •agent-browser find placeholder <ph> <action> [value]
  • •agent-browser find alt <text> <action>
  • •agent-browser find title <text> <action>
  • •agent-browser find testid <id> <action> [value]

Actions include click, fill, check, hover, and text.

Wait and Timing

bash
agent-browser wait <selector>
agent-browser wait <ms>
agent-browser wait --text "Welcome"
agent-browser wait --url "**/dash"
agent-browser wait --load networkidle

Advanced Control

bash
agent-browser scroll <dir> [px]
agent-browser scrollintoview <sel>
agent-browser eval <js>
agent-browser mouse move <x> <y>
agent-browser cookies
agent-browser storage local
agent-browser tab new [url]
agent-browser frame <sel>
agent-browser dialog accept [text]

Sessions

Run multiple isolated browser instances.

bash
agent-browser --session agent1 open site-a.com
agent-browser --session agent2 open site-b.com

Snapshot Options

The snapshot command supports filtering to reduce output size.

  • •agent-browser snapshot -i
  • •agent-browser snapshot -c
  • •agent-browser snapshot -d 3
  • •agent-browser snapshot -s "#main"

Selectors and Refs

Refs provide deterministic element selection from snapshots. Use the @ref syntax.

bash
agent-browser snapshot
agent-browser click @e2

Agent Mode

Use --json for machine readable output.

bash
agent-browser snapshot --json

Optimal AI Workflow

  • •Navigate with agent-browser open <url>
  • •Observe with agent-browser snapshot -i --json
  • •Act with @ref from the snapshot
  • •Verify with agent-browser snapshot

Troubleshooting

  • •If the command is not found on Linux ARM64, use the full path in the bin folder.
  • •If an element is not found, use snapshot to find the correct ref.
  • •If the page is not loaded, add a wait command after navigation.
  • •Use --headed to see the browser window for debugging.

Options

  • •--session <name> uses an isolated session.
  • •--json provides JSON output.
  • •--full takes a full page screenshot.
  • •--headed shows the browser window.
  • •--timeout sets the command timeout in milliseconds.

Notes

  • •Refs are stable per page load but change on navigation.
  • •Always snapshot after navigation to get new refs.
  • •Use fill instead of type for input fields to ensure existing text is cleared.