Page Agent

The GUI Agent Living in Your Webpage. Control web interfaces with natural language.

🌐 English | 中文

🚀 Demo | 📖 Docs | 📢 HN Discussion | 𝕏 Follow on X

page-agent-demo-0227.mp4

---

✨ Features

• 🎯 Easy integration
  • No need for browser extension / python / headless browser.
  • Just in-page javascript. Everything happens in your web page.
• 📖 Text-based DOM manipulation
  • No screenshots. No multi-modal LLMs or special permissions needed.
• 🧠 Bring your own LLMs
• 🐙 Optional chrome extension for multi-page tasks.
  • And an MCP Server (Beta) to control it from outside

💡 Use Cases

• SaaS AI Copilot — Ship an AI copilot in your product in lines of code. No backend rewrite.
• Smart Form Filling — Turn 20-click workflows into one sentence. Perfect for ERP, CRM, and admin systems.
• Accessibility — Make any web app accessible through natural language. Voice commands, screen readers, zero barrier.
• Multi-page Agent — Extend your own web agent's reach across browser tabs chrome extension.
• MCP - Allow your agent clients to control your browser.

🚀 Quick Start

One-line integration

Fastest way to try PageAgent with our free Demo LLM:

<script src="{URL}" crossorigin="true"></script>

⚠️ For technical evaluation only. This demo CDN uses our free testing LLM API. By using it, you agree to its terms.

Mirrors	URL
Global	https://cdn.jsdelivr.net/npm/page-agent@1.6.2/dist/iife/page-agent.demo.js
China	https://registry.npmmirror.com/page-agent/1.6.2/files/dist/iife/page-agent.demo.js

NPM Installation

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('Click the login button')

For more programmatic usage, see 📖 Documentations.

🤝 Contributing

We welcome contributions from the community! Follow our instructions in CONTRIBUTING.md for setup and guidelines.

Please read the maintainer note and Code of Conduct before opening issues or PRs.

Contributions generated entirely by bots or agents without substantial human involvement will not be accepted.

⚖️ License

MIT License

👏 Acknowledgments

This project builds upon the excellent work of browser-use.

PageAgent is designed for client-side web enhancement, not server-side automation.

DOM processing components and prompt are derived from browser-use:

Browser Use <https://github.com/browser-use/browser-use>
Copyright (c) 2024 Gregor Zunic
Licensed under the MIT License

We gratefully acknowledge the browser-use project and its contributors for their
excellent work on web automation and DOM interaction patterns that helped make
this project possible.

🌟 Awesome Page Agent

Built something cool with PageAgent? Add it here! Open a PR to share your project.

These are community projects — not maintained or endorsed by us. Use at your own discretion.

Project	Description
Yours?	Open a PR 🙌

---

⭐ Star this repo if you find PageAgent helpful!