agent-stealth-browser

Agent Stealth Browser

与 agent-browser 兼容的 Stealth 模式浏览器 MCP 工具。

MCP 配置

{
  "mcpServers": {
    "stealth-browser": {
      "command": "uvx",
      "args": ["agent-stealth-browser"]
    }
  }
}

核心工作流

1. 导航: browser_navigate {"url": "<url>"}
2. 快照: browser_snapshot {} (返回带 @ref 的元素列表)
3. 交互: 使用快照中的 @ref 进行操作
4. 页面变化后重新获取快照

工具列表

导航

browser_navigate {"url": "<url>"}           # 导航到 URL
browser_close {}                            # 关闭浏览器

快照 (页面分析)

browser_snapshot {}                         # 获取可交互元素
browser_snapshot {"interactive_only": true} # 仅交互元素（默认）

交互 (使用快照中的 @ref)

browser_click {"target": "@e1"}                          # 点击
browser_fill {"target": "@e2", "text": "内容"}           # 清空并填写
browser_type {"target": "@e2", "text": "内容"}           # 逐字输入
browser_press {"key": "Enter"}                           # 按键
browser_hover {"target": "@e1"}                          # 悬停
browser_select {"target": "@e1", "value": "选项值"}      # 下拉选择
browser_scroll {"direction": "down", "amount": 500}      # 滚动

获取信息

browser_get {"what": "text", "target": "@e1"}  # 获取文本
browser_get {"what": "html", "target": "@e1"}  # 获取 HTML
browser_get {"what": "value", "target": "@e1"} # 获取输入值
browser_get {"what": "title"}                  # 获取标题
browser_get {"what": "url"}                    # 获取 URL

截图

browser_screenshot {}                          # 当前视口截图
browser_screenshot {"full_page": true}         # 全页面截图
browser_screenshot {"selector": "@e1"}         # 指定元素截图

等待

browser_wait {"ms": 2000}                      # 等待毫秒
browser_wait {"selector": ".success"}          # 等待元素出现

Cookie 持久化

browser_cookies_save {"domain": "example"}     # 保存登录状态
browser_cookies_load {"domain": "example"}     # 加载登录状态

JavaScript

browser_eval {"script": "document.title"}      # 执行 JS

示例: 表单提交

browser_navigate {"url": "https://example.com/form"}
browser_snapshot {}
# 输出: @e1 textbox "Email", @e2 textbox "Password", @e3 button "Submit"

browser_fill {"target": "@e1", "text": "[email protected]"}
browser_fill {"target": "@e2", "text": "password123"}
browser_click {"target": "@e3"}
browser_wait {"ms": 2000}
browser_snapshot {}  # 检查结果