page-agent
JavaScript 实现的页面内 GUI Agent,无需浏览器扩展或后端,直接通过自然语言操控网页界面。核心亮点是基于文本的 DOM 操作,不依赖多模态模型,集成简单(一行 CDN 或 npm),支持自有 LLM,可轻松为 SaaS 产品添加 AI Copilot,也支持多标签页的 Chrome 扩展。适合需要快速为现有系统增加自然语言交互能力的开发者。
README
Page Agent
GUI Agent 驻留在你的网页中。用自然语言操控网页界面。
🌐 English | 中文
🚀 演示 | 📖 文档 | 📢 HN 讨论 | 𝕏 关注 X
https://github.com/user-attachments/assets/a1f2eae2-13fb-4aae-98cf-a3fc1620a6c2
✨ 特性
- 🎯 轻松集成
- 无需浏览器扩展(browser extension)/ Python / 无头浏览器(headless browser)。
- 仅需页面内嵌 JavaScript。所有操作都在你的网页中完成。
- 📖 基于文本的 DOM 操控
- 无需截图。无需多模态大模型(multi-modal LLMs)或特殊权限。
- 🧠 自带大模型(Bring your own LLMs)
- 🐙 可选的多页面 Chrome 扩展 → Chrome 扩展
- 以及一个 MCP 服务器(Beta) 用于从外部控制
💡 使用场景
- SaaS AI 助手(Copilot) — 几行代码即可在产品中注入 AI 助手,无需重写后端。
- 智能表单填写 — 将 20 步操作转化为一句话。完美适用于 ERP、CRM 和管理系统。
- 无障碍访问(Accessibility) — 通过自然语言让任何 web 应用可访问。语音指令、屏幕阅读器,零障碍。
- 多页面 Agent —— 借助 Chrome 扩展 让你的 web agent 跨浏览器标签页执行任务。
- MCP —— 允许你的 agent 客户端控制浏览器。
🚀 快速开始
一行集成
使用我们的免费 Demo LLM 快速体验 PageAgent:
<script src="{URL}" crossorigin="true"></script>
⚠️ 仅用于技术评估。 此演示 CDN 使用我们的免费测试 LLM API。使用即表示你同意其条款。
| 镜像源 | URL |
|---|---|
| 全球 | https://cdn.jsdelivr.net/npm/page-agent@1.10.0/dist/iife/page-agent.demo.js |
| 中国 | https://registry.npmmirror.com/page-agent/1.10.0/files/dist/iife/page-agent.demo.js |
若想加载脚本但不自动创建演示 agent,可添加 ?autoInit=false。然后通过 new window.PageAgent(...) 自行实例化。
NPM 安装
npm install page-agent
import { PageAgent } from 'page-agent'
const agent = new PageAgent({
model: 'qwen3.5-plus',
baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
apiKey: 'YOUR_API_KEY',
language: 'en-US',
})
await agent.execute('点击登录按钮')
更多编程用法参见 📖 文档。
🌟 精彩 Page Agent 项目
用 PageAgent 做出了什么酷东西?将它添加到这里!提交 PR 来分享你的项目。
这些是社区项目 —— 并非由我们维护或背书。请自行判断使用。
| 项目 | 描述 |
|---|---|
| 你的? | 提交 PR 🙌 |
🤝 贡献
我们欢迎社区贡献!请参阅 CONTRIBUTING.md 了解指南,以及 docs/developer-guide.md 了解本地开发工作流。
请阅读维护者说明了解原则和当前状态。
完全由机器人或 AI 生成且缺乏实质性人类参与的贡献将不会被接受。
⚖️ 许可证
👏 致谢
本项目建立在 browser-use 的优秀工作之上。
PageAgent 设计用于客户端 Web 增强,而非服务端自动化。
DOM 处理组件和 prompt 来源于 browser-use:
Browser Use <https://github.com/browser-use/browser-use>
Copyright (c) 2024 Gregor Zunic
Licensed under the MIT License
我们衷心感谢 browser-use 项目及其贡献者在 web 自动化和 DOM 交互模式方面所做的出色工作,正是这些工作使本项目成为可能。
⭐ 如果你觉得 PageAgent 有用,请给仓库点个 Star!