AB
AB
AiBoss站

全部分类

project

qz-browser-agent - 在你自己的 Chrome 里运行的开源浏览器智能体

qz-browser-agent 是阿里巴巴开源的一款浏览器智能体，以 Chrome 扩展形式运行在用户已登录的浏览器中，支持自带模型 API Key，并可通过 CLI 与 MCP 接受其他智能体派发的网页任务。

qz-browser-agent 是由 alibaba 开源的一款浏览器智能体（browser agent），以 Chrome 扩展的形式运行在用户自己的浏览器里。按项目自述，它的定位是「本地优先」：用户用一句话描述任务，它就在已经登录的站点之间操作、抓取数据，最后交付表格、文件或带来源的报告。它面向的读者大致有三类：希望把重复的网页检索与整理工作交给智能体的人；希望让编码类智能体（如 Claude Code、Codex 一类）具备真实浏览器执行能力的开发者；以及在意数据去向、希望自己选择模型与 API Key 的用户。

维护者与状态

该项目由 alibaba 维护，仓库创建于 2026-10-12，最后一次提交在 2026-10-30。最新正式版本为 v0.1.6，发布于 2026-10-29。截至 2026-11-07，仓库星标数为 210。从时间线看，这是一个非常年轻的项目，版本号仍处于 0.1.x 阶段，接口与行为在后续版本中发生变化的可能性需要使用者自行评估。

主要能力

以下能力均来自项目自述（README），并非第三方评测结论。

  • 在真实浏览器中执行：据项目说明，通用智能体在真实网页上常因登录墙、长点击序列、滚动加载而失败，qz 选择在用户本地真实的 Chrome 中跑完这些流程，再把干净的结果交回给调用方。
  • 过程可见、可随时介入：它常驻在浏览器侧边栏，用户能看到每一步与结果，并可随时介入或停止。README 称这一点同时服务于人和智能体两类使用者。
  • 并行研究与子任务：项目自述支持同时运行多个任务，每个任务还可以派生子任务，从而把大型调研拆开并行处理，而不是卡在单个智能体上。
  • 把一次成功运行保存为 Skill：据 README，任务跑通后说一句「Save this as a Skill」即可保存，下次用一句话复用。
  • 自带模型：项目说明称可接入任意支持相应协议与工具调用的模型提供商，预设包括 OpenAI Codex、OpenRouter、DeepSeek、Kimi For Coding、OpenCode Go、OpenCode Zen、Fireworks AI 等，也支持兼容的本地模型服务；使用 ChatGPT 账号时可选 OpenAI Codex 登录，无需 API Key。
  • 供其他智能体调用：README 称 Claude Code、Codex、pi 等编码智能体可以通过 CLI 或 MCP 把网页任务交给 qz 执行。
  • 本地优先：项目自述没有 qz 服务端，会话、Skill 与采集到的数据保存在本机，CLI/MCP 桥接也在本地运行，数据只发往用户配置的模型与所操作的网站。

使用入口

仓库地址为 alibaba/qz-browser-agent，项目文档站点为 qz-browser-agent 官网。

按 README 的快速开始，安装路径是：在 Chrome 应用商店点击「Add to Chrome」，再从工具栏打开侧边栏；在 Settings 中选择模型提供商、填入 API Key 并保存；然后在侧边栏输入任务即可。无法访问 Chrome 应用商店时，项目说明可从最新 release 下载 ZIP 解压，在 chrome://extensions 开启开发者模式后「Load unpacked」加载解压出的扩展目录。

若要让其他智能体调用 qz，README 给出的步骤是先安装 Skill，再配对一次（要求 Node.js 22 或更高版本），之后直接用自然语言让智能体把任务转给 qz：

npx skills add alibaba/qz-browser-agent -g
npx qz-browser-agent@latest connect

也可以直接使用 CLI 或 MCP：

npx qz-browser-agent@latest create "your task" --stream
npx qz-browser-agent@latest mcp

据项目说明，--stream 会显示进度、需要用户回答的问题以及最终结果；MCP 客户端在配对后运行上述命令并使用它返回的 HTTP 地址。日常使用可全局安装 npm install --global qz-browser-agent，之后用 qz 代替 npx qz-browser-agent@latest。从源码构建则需要 Node.js 24 LTS 与 npm，执行 npm ci 与 npm run build，再加载 dist/extension/。

许可与限制

许可证为 Apache-2.0。README 称扩展与 CLI 在该许可下免费，但模型调用费用取决于所选提供商；ChatGPT 的可用性与额度取决于账号与套餐。

已知限制与适用边界（据项目说明）：

  • 浏览器支持方面，正式发布版本运行在 Chrome 与 Edge 上；Firefox 尚无已签名的商店条目，仅提供开发用的临时加载方式，且与 Chrome 存在若干差异。
  • CLI 配对需要 Node.js 22 或更高版本，源码构建需要 Node.js 24 LTS。
  • 模型必须支持相应协议与工具调用，并非任意模型都能直接接入。
  • 数据保存在本地、只发往用户配置的模型与所操作的网站，这一特性同时意味着结果质量与费用在很大程度上由用户自己的模型选择决定。

项目仍处于 0.1.x 阶段，README 中的能力描述属于维护者自述，实际表现建议以仓库最新文档与 release 说明为准。

返回