SuperAPI AI 工具集

stagehand-browser-cli

通用与其它

查看项目

更新于 10-16 08:05

技能介绍

用途:通过 CLI 以自然语言驱动浏览器完成网页自动化,如浏览网站、导航页面、提取数据等。仅在用户提出相关需求时使用。

环境选择:技能会依据 .env 中是否存在 BROWSERBASE_API_KEY 与 BROWSERBASE_PROJECT_ID 自动选择环境。存在则使用 Browserbase 远程环境;不存在则回退到本地 Chrome。无需用户手动选择。

首次安装(仅需一次):检查本目录下的 setup.json,若 setupComplete 为 false,则执行: npm install npm link 该命令会安装依赖并创建全局 browser 命令。

主要命令(两种模式通用): browser navigate <url>(前往网址) browser act "<action>"(执行自然语言动作) browser extract "<instruction>" ['{}'](提取数据,可选 schema) browser observe "<query>"(发现可用元素) browser screenshot(截图) browser close(关闭浏览器)

示例: browser navigate https://example.com browser act "click the Sign In button" browser extract "get the page title" browser close

模式对比:本地模式速度更快,需要 Chrome,无 stealth 模式,无代理与验证码支持,适合开发;Browserbase 模式略慢,需要 API key,支持 stealth 模式以及代理与验证码,适合生产与抓取。

最佳实践:先 navigate 再交互;每次命令后查看截图核对;动作描述尽量具体;完成后关闭浏览器。

限制与排错:Chrome 未找到时需安装 Chrome 或改用 Browserbase;动作失败时可用 browser observe 查看可用元素;Browserbase 失败时确认 API key 与 project id 已设置。更多示例见 EXAMPLES.md,API 参考见 REFERENCE.md。