qz 浏览器智能体

在你自己已登录的 Chrome 里执行的本地优先浏览器智能体,自带模型,做研究、自动化与数据提取。

Star 数
★ 228
最近更新
7 天前
License
Apache-2.0
主语言
HTML

30 秒速览

运行形态
浏览器扩展命令行工具MCP 服务器
可在哪里用
通用 · 跨平台ChatGPT · Codex · Claude Code · OpenAI API · Claude API
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Chrome 或 EdgeNode.js 22 或更高版本(CLI/MCP 桥接)Node.js 24 LTS(从源码构建)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
做竞品或市场调研的人:需要从多个相互不一致的站点抓取指标,横向整理成对比表和带来源的结论。
不适合
  • 需要 Firefox 正式版扩展的团队(暂无已签名的 Firefox 发布)
  • 需要在无 Chrome/Edge 的服务器环境中运行浏览器的场景
官网
alibaba.github.io/qz-browser-agent ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-14最新版本 v0.1.9(2026-11-14)近 7 天每天 +1.1 ★

这个 Agent 能做什么,适合哪些场景?

qz 是阿里巴巴开源(Apache-2.0)的 Chrome 扩展形态浏览器智能体,在侧边面板中运行,用一句话描述任务即可跨站点执行,并输出带来源的表格、文件或报告。它采用自带模型(BYOK)模式,支持 DeepSeek、OpenAI、Claude、OpenRouter、Kimi、Fireworks 等提供方,也可用 ChatGPT 账号通过 OpenAI Codex 登录,数据保存在本地,只发送给你配置的模型和访问的网站。除扩展本身,它还提供 qz-browser-agent 的 npm 包与 CLI(session create、script、create、mcp 等命令),让 Claude Code、Codex、pi 这类编码智能体通过 CLI 或 MCP 直接驱动浏览器,或把整段网页任务交给 qz 内置智能体。执行模型上,qz 运行多个并行任务,每个任务还能派生子任务,成功后可用一句话保存为可复用 Skill。它依赖用户真实本地的 Chrome 或 Edge,因此登录态、Cookie 和扩展都直接可用,无需搭建虚拟环境。

qz 作为 Chrome 侧边栏扩展读取并操作你当前已登录的网页:输入任务后,它在页面中点击、滚动、读取内容,把分散在不同站点的信息整理成数据表、本地文件或带来源的报告。任务可并行执行并派生子任务,完成后可用「Save this as a Skill」把成功流程固化为可复用技能,下次用一句话触发。对外接口方面,npm 包 qz-browser-agent 提供 qz session create(不启动模型地打开浏览器会话)、qz script(在会话中运行使用 qz SDK 的 JavaScript 文件并输出 {ok,result,trace})、qz create(把整任务交给内置智能体,--stream 显示进度)以及 qz mcp(返回 MCP 客户端可用的 HTTP URL)。此外通过 npx skills add alibaba/qz-browser-agent -g 安装的 Skill 充当外部编码智能体直驱浏览器的指南。

  1. 做竞品或市场调研的人:需要从多个相互不一致的站点抓取指标,横向整理成对比表和带来源的结论。
  2. 用 Claude Code、Codex 或 pi 写代码的开发者:希望智能体能打开真实已登录的网页读取内容、执行操作,而不是被登录墙卡住。
  3. 需要每周例行收集信息的分析师:把一次成功的抓取流程保存为 Skill,之后用一句话生成周报。
  4. 研究人员或学生:批量查找某主题的论文、榜单或奖项信息,整理成带链接的表格。
  5. 运营人员:在自己的日常浏览器里完成重复性的页面操作,过程中可随时人工介入或停止。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install --global qz-browser-agent
  • npx skills add alibaba/qz-browser-agent -g
  • npx qz-browser-agent@latest connect uri
  • npx qz-browser-agent@latest
环境变量
SESSION_ID
运行环境
Node.js 24

如何安装或部署这个 Agent?

方式一:在 Chrome 应用商店点击「Add to Chrome」,再点击工具栏中的 qz 图标打开侧边面板。

方式二:无法访问商店时,从最新 release 下载 ZIP 并解压,然后在 chrome://extensions 打开开发者模式,点击「Load unpacked」选择解压出的 qz-browser-agent-extension 目录。

从源码构建需要 Node.js 24 LTS 与 npm:

npm ci
npm run build

构建完成后在 chrome://extensions 加载 dist/extension/。若要在外部智能体中通过 CLI/MCP 使用,需 Node.js 22 或更高版本,并安装全局包:

npm install --global qz-browser-agent

或安装直驱 Skill:

npx skills add alibaba/qz-browser-agent -g

如何使用这个 Agent?

打开侧边面板后,先在 Settings 中选择模型提供方(如 DeepSeek、Claude,或选 OpenAI Codex 并用 ChatGPT 账号登录),填入 API key 并保存。然后输入任务,例如:

Find this year's Nobel Prize winners in every category and put them in a table with source links.

让外部编码智能体驱动浏览器,可先用 CLI 建立会话并运行脚本:

qz session create --title "Compare models" --json
qz script --session SESSION_ID task.js
qz create "your task" --stream

对 MCP 客户端,运行 qz mcp 并使用返回的 HTTP URL。未全局安装时用 npx qz-browser-agent@latest 代替 qz。需要配对特定浏览器配置时:

npx qz-browser-agent@latest connect uri

这个 Agent 有哪些优点和局限?

优点
  • 直接运行在用户已登录的本地 Chrome/Edge 中,登录态、Cookie、扩展天然可用,无需虚拟浏览器环境。
  • 模型可自选(DeepSeek、OpenAI、Claude、OpenRouter、Kimi、Fireworks 等),也有 ChatGPT 账号登录路径,数据只发给你配置的模型。
  • 除人工使用的侧边面板外,还提供 CLI(session create / script / create / mcp)与 MCP 接口,便于 Claude Code、Codex、pi 等外部智能体调用。
  • 支持多任务并行与子任务拆分,并可将成功流程保存为可复用 Skill。
  • Apache-2.0 开源,扩展与 CLI 免费使用。
局限
  • 正式发行仅覆盖 Chrome 与 Edge,Firefox 尚无已签名发布,仅有开发阶段临时加载说明。
  • 模型效果取决于所接提供方的协议与工具调用支持,部分场景需要付费 API key 或 ChatGPT 计划。
  • 外部智能体直驱与 MCP 路径需要 Node.js 22+,从源码构建需要 Node.js 24 LTS,存在运行时版本要求。
  • 本地优先意味数据会发往你选择的模型提供方和访问的站点,对网络与第三方 API 存在依赖。

这个 Agent 与同类方案有什么区别?

README 明确与 Nanobrowser、Browser Use、agent-browser、Playwright MCP 做了对比,并称 qz 在「委派整段任务」「运行在已登录的本地 Chrome」「人与智能体实时控制每一步」「多任务并行且带子任务」「把一次运行保存为可复用 Skill」几项上均有内建支持,而其他项目多为部分支持或不支持(其中 Playwright MCP 不支持整段任务委派与 Skill 保存)。README 也指出其他浏览器智能体通常只能观看、难以中途介入,且往往只为人类或只为智能体其一而设计。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
qz 浏览器智能体 当前 57 · 缺口较多 浏览器扩展免费 + 模型费 ★ 228 7 天前 HTML ChatGPT · Codex · Claude Code · OpenAI API · Claude API
OpenCLI 浏览器自动化命令行 61 · 存在缺口 命令行工具免费 ★ 31k 13 天前 JavaScript Claude Code
Open Browser Use 65 · 存在缺口 命令行工具免费 ★ 430 18 天前 JavaScript Codex · Claude Code
Lightpanda 浏览器 67 · 存在缺口 命令行工具免费 ★ 42k 1 天前 Zig OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
57/ 100 五分制 2.9 / 5
本评测基于 2026年11月10日 的源码;此后该项目发布了 1 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 17/29
可靠稳定 8/14
适用触发 12/18
规范维护 10/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全17 / 29 · 2.9/5

permissions.md 逐项列出 19 项权限及调用方,并区分可选权限(history/bookmarks/desktopCapture/downloads.open)与安装即授予的权限,首次使用有本地化数据披露与同意门控,数据流说明较透明,故 data_flow_transparency 给 3、user_confirmation 给 2。但 <all_urls>、debugger、scripting、geolocation 等安装即授予,权限面偏大,least_privilege 仅 1;敏感数据处理有本地存储与删除说明但凭据存于浏览器 profile、页面/网络内容可能含认证信息,给 2;依赖全部锁定版本并有 overrides,但含 GitHub tarball 与 SheetJS CDN tarball 等非 registry 来源,dependency_security 给 2;外部副作用(表单提交、下载、MCP 外发)缺少统一回滚/撤销机制,external_effects 与 rollback 各给 1;来源归属有 THIRD_PARTY_NOTICES 与保留上游许可的要求,给 2。

可靠稳定8 / 14 · 2.9/5

AGENTS.md 对会话隔离、写入串行化、终止屏障、稳定错误码与恢复指引有明确约定,SKILL.md 对退出码与 sessionId 传递有具体说明,self_consistency 给 2;依赖可用性方面 Node 版本要求不一致(README 与 SKILL 写 22+,package.json engines 与 AGENTS.md 写 24),且存在非 registry 依赖,dependency_availability 给 1;失败信息有稳定 code 与本地化说明的规范,但样本中未见完整实现,failure_messages 给 2。

适用触发12 / 18 · 3.3/5

README 给出面向普通用户与编码代理两类场景及示例,audience_and_scenarios 给 2;SKILL.md 明确脚本沙箱无 document/fs/process、tab 归属与只读跨会话检查,capability_boundaries 给 2;触发条件(何时读 create-task.md、何时用 qz create)有说明但依赖外部 qz skill 指南,trigger_precision 给 2;Chrome/Edge 支持、Firefox 部分支持与打包差异有文档,environment_fit 给 2。

规范维护10 / 18 · 2.8/5

README 结构清晰、安装步骤含商店与手动加载、FAQ 与示例充分,information_architecture、install_notes、examples_and_faq 各给 2;命名与命令在文档间基本一致,naming_stability 给 2;已知限制仅零散提及(Firefox 差异、存储耗尽),known_limitations 给 1;LICENSE 为完整 Apache-2.0 且 package.json 声明一致,license 给 3;未见 CHANGELOG 或版本策略说明,versioning_changelog 给 1;维护责任仅指向 issue tracker,发布者身份未经验证,maintenance_responsibility 给 1。

有效结果7 / 13 · 2.7/5

输出可落地为表格、文件与带来源报告,并有导出与 Data 表能力,output_usability 给 2;相对通用代理在登录态浏览器执行与并行研究上有差异化价值,marginal_value 给 2;成本方面需自备模型 API key 或 ChatGPT 账号,且权限面大、需 Node 环境运行 CLI,成本收益仅给 1。

证据核验3 / 8 · 1.9/5

README 的对比表标注“截至 2026 年 10 月基于公开文档”,但未给出可核验链接,claim_traceability 给 1;仓库内有 CI 工作流与测试目录,但样本未展示测试结果或第三方佐证,cross_source_corroboration 给 1;文档大体区分事实与建议,但对比表中的竞品能力判断属推断且未标注,fact_inference_separation 给 1。

风险与缓解建议
  • 扩展在安装时即获得 <all_urls>、debugger、scripting、geolocation 等宽泛权限,且运行在你已登录的浏览器中,任务可能触及敏感账户数据。
  • 依赖中包含 GitHub tarball 与 SheetJS CDN tarball 等非 npm registry 来源,供应链可审计性弱于纯 registry 依赖。
  • Node 版本要求在不同文档间不一致(22+ 与 24),可能导致 CLI 连接失败。
  • README 中的竞品对比与“本地优先”等表述缺少可核验链接,应视为营销性陈述而非已验证事实。
  • 发布者身份未经验证,维护责任与更新路径仅指向 issue tracker。
证据充分度:低 评估于 2026年11月10日 审查版本 9d33690a91f3 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/qz-browser-agent.svg?lang=zh)](https://followagents.com/zh/agents/qz-browser-agent)
<a href="https://followagents.com/zh/agents/qz-browser-agent"><img src="https://followagents.com/badge/qz-browser-agent.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.1.9
    发布说明摘录
    This release makes it easier to work with tabs you already have open, brings element queries into line across browser tools and the qz SDK, and improves the reliability of model response parsing and CLI cancellation. Improvements - Tab listings now show the current session’s tabs and unclaimed tabs by default, with an ownership field for each tab. Listing and read-only inspection leave ownership unchanged. The first browser action, navigation, or page.evaluate() call on an unclaimed tab claims it for the session. Use scope: "all" to also see tabs owned by other sessions, which are a …
    在 GitHub 查看 ↗
  2. v0.1.7
    发布说明摘录
    A release with direct browser driving for external agents, more flexible model connections, and more reliable page interactions. Improvements - External agents can now drive the browser directly through CLI and MCP, without starting the built-in agent. Create a session with qz session create, then run JavaScript with qz script and the qz SDK. Browser operations and results appear in the side panel. - External sessions can now discover and reuse user Skills, with availability determined by Skill settings and the sites visited during the task. …
    在 GitHub 查看 ↗
  3. v0.1.6
    发布说明摘录
    A release with a Firefox developer preview, improved page tools, and more reliable conversations. Improvements - Added a Firefox developer preview for Firefox 154+, with a native sidebar and CLI and MCP connectivity. Temporary loading is supported; a signed Firefox listing is not available yet, and scheduled tasks remain disabled. See the [Firefox differences guide](https://github.com/alibaba/qz-browser-agent/blob/main/docs/firefox-differences.md) for browser-specific limitations. …
    在 GitHub 查看 ↗

常见问题

使用 qz 需要付费吗?
扩展与 CLI 在 Apache-2.0 下免费。模型费用取决于你选择的提供方,也支持兼容的本地模型;使用 ChatGPT 访问时受你的账号与计划限制。
我可以用哪些模型?
任何支持所需协议与工具调用的提供方均可,包括兼容的本地服务。预置包括 OpenAI Codex、OpenRouter、DeepSeek、Kimi For Coding、OpenCode Go、OpenCode Zen、Fireworks AI 等。
支持 Edge 或 Firefox 吗?
发行包可在 Chrome 与 Edge 中运行。Firefox 尚无已签名上架版本,只有开发阶段的临时加载方式,且与 Chrome 存在已知差异。
数据会离开我的机器吗?
会话、Skill 和采集的数据保存在本地,CLI/MCP 桥接也在本地运行,没有 qz 服务端;数据只会发送给你配置的模型和你正在操作的网站。
外部编码智能体如何调用它?
可以用 CLI 命令 qz session create、qz script、qz create,或运行 qz mcp 获取 HTTP URL 供 MCP 客户端连接;也可用 npx skills add alibaba/qz-browser-agent -g 安装直驱指南 Skill。
qz 浏览器智能体 官网是什么?
qz 浏览器智能体 的 GitHub 仓库填写的官网是 https://alibaba.github.io/qz-browser-agent/。这个链接由仓库作者设置;源码在 GitHub(alibaba/qz-browser-agent)。
qz 浏览器智能体 开源吗?
开源。源码在 GitHub(alibaba/qz-browser-agent),许可证是 Apache-2.0。
qz 浏览器智能体 安全吗?
FollowAgents 的 FARS 评审(2026年11月10日)给 qz 浏览器智能体 的“信任与安全”打了 17/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
qz 浏览器智能体 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-14,在最近 30 天内。最新版本是 v0.1.9(2026-11-14)。
qz 浏览器智能体 是谁开发的?
qz 浏览器智能体 由 GitHub 账号 alibaba 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念