agent-stealth-browser

name	agent-stealth-browser
description	Stealth 模式的浏览器自动化 MCP 工具，能够绕过反爬检测（如 Cloudflare、reCAPTCHA 等）。完全兼容 agent-browser API。当需要操作有反爬保护的网站时使用此工具，包括：(1) 访问受保护页面 (2) 自动登录需要验证的网站 (3) 表单填写和提交 (4) 截图和数据提取 (5) 持久化登录状态

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": "[e-mail]"}
browser_fill {"target": "@e2", "text": "password123"}
browser_click {"target": "@e3"}
browser_wait {"ms": 2000}
browser_snapshot {}  # 检查结果

示例: 保存登录状态

# 登录成功后保存
browser_cookies_save {"domain": "mysite"}

# 下次使用时加载
browser_navigate {"url": "https://mysite.com"}
browser_cookies_load {"domain": "mysite"}
browser_navigate {"url": "https://mysite.com"}  # 刷新应用 cookies

与 agent-browser 的区别

特性	agent-browser	agent-stealth-browser
Stealth 模式	❌	✅
反爬绕过	❌	✅
Cookie 持久化	❌	✅
API 兼容性	-	100%

调试技巧

• 元素找不到: 先滚动 browser_scroll {"direction": "down"} 再重新快照
• 需要等待: 使用 browser_wait {"ms": 2000} 或 browser_wait {"selector": ".element"}
• 检查状态: 使用 browser_screenshot {} 查看当前页面