agent-browser-control
Drive a headed Chromium via the agent-browser CLI — open/click/type/hover/scroll/screenshot/snapshot/eval/pdf/network-route. Use this for any web interaction; no native browser tool is exposed.
- License 许可
- MIT
- 最近更新
- 2026-07-28
- Stars
- ★ 40
- Forks
- 1
01 前言 Front Matter
- name
- agent-browser-control
- always
- true
- description
- Drive a headed Chromium via the agent-browser CLI — open/click/type/hover/scroll/screenshot/snapshot/eval/pdf/network-route. Use this for any web interaction; no native browser tool is exposed.
03 SKILL.md 正文
Agent Browser Control
Use the agent-browser CLI for any web interaction. No other browser tool is exposed in this environment.
Binary
agent-browser(global, onPATH)- Chromium is pre-installed at
/usr/local/bin/chromium - A persistent browser daemon is started automatically on the first command and reused across calls
Typical workflow
- Open a page:
agent-browser open https://example.com
- Inspect the page:
agent-browser snapshot
agent-browser get url
agent-browser get title
- Interact with elements:
agent-browser click "@e2"
agent-browser fill "@e3" "text value"
agent-browser press Enter
agent-browser wait --load networkidle
For form submission flows, do not assume a public demo form is static just because the first click appears unchanged. After clicking the submit button:
agent-browser wait --load networkidle
agent-browser get url
agent-browser snapshot
If needed, try the submit control again or press Enter, then re-check the URL and page content before concluding that submission failed.
Before clicking a final action such as a submit button, refresh the page snapshot and use the current ref from that latest snapshot. Do not rely on a stale remembered ref.
- Save evidence (screenshots go to the path you pass):
mkdir -p /tmp_workspace/results/screenshots
agent-browser screenshot /tmp_workspace/results/screenshots/page.png
screenshot defaults to viewport-only PNG at the exact path you provide. Pass --full for full-page; pass --screenshot-format jpeg for JPEG.
- Close the browser when done:
agent-browser close
Notes
snapshotreturns refs like@e2; use those refs forclick,fill, andget text.- For multi-step flows,
agent-browser batch --jsoncan run a JSON array of commands in one invocation (daemon persists between commands anyway, so chaining with&&is usually enough). - Always wait for navigation or content changes before taking the next screenshot.
- Save any required output files under
/tmp_workspace/results; thescreenshot <path>argument is respected literally, so point it directly at the file you want saved. - In benchmark tasks, write required JSON/log files incrementally as milestones are reached instead of waiting until the very end.
04 同仓库更多 Skills
cli-anything-zoom
Command-line interface for Zoom — manage meetings, participants, and recordings from the command line via the Zoom REST API.
netease-music-cli
CLI for NetEase Cloud Music — search songs/albums/playlists, get lyrics, and manage your music library from the terminal.
google-calendar-gcalcli
Install and use gcalcli for live Google Calendar read access using the provided OAuth cache.
Excel / XLSX
Create, inspect, and edit Microsoft Excel workbooks and XLSX files with reliable formulas, dates, types, formatting, recalculation, and template preservation. Use when (1) the task is about Excel, `.xlsx`, `.xlsm`, `.xls`, `.csv`, or `.tsv`; (2) formulas, formatting, workbook structure, or compatibility matter; (3) the file must stay reliable after edits.
duckdb-en
DuckDB CLI specialist for SQL analysis, data processing and file conversion. Use for SQL queries, CSV/Parquet/JSON analysis, database queries, or data conversion. Triggers on "duckdb", "sql", "query", "data analysis", "parquet", "convert data".
automate-excel
Automates reading, writing, merging, transforming, and validating Excel (.xlsx/.xls) files. Use when the user works with spreadsheets, .xlsx files, Excel data — for cleaning, joining, validating, deduplicating, aggregating, filtering, or auditing tabular data.