BrowserWing Executor API

概述

BrowserWing Executor 通过 HTTP API 提供全面的浏览器自动化能力。你可以控制浏览器导航、与页面元素交互、提取数据和分析页面结构。

API 基础 URL： http://localhost:8080/api/v1/executor

核心能力

• 页面导航： 导航到 URL、前进/后退、刷新
• 元素交互： 点击、输入、选择、悬停页面元素
• 数据提取： 从元素中提取文本、属性、值
• 无障碍分析： 获取无障碍快照以理解页面结构
• 高级操作： 截图、JavaScript 执行、键盘输入
• 批处理： 按顺序执行多个操作

API 端点

1. 发现可用命令

重要： 始终先调用此端点查看所有可用命令及其参数。

curl -X GET 'http://{host}/api/v1/executor/help'

2. 获取无障碍快照

关键： 导航后始终调用此端点以理解页面结构并获取元素 RefID。

curl -X GET 'http://{host}/api/v1/executor/snapshot'

用途：

• 了解页面上有哪些交互元素
• 获取元素 RefID（@e1、@e2 等）用于精确识别
• 查看元素标签、角色和属性
• 无障碍树比原始 DOM 更清晰，更适合理解页面结构

3. 常用操作

导航到 URL

curl -X POST 'http://{host}/api/v1/executor/navigate' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com"}'

点击元素

curl -X POST 'http://{host}/api/v1/executor/click' \
  -H 'Content-Type: application/json' \
  -d '{"identifier": "@e1"}'

标识符格式： RefID（推荐）、CSS 选择器、XPath、文本内容

输入文本

curl -X POST 'http://{host}/api/v1/executor/type' \
  -H 'Content-Type: application/json' \
  -d '{"identifier": "@e3", "text": "user@example.com"}'

提取数据

curl -X POST 'http://{host}/api/v1/executor/extract' \
  -H 'Content-Type: application/json' \
  -d '{"selector": ".product-item", "fields": ["text", "href"], "multiple": true}'

批量操作

curl -X POST 'http://{host}/api/v1/executor/batch' \
  -H 'Content-Type: application/json' \
  -d '{
    "operations": [
      {"type": "navigate", "params": {"url": "https://example.com"}, "stop_on_error": true},
      {"type": "click", "params": {"identifier": "@e1"}, "stop_on_error": true}
    ]
  }'

4. 标签页管理

标签页索引从 0 开始。支持列出、创建、切换和关闭标签页。

# 列出标签页
curl -X POST 'http://{host}/api/v1/executor/tabs' \
  -H 'Content-Type: application/json' \
  -d '{"action": "list"}'