要点
Drive a real Chrome window to inspect pages, fill forms, click through flows, and extract data.
- Selector-first target contract: interact via numeric refs (resilient to DOM drift) or CSS selectors, with structured
match_levelfeedback (exact,stable,reidentified) on every action - Session lifecycle management: use stable session names for multi-step flows, bind existing tabs for logged-in pages, and leverage idle timeouts or explicit
closefor cleanup - Compound form metadata: date/time/select/file controls expose format strings, option lists (capped at 50), and current values—use these instead of regex-guessing or blind clicks
- Network capture and extraction: inspect API responses by shape, fetch full bodies on demand, or use
extractwith continuation cursors for long-form content - Structured error codes and candidates: branch on
code(not message strings), and usecandidatesoravailablearrays to recover from ambiguous selectors or missing options
SKILL.md
Browser tools for agents
Use the capability that fits the task. Discover commands with opencli list <query>;
read exact arguments with opencli browser <command> --help -f json.
Run opencli doctor when diagnosing a connection problem.
Scope and results
Page commands require --session <name>. Reuse that name across a task; different
sessions isolate page work. --profile <name> selects a Chrome profile when needed.
Options can follow command arguments:
opencli browser open https://example.com --session research
opencli browser state --session research
opencli browser click --role button --name Search --session research
opencli browser close --session research
Browser tools for agents
Use the capability that fits the task. Discover commands with opencli list <query>;
read exact arguments with opencli browser <command> --help -f json.
Run opencli doctor when diagnosing a connection problem.
Scope and results
Page commands require --session <name>. Reuse that name across a task; different
sessions isolate page work. --profile <name> selects a Chrome profile when needed.
Options can follow command arguments:
opencli browser open https://example.com --session research
opencli browser state --session research
opencli browser click --role button --name Search --session research
opencli browser close --session research