Browser Automation - 浏览器自动化交互工具
v1.0.1通过 Stagehand CLI 与 Claude,使用自然语言指令实现网页浏览、页面导航、数据抽取、截图、填写表单、点击按钮等浏览器操作,支持本地 Chrome 和远程 Browserbase 双模式。
56· 4.2万·0 当前·0 累计
下载技能包
License
MIT-0
此技能需要访问外网资源,可能需要科学上网
运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install browser-automation
镜像加速npx clawhub@latest install browser-automation --registry https://cn.longxiaskill.com 镜像可用
国内专用npm install --registry=https://registry.npmmirror.com && npm link
本土化适配说明
使用 npm 安装依赖并创建全局命令,已切换至国内镜像源,加速下载。
技能文档
使用 Stagehand CLI 与 Claude 自动化浏览器交互。
第一步:环境选择(本地 vs 远程)
技能会在本地浏览器环境和远程浏览器环境之间自动选择:
- 如果在 .env 文件中存在 Browserbase API 密钥(BROWSERBASE_API_KEY 和 BROWSERBASE_PROJECT_ID):使用远程 Browserbase 环境
- 如果没有 Browserbase API 密钥:回退使用本地 Chrome 浏览器
- 无需用户提示:选择依据可用配置自动完成
初始化(仅首次)
检查本目录下的 setup.json。如果 setupComplete: false:
npm install # 安装依赖
npm link # 创建全局 browser 命令
命令列表
所有命令在两种模式下行为一致:
browser navigate# 打开指定 URLbrowser act ""# 使用自然语言描述的操作browser extract "" ['{}']# 提取数据(可选提供 JSON Schema)browser observe ""# 查询并发现页面元素browser screenshot# 截取当前页面截图browser close# 关闭浏览器
快速示例
browser navigate https://example.com
browser act "click the Sign In button"
browser extract "get the page title"
browser close
模式对比
| 特性 | 本地模式 | Browserbase |
|---|---|---|
| 速度 | 更快 | 稍慢 |
| 环境准备 | 需安装 Chrome | 需提供 API 密钥 |
| 隐身模式 | 否 | 是 |
| 代理 / CAPTCHA | 否 | 是 |
| 适用场景 | 开发 | 生产/爬取 |
最佳实践
- 交互前请先使用
navigate进行页面导航 - 每条指令后查看截图以确认操作结果
- 动作描述尽量具体明确
- 完成后记得关闭浏览器
故障排除
- 找不到 Chrome:请安装 Chrome,或切换至 Browserbase 模式
- 操作失败:使用
browser observe检查可交互元素 - Browserbase 失效:确认 API 密钥和项目 ID 已正确配置
更多示例请参阅 EXAMPLES.md,API 参考请查看 REFERENCE.md。