WebRun Browser Automation

Name: WebRun Browser Automation
Author: webrun.ai

远程服务

webrun.ai浏览器自动化

访问官网

关于 WebRun Browser Automation

在真实的 Chrome 浏览器中运行多步骤任务：持久化环境、实时画面、人工接管。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://api.webrun.ai/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http ai-webrun-webrun https://api.webrun.ai/mcp

Cursor.cursor/mcp.json{"mcpServers":{"ai-webrun-webrun":{"type":"http","url":"https://api.webrun.ai/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"ai-webrun-webrun":{"type":"http","url":"https://api.webrun.ai/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"ai-webrun-webrun":{"type":"http","url":"https://api.webrun.ai/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"ai-webrun-webrun":{"serverUrl":"https://api.webrun.ai/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://api.webrun.ai/mcp需要授权

工具

参数	类型	必填	说明
files	array	否	要附加的可选文件 ID：由 POST /files/upload 返回的 ID，或用户某个环境目录中已有的文件（GET /environments/:id/files）。最多 5 个文件。
model	string	否	可选模型名称或配置档案键（来自全局配置）。若未指定，则使用已配置的默认值。
proxy	object	否	代理配置。由 WebRun 管理：{ source: "WebRun", country: "GB" }。自定义：{ source: "custom", type: "http"\|"socks", host, port, username?, password? }。不使用代理时省略。社交/消息自动化（WhatsApp、Telegram、Instagram、Facebook、X、LinkedIn、TikTok）建议优先将 country 设为用户当前所在国家——请先向用户推荐此设置并确认所在国家；国家不匹配通常会导致登录被拒以及会话反复退出。
proxy.host	string	否	自定义代理主机
proxy.port	number	否	自定义代理端口
proxy.type	enum	否	自定义代理类型http \| socks
proxy.level	enum	否	代理级别。"chrome"（默认）通过浏览器扩展应用代理（立即生效，无需切换实例）。"system" 使用 --proxy-server 标志启动 Chrome（需要切换实例）。system \| chrome
proxy.source	enum	否	代理提供商WebRun \| custom
proxy.country	string	否	WebRun 代理的 ISO 国家代码（例如 "GB"、"US"），或使用 "random" 随机选择一个连接良好的国家
proxy.password	string	否	自定义代理密码（可选）
proxy.username	string	否	自定义代理用户名（可选）
debugC	boolean	否	在实例上启用调试模式（默认：false）
prompt	string	是	用自然语言描述任务
secrets	array	否	传递给实例的域名匹配密钥 [{match, fields}]（不存储）
webhook	object	否	任务完成通知的 Webhook 配置
webhook.url	string	否	接收 Webhook 的 HTTPS URL
webhook.auth	string	否	Authorization 请求头的值
webhook.name	string	否	Webhook 标识符
webhook.submittedData	enum	否	有效负载类型full_response \| structured_output \| just_ping
policyId	string	否	用于应用自动化护栏（域名限制、功能控制、LLM 角色）的策略 ID。可选。
timezone	string	否	会话使用的 IANA 时区名称，例如 "America/New_York"、"Europe/London"、"Asia/Tokyo"。与日期和时间相关的指令（例如 "tomorrow morning"、"today"、"in 2 hours"）将按此时区解释。省略时，如果设置了 WebRun 代理国家/地区，则使用该国家/地区对应的时区（例如 country "de" → Europe/Berlin）；否则使用浏览器默认时区。
outputType	enum	否	响应格式（默认：text）text \| structured_json \| structured_csv
maxDuration	number	否	最长持续时间（分钟）（默认：20，最大：60）
startingUrl	string	否	可选的起始 URL
outputSchema	object	否	结构化输出的 JSON Schema（当 outputType 为 structured_json 时必填）
environmentId	string	否	用于持久配置文件会话的环境 ID。使用 list_environments 查找可用 ID。否则将使用临时实例。
reach_out_mode	enum	否	控制是否向同一环境中的机器人用户主动发送聊天平台消息（Telegram/WhatsApp/Slack/Discord/Teams）。默认值为："off"——除非明确设置，否则不会发送消息。"guardrail_only" 会在 API 调用方离线时，将护栏提示（CAPTCHA/2FA/验证）转发到聊天平台。"full" 还会在任务完成时转发任务结果。每个机器人用户还会根据自己的 reachOutMode 偏好进行筛选。off \| guardrail_only \| full