跳到主内容
智客 ZICQ

技能库 智客分类:其他 browser-use OpenClaw

Browser Use

自动化浏览器交互,用于网页测试,格式填充,截图和数据提取. 当用户需要浏览网站,与网页互动,填表,取出截图,或从网页取出信息时使用.

502 安装量 · 121 星标

官方网址:ClawHub

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

自动化浏览器交互,用于网页测试、格式填充、截图和数据提取

何时用

用户需要浏览网站、与网页互动、填写表格、截图或从网页提取信息

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Browser Automation with browser-use CLI、Prerequisites、Core Workflow、Browser Modes、Commands、Navigation。 其中含规范建议的小节:分步指令。

文件分析

文件分析:除 SKILL.md 外,正文引用了 references/cdp-python.md、references/multi-session.md,属于带资源的技能包,这些文件按需再读。

官方 description(原文)

Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, or extract information from web pages.

Browser Automation with browser-use CLIPrerequisitesCore WorkflowBrowser ModesCommandsNavigationPage State — always run state first to get element indicesInteractions — use indices from stateData ExtractionWaitCookiesSession

· allowed-tools:Bash(browser-use:*)

来源分类:ClawHub Browser Automation

SKILL.md 与 Agent 调用

官方规范 ↗
name
browser-use
description
Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, or extract information from web pages.
allowed-tools
Bash(browser-use:*)实验字段,支持情况取决于客户端;字段声明本身不会授予工具权限。
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 2
  • references/cdp-python.md
  • references/multi-session.md

以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

该技能引用了附属文件,请从来源获取完整目录;仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「browser-use」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-a827b9635b2a2d55-%E6%B5%8F%E8%A7%88%E5%99%A8%E4%BD%BF%E7%94%A8.html
请存为 .cursor/skills/browser-use/SKILL.md 或 .claude/skills/browser-use/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
该技能还带 scripts/、references/、assets/ 等文件,请从 https://clawhub.ai/skills/browser-use 取完整目录,不要只建一个 SKILL.md。

当前没有明确的 GitHub 技能包地址,请按来源页面的安装器说明操作。

ClawHub ↗

阅读排版
--- name: browser-use description: Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, or extract information from web pages. allowed-tools: Bash(browser-use:*) --- # Browser Automation with browser-use CLI The `browser-use` command provides fast, persistent browser automation. A background daemon keeps the browser open across commands, giving ~50ms latency per call. ## Prerequisites ```bash browser-use doctor # Verify installation ``` For setup details, see https://github.com/browser-use/browser-use/blob/main/browser_use/skill_cli/README.md ## Core Workflow 1. **Navigate**: `browser-use open ` — launches headless browser and opens page 2. **Inspect**: `browser-use state` — returns clickable elements with indices 3. **Interact**: use indices from state (`browser-use click 5`, `browser-use input 3 "text"`) 4. **Verify**: `browser-use state` or `browser-use screenshot` to confirm 5. **Repeat**: browser stays open between commands If a command fails, run `browser-use close` first to clear any broken session, then retry. To use the user's existing Chrome (preserves logins/cookies): run `browser-use connect` first. To use a cloud browser instead: run `browser-use cloud connect` first. After either, commands work the same way. ## Browser Modes ```bash browser-use open # Default: headless Chromium (no setup needed) browser-use --headed open # Visible window (for debugging) browser-use connect # Connect to user's Chrome (preserves logins/cookies) browser-use cloud connect # Cloud browser (zero-config, requires API key) browser-use --profile "Default" open # Real Chrome with specific profile ``` After `connect` or `cloud connect`, all subsequent commands go to that browser — no extra flags needed. ## Commands ```bash # Navigation browser-use open # Navigate to URL browser-use back # Go back in history browser-use scroll down # Scroll down (--amount N for pixels) browser-use scroll up # Scroll up browser-use tab list # List all tabs browser-use tab new [url] # Open a new tab (blank or with URL) browser-use tab switch # Switch to tab by index browser-use tab close [index...] # Close one or more tabs # Page State — always run state first to get element indices browser-use state # URL, title, clickable elements with indices browser-use screenshot [path.png] # Screenshot (base64 if no path, --full for full page) # Interactions — use indices from state browser-use click # Click element by index browser-use click # Click at pixel coordinates browser-use type "text" # Type into focused element browser-use input "text" # Click element, then type browser-use keys "Enter" # Send keyboard keys (also "Control+a", etc.) browser-use select "option" # Select dropdown option browser-use upload # Upload file to file input browser-use hover # Hover over element browser-use dblclick # Double-click element browser-use rightclick # Right-click element # Data Extraction browser-use eval "js code" # Execute JavaScript, return result browser-use get title # Page title browser-use get html [--selector "h1"] # Page HTML (or scoped to selector) browser-use get text # Element text content browser-use get value # Input/textarea value browser-use get attributes # Element attributes browser-use get bbox # Bounding box (x, y, width, height) # Wait browser-use wait selector "css" # Wait for element (--state visible|hidden|attached|detached, --timeout ms) browser-use wait text "text" # Wait for text to appear # Cookies browser-use cookies get [--url ] # Get cookies (optionally filtered) browser-use cookies set # Set cookie (--domain, --secure, --http-only, --same-site, --expires) browser-use cookies clear [--url ] # Clear cookies browser-use cookies export # Export to JSON browser-use cookies import # Import from JSON # Session browser-use close # Close browser and stop daemon browser-use sessions # List active sessions browser-use close --all # Close all sessions ``` For advanced browser control (CDP, device emulation, tab activation), see `references/cdp-python.md`. ## Cloud API ```bash browser-use cloud connect # Provision cloud browser and connect (zero-config) browser-use cloud login # Save API key (or set BROWSER_USE_API_KEY) browser-use cloud logout # Remove API key browser-use cloud v2 GET /browsers # REST passthrough (v2 or v3) browser-use cloud v2 POST /tasks '{"task":"...","url":"..."}' browser-use cloud v2 poll # Poll task until done browser-use cloud v2 --help # Show API endpoints ``` `cloud connect` provisions a cloud browser with a persistent profile (auto-created on first use), connects via CDP, and prints a live URL. `browser-use close` disconnects AND stops the cloud browser. For custom browser settings (proxy, timeout, specific profile), use `cloud v2 POST /browsers` directly with the desired parameters. ### Agent Self-Registration Only use this if you don't already have an API key (check `browser-use doctor` to see if api_key is set). If already logged in, skip this entirely. 1. `browser-use cloud signup` — get a challenge 2. Solve the challenge 3. `browser-use cloud signup --verify ` — verify and save API key 4. `browser-use cloud signup --claim` — generate URL for a human to claim the account ## Tunnels ```bash browser-use tunnel # Start Cloudflare tunnel (idempotent) browser-use tunnel list # Show active tunnels browser-use tunnel stop # Stop tunnel browser-use tunnel stop --all # Stop all tunnels ``` ## Profile Management ```bash browser-use profile list # List detected browsers and profiles browser-use profile sync --all # Sync profiles to cloud browser-use profile update # Download/update profile-use binary ``` ## Command Chaining Commands can be chained with `&&`. The browser persists via the daemon, so chaining is safe and efficient. ```bash browser-use open https://example.com && browser-use state browser-use input 5 "[email protected]" && browser-use input 6 "password" && browser-use click 7 ``` Chain when you don't need intermediate output. Run separately when you need to parse `state` to discover indices first. ## Common Workflows ### Authenticated Browsing When a task requires an authenticated site (Gmail, GitHub, internal tools), use Chrome profiles: ```bash browser-use profile list # Check available profiles # Ask the user which profile to use, then: browser-use --profile "Default" open https://github.com # Already logged in ``` ### Exposing Local Dev Servers ```bash browser-use tunnel 3000 # → https://abc.trycloudflare.com browser-use open https://abc.trycloudflare.com # Browse the tunnel ``` ## Multiple Browsers For subagent workflows or running multiple browsers in parallel, use `--session NAME`. Each session gets its own browser. See `references/multi-session.md`. ## Configuration ```bash browser-use config list # Show all config values browser-use config set cloud_connect_proxy jp # Set a value browser-use config get cloud_connect_proxy # Get a value browser-use config unset cloud_connect_timeout # Remove a value browser-use doctor # Shows config + diagnostics browser-use setup # Interactive post-install setup ``` Config stored in `~/.browser-use/config.json`. ## Global Options | Option | Description | |--------|-------------| | `--headed` | Show browser window | | `--profile [NAME]` | Use real Chrome (bare `--profile` uses "Default") | | `--cdp-url ` | Connect via CDP URL (`http://` or `ws://`) | | `--session NAME` | Target a named session (default: "default") | | `--json` | Output as JSON | | `--mcp` | Run as MCP server via stdin/stdout | ## Tips 1. **Always run `state` first** to see available elements and their indices 2. **Use `--headed` for debugging** to see what the browser is doing 3. **Sessions persist** — browser stays open between commands 4. **CLI aliases**: `bu`, `browser`, and `browseruse` all work 5. **If commands fail**, run `browser-use close` first, then retry ## Troubleshooting - **Browser won't start?** `browser-use close` then `browser-use --headed open ` - **Element not found?** `browser-use scroll down` then `browser-use state` - **Run diagnostics:** `browser-use doctor` ## Cleanup ```bash browser-use close # Close browser session browser-use tunnel stop --all # Stop tunnels (if any) ```

相关技能

其他

Self Improving Agent

掌握学习、错误和校正,以便不断改进。 使用时间:(1) 命令或操作意外失败, (2) 用户更正 Claude ('No, that's wrong...', 'Actually...'), (3)用户请求具备不存在的能力,(4)外部API或工具失败,(5)克洛德意识到其知识已经过…

其他

Self Improving + Proactive Agent

自我反省+自我批评+自我学习+自我组织记忆. 特工评估自己的工作,发现错误,并永久改进. 当 (1) 命令,工具, API, 或操作失败时使用; (2) 用户纠正或拒绝您的工作; (3) 您意识到您的知识已经过时或不正确; (4) 您发现更好的方法; (5) 用户明确安装或引用当…

其他

Proactive Agent

将AI代理人从任务跟踪者转变为预先预测需要并不断改进的主动伙伴. 现在WAL协议,工作缓冲,自主克龙, 和战斗测试模式。 哈尔·斯塔克的一部分

其他

Multi Search Engine

多搜索引擎集成16个引擎(7个CN+9 Global). 支持高级搜索操作员,时间过滤器,站点搜索,隐私引擎,和WolframAlpha知识查询. 不需要 API 密钥 .