网页评估代理

Name: 网页评估代理
Author: withRefresh

作者：withRefresh1214 星标更新：2025-11-22

安装使用来源：spider==github.com

项目介绍

⚠️ 项目已终止 ⚠️

该项目已被停止。我们正在 withrefresh.com 上构建一些新东西。

🚀 operative.sh web-eval-agent MCP 服务器

让编码代理自行调试，你有更好的事情要做。

🔥 提升你的调试能力

operative.sh 的 MCP 服务器启动了一个由浏览器驱动的代理，可以在你的代码编辑器中自主执行并调试 Web 应用程序。

⚡ 功能

🌐 使用 BrowserUse 导航您的 Web 应用程序（使用 operative 后端时速度提高两倍）
📊 捕获网络流量 - 请求被智能过滤并返回到上下文窗口
🚨 收集控制台错误 - 捕获日志和错误
🤖 自主调试 - Cursor 代理调用 Web QA 代理 MCP 服务器来测试它编写的代码是否按预期工作。

🧰 MCP 工具参考

工具	目的
`web_eval_agent`	🤖 自动化 UX 评估器，驱动浏览器，捕获屏幕截图、控制台和网络日志，并返回丰富的 UX 报告。
`setup_browser_state`	🔒 打开一个交互式（非无头）浏览器，以便你可以一次性登录；保存的 cookie/本地存储会被后续的 `web_eval_agent` 运行重用。

关键参数

web_eval_agent
- url (必需) – 正在运行的应用地址（例如 http://localhost:3000）
- task (必需) – 测试内容的自然语言描述（“完成注册流程并记录任何 UX 问题”）
- headless_browser (可选，默认 false) – 设置为 true 隐藏浏览器窗口
setup_browser_state
- url (可选) – 要打开的第一个页面（方便直接进入登录界面）

你可以在 IDE 聊天模式中直接触发这些工具，例如：

评估我在 http://localhost:3000 的应用 – 使用 web_eval_agent 并设置任务 "尝试完整的注册流程并报告 UX 问题"。

🏁 快速开始

一键集成轻松设置

获取你的 API 密钥（免费） - 创建 API 密钥时，你会看到：
- “添加到 Cursor” 按钮，带有深度链接以实现即时安装
- 预填充的 Claude Code 命令，自动包含你的 API 密钥

手动设置（macOS/Linux）

先决条件（通常不需要）：

brew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
npm: (brew install npm)
jq: brew install jq

在获取 API 密钥（免费）后运行安装程序
- 安装 playwright
- 安装 uv
- 将 JSON 插入到你的代码编辑器（Cursor/Cline/Windsurf）中！

curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh

访问你最喜欢的 IDE 并重启以应用更改
在聊天模式中发送提示以调用 web 评估代理工具！例如：

测试我在 http://localhost:3000 的应用。使用 web-eval-agent。

🛠️ 手动安装

在 operative.sh/mcp 获取你的 API 密钥
安装 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

安装后设置环境变量

Mac

source ~/.zshrc

Linux

source ~/.bashrc

安装 playwright：

npm install -g chromium playwright && uvx --with playwright playwright install --with-deps

将以下 JSON 添加到相关代码编辑器中，包含 API 密钥
重启你的代码编辑器

🔃 更新

uv cache clean
刷新 MCP 服务器

    "web-eval-agent": {
      "command": "uvx",
      "args": [
        "--refresh-package",
        "webEvalAgent",
        "--from",
        "git+https://github.com/Operative-Sh/web-eval-agent.git",
        "webEvalAgent"
      ],
      "env": {
        "OPERATIVE_API_KEY": "<YOUR_KEY>"
      }
    }

Operative Discord 服务器

🛠️ 手动安装（Mac + Cursor/Cline/Windsurf）

在 operative.sh/mcp 获取你的 API 密钥
安装 uv

curl -LsSf https://astral.sh/uv/install.sh | sh)

安装 playwright:

npm install -g chromium playwright && uvx --with playwright playwright install --with-deps

将以下 JSON 添加到相关代码编辑器中，包含 API 密钥
重启你的代码编辑器

手动安装（Windows + Cursor/Cline/Windsurf）

我们正在优化此功能，请在遇到任何问题时打开一个 issue！

在你的代码编辑器终端中执行所有操作
curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh
在 operative.sh/mcp 获取你的 API 密钥
安装 uv (curl -LsSf https://astral.sh/uv/install.sh | sh)
uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install
重启代码编辑器

🚨 问题

代码编辑器未接收到更新，请更新或重新安装最新版本：运行 uv cache clean 获取最新版本
如遇任何问题，请随时在此仓库或 Discord 中打开一个 Issue！
5/5 - 静态应用没有变化时未进行屏幕录制，已修复！uv clean + 重启以获得修复

变更日志

4/29 - 代理覆盖更新 - 在浏览器中暂停/播放/停止代理运行

📋 示例 MCP 服务器输出报告

📊 Web 评估报告 http://localhost:5173 完成！
📝 任务：通过导航到 API 密钥部分，删除一个密钥并判断 UX 来测试 API 密钥删除流程。

🔍 代理步骤
  📍 1. 导航 → http://localhost:5173
  📍 2. 点击 "登录" （按钮索引 2）
  📍 3. 点击 "API 密钥" （按钮索引 4）
  📍 4. 点击 "创建密钥" （按钮索引 9）
  📍 5. 输入 "测试 API 密钥" （输入索引 2）
  📍 6. 点击 "完成" （按钮索引 3）
  📍 7. 点击 "删除" （按钮索引 10）
  📍 8. 点击 "删除" （确认索引 3）
🏁 流程测试成功 – UX 感觉流畅且直观。

🖥️ 控制台日志（10）
  1. [debug] [vite] 连接中……
  2. [debug] [vite] 已连接。
  3. [info] 下载 React 开发工具……
     …

🌐 网络请求（10）
  1. GET /src/pages/SleepingMasks.tsx 304
  2. GET /src/pages/MCPRegistryRegistry.tsx 304
     …

⏱️ 时间线
  01:16:23.293 🖥️ 控制台 [debug] [vite] 连接中……
  01:16:23.303 🖥️ 控制台 [debug] [vite] 已连接。
  01:16:23.312 ➡️ GET /src/pages/SleepingMasks.tsx
  01:16:23.318 ⬅️ 304 /src/pages/SleepingMasks.tsx
     …
  01:17:45.038 🤖 🏁 流程结束 – 删除验证
  01:17:47.038 🤖 📋 结论如上所述
👁️ 查看 "Operative 控制中心" 仪表板以获取实时日志。

星标历史

由 <3 在 operative.sh 构建