qz 浏览器智能体
在你自己已登录的 Chrome 里执行的本地优先浏览器智能体,自带模型,做研究、自动化与数据提取。
- Star 数
- ★ 228
- 最近更新
- 7 天前
- License
- Apache-2.0
- 主语言
- HTML
- FA 评分
- 57/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 做竞品或市场调研的人:需要从多个相互不一致的站点抓取指标,横向整理成对比表和带来源的结论。
- 不适合
- 需要 Firefox 正式版扩展的团队(暂无已签名的 Firefox 发布)
- 需要在无 Chrome/Edge 的服务器环境中运行浏览器的场景
- 官网
- alibaba.github.io/qz-browser-agent ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-14最新版本 v0.1.9(2026-11-14)近 7 天每天 +1.1 ★
- 源码审查
- 57/100 · 缺口较多
这个 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 充当外部编码智能体直驱浏览器的指南。
- 做竞品或市场调研的人:需要从多个相互不一致的站点抓取指标,横向整理成对比表和带来源的结论。
- 用 Claude Code、Codex 或 pi 写代码的开发者:希望智能体能打开真实已登录的网页读取内容、执行操作,而不是被登录墙卡住。
- 需要每周例行收集信息的分析师:把一次成功的抓取流程保存为 Skill,之后用一句话生成周报。
- 研究人员或学生:批量查找某主题的论文、榜单或奖项信息,整理成带链接的表格。
- 运营人员:在自己的日常浏览器里完成重复性的页面操作,过程中可随时人工介入或停止。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install --global qz-browser-agentnpx skills add alibaba/qz-browser-agent -gnpx qz-browser-agent@latest connect urinpx 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?
查看各维度的扣分理由
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。
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。
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。
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。
输出可落地为表格、文件与带来源报告,并有导出与 Data 表能力,output_usability 给 2;相对通用代理在登录态浏览器执行与并行研究上有差异化价值,marginal_value 给 2;成本方面需自备模型 API key 或 ChatGPT 账号,且权限面大、需 Node 环境运行 CLI,成本收益仅给 1。
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。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
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 查看 ↗ -
发布说明摘录
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 查看 ↗ -
发布说明摘录
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 需要付费吗?
我可以用哪些模型?
支持 Edge 或 Firefox 吗?
数据会离开我的机器吗?
外部编码智能体如何调用它?
qz 浏览器智能体 官网是什么?
qz 浏览器智能体 开源吗?
qz 浏览器智能体 安全吗?
qz 浏览器智能体 还在维护吗?
qz 浏览器智能体 是谁开发的?
谢谢反馈,我们会据此改进页面。