page-agent 是什么?

Page Agent 是阿里巴巴开源的页内 JavaScript GUI Agent。它把当前网页的 DOM 简化为文本交给用户配置的模型,再在同一页面执行点击、输入等动作;核心库不需要 Python、无头浏览器或截图。

⭐ 26,124 Stars 🍴 2,402 Forks TypeScript MIT 作者: alibaba
来源:github.com/alibaba/page-agent 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

它把自然语言操作直接嵌入现有 Web 产品,适合表单、后台和 SaaS copilot,不必另外部署浏览器集群。当前版本还提供可选 Chrome 扩展处理多标签页,以及 Beta MCP Server 供外部客户端调用。

来源:github.com/alibaba/page-agent

核心功能

页内 DOM Agent

核心库运行在网页中,读取简化 DOM 并执行页面动作,不依赖截图或多模态模型。

来源:github.com/alibaba/page-agent
BYOK 模型接口

可配置 OpenAI 兼容端点或本地模型;开源库自身不带后端,数据直接发往用户选择的模型服务。

来源:github.com/alibaba/page-agent (1) · github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md (2)
多页扩展

可选 Chrome 扩展把控制范围扩展到多个标签页,配置保存在浏览器本地存储。

来源:github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md
外部 Agent 接入

Beta MCP Server 允许 MCP 客户端从页面外部调用 Page Agent;该入口仍需单独评估权限。

来源:github.com/alibaba/page-agent

技术架构

page-agent 包把自然语言任务、页面控制器、模型适配器和 UI 组件装入当前页面。页面控制器生成简化 HTML/DOM 表示,模型返回动作计划,执行器在页面上下文中调用 DOM 交互。Chrome 扩展增加标签页控制,MCP Server 把能力暴露给外部 Agent;核心开源库仍是客户端 BYOK 架构。

来源:github.com/alibaba/page-agent (1) · github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md (2)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) @page-agent/core@page-agent/co… @page-agent/llms@page-agent/ll… @page-agent/page-controller@page-agent/pa… @page-agent/ui 用户自备的 OpenAI 兼容或本地模型用户自备的 Open… 页内 DOM Agent BYOK 模型接口 多页扩展 外部 Agent 接入 page-agent 项目本体 核心功能 关键依赖

技术栈

语言TypeScript / JavaScript ESM框架页内 DOM Agent;Vite 构建;Zod peer dependency
@page-agent/core@page-agent/llms@page-agent/page-controller@page-agent/ui用户自备的 OpenAI 兼容或本地模型
npm 或 CDN 加载;可选 Chrome 扩展与 Beta MCP;核心库没有内置后端
来源:github.com/alibaba/page-agent/blob/main/packages/page-agent/package.json

快速上手

生产集成应使用 npm install page-agent 并配置自己的模型端点。先在无敏感数据的本地测试页,只授权一个低风险按钮和文本框,记录 DOM 摘要与动作;确认失败停止、元素定位和用户确认后,再扩大页面范围。免费 demo CDN 仅限技术评估,不能用于生产。
来源:github.com/alibaba/page-agent (1) · github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md (2)

使用场景

适合为自有 SaaS、ERP、CRM 或管理后台增加自然语言表单填写、页面导航和辅助访问功能。它不是服务端爬虫框架,也不适合在未经许可的第三方页面自动提交订单、付款或隐私数据。

来源:github.com/alibaba/page-agent (1) · github.com/alibaba/page-agent (2)

优势与局限

优势

  • 直接嵌入网页,不需要单独的 Python 浏览器服务
  • 文本 DOM 路线不强制使用截图或多模态模型
  • BYOK 架构可选择模型服务或本地模型

局限

  • 简化 DOM 仍可能包含可见文字、表单值和敏感数据
  • canvas、复杂富文本、跨域 iframe 和动态组件可能超出纯 DOM 路线能力
  • 免费测试 API 仅限评估,可能限流或停止,且数据经中国大陆阿里云基础设施处理
  • Chrome 扩展扩大到多标签页,MCP 仍是 Beta,二者都增加权限面
  • 页面动作可能产生真实副作用,提交、删除、付款前必须加人工确认
来源:github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md (1) · github.com/alibaba/page-agent (2)

最新版本

当前最新正式版为 v1.12.4,发布于 2026-09-06;README 的 CDN 示例和 packages/page-agent/package.json 也已同步到 1.12.4。

来源:github.com/alibaba/page-agent/releases/tag/v1.12.4 (1) · github.com/alibaba/page-agent/blob/main/packages/page-agent/package.json (2)

实测与证据

status: official_docs_checked_not_locally_installed  |  checked_at: 2026-09-23  |  environment: 核对官方 README、package.json、Terms & Privacy、MIT LICENSE 和 GitHub v1.12.4 Release;未安装 npm 包、扩展或 MCP  |  limitations: 未验证 bundle、DOM 提取、模型兼容、动作成功率、跨页扩展、MCP、免费 API、数据处理或任何生产页面  |  observed_output: package.json、README CDN 示例和 GitHub latest release 均为 1.12.4;release 发布于 2026-09-06;条款说明核心库 BYOK、无内置后端,demo API 仅限评估

来源:github.com/alibaba/page-agent/releases/tag/v1.12.4 (1) · github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md (2)

同类项目对比

Page Agent 嵌入自有网页,通过文本 DOM 做客户端增强;Browser Use 控制独立或现有浏览器,会使用 CDP,并可选择截图/视觉、本地浏览器或付费云浏览器。给自己的 Web 产品加页内 copilot 时 Page Agent 更轻;需要跨站导航、真实浏览器配置或服务端自动化时 Browser Use 覆盖更广,但权限和基础设施也更重。

来源:github.com/alibaba/page-agent (1) · github.com/browser-use/browser-use (2)

总结评价

Page Agent 适合在自有网页内做低门槛自然语言操作。生产前要用 BYOK、限制可操作元素,并为提交、删除和付款设置人工确认;免费 demo、扩展和 Beta MCP 只能分别按其数据与权限边界测试,不能把单页演示直接当成生产自动化。

来源:官方 Releases

常见问题

Page Agent 的免费 Demo LLM 可以用于生产吗?

不能。官方条款只允许技术评估和研发,服务可能限流、降级或停止;生产环境应使用自己的合规模型 API 或本地模型。

Page Agent 会把整个网页发送给模型吗?

它会发送任务指令和简化后的页面结构。官方明确提醒清理过程不能保证移除可见文字、表单值等敏感信息,因此要先限制页面与数据范围。

Page Agent 是否必须安装 Chrome 扩展?

核心单页用法不需要扩展。只有多标签页任务才需要可选扩展;外部 MCP 控制则使用仍处于 Beta 的 MCP Server。

Page Agent v1.12.4 是当前正式版吗?

是。README、package.json 与 GitHub latest release 均指向 1.12.4;该版本发布于 2026-09-06。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 10:52.

参考材料:README、GitHub API、依赖文件