网页问答代理

Name: 网页问答代理
Author: withRefresh

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

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

项目介绍

⚠️ 项目已终止 ⚠️

该项目已被废弃。我们正在 withrefresh.com 构建新东西。

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

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

🔥 加速你的调试

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

⚡ 功能

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

🧰 MCP 工具参考

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

关键参数

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

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

评估我在 http://localhost:3000 上的应用 – 运行带有任务 “尝试完整的注册流程并报告用户体验问题”的 web_eval_agent。

🏁 快速开始

一键集成轻松设置

获取你的 API 密钥（免费） - 创建 API 密钥时，你会看到：
- “添加到 Cursor” 按钮，带有深度链接，用于即时安装 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

安装 uv 后源环境变量

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/操作性-sh/web-eval-agent.git playwright install
重启代码编辑器

🚨 问题

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

更改日志

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

📋 示例 MCP 服务器输出报告

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

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

🖥️ 控制台日志（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 控制中心”仪表板以获取实时日志。

星标历史

由 ❤️ 在 operative.sh 构建