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

🌐 English | 中文

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

---

• 🎯 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

• 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.

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.8.0/dist/iife/page-agent.demo.js
China	https://registry.npmmirror.com/page-agent/1.8.0/files/dist/iife/page-agent.demo.js

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.

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 🙌

We welcome contributions from the community! See CONTRIBUTING.md for guidelines and docs/developer-guide.md for local development workflows.

Please read the maintainer's note on principles and current state.

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

MIT License

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.

---

⭐ Star this repo if you find PageAgent helpful!