网页控制服务

Broxy将任何网页转换为MCP服务器,使AI助手能够直接控制和交互网页,适用于自动化任务和数据监控。

  • by broxy-dev
  • JavaScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 broxy-dev/www

使用说明

中文文档 |英语

布罗克西

将任何网页转换为MCP服务器。让AI助手直接控制浏览器。

Broxy是什么?

Broxy将任何网页转换为MCP(模型上下文协议)服务器,使Claude和Cursor等AI助手能够直接与网页交互和控制网页。这开辟了强大的自动化可能性,而不需要传统的API。

特性

  • API端点 -在任何网页上执行JavaScript,并为外部调用公开API
  • 人工智能集成 -完全MCP支持Claude/Cursor直接控制浏览器
  • Web自动化 -模拟任何网页上的输入、点击和请求

用例

  • 人工智能自动化 -让Claude/Cursor自动填写表格、提交报告、预订会议室
  • 数据监测 -实时监控价格、股票报价、竞争对手数据
  • API生成器 -将没有公共API的网站转换为可调用接口

安装

面向网站开发人员

在您的网站上添加一行:

<script src="https://broxy.dev/assets/broxy-v1.user.js"></script>

访问者可以立即使用Broxy服务,而无需安装任何扩展。

对于用户

  1. 安装 油猴 浏览器扩展
  2. 点击 这里 添加Broxy脚本
  3. 打开任何网站,点击Broxy浮动按钮(右下角)进行配置

运作原理

User ⇄ AI Client (Claude/Cursor) ⇄ Broxy ⇄ Webpage
  1. 用户与AI助手交互
  2. AI通过MCP向Broxy发送命令
  3. Broxy在目标网页上执行JavaScript
  4. 结果返回给AI助手

全球API

加载Broxy时,全局 BroxyDev 对象可用:

// Theme
BroxyDev.getTheme()           // 'light' | 'dark'
BroxyDev.setTheme('dark')
BroxyDev.toggleTheme()

// Language
BroxyDev.getLang()            // 'zh' | 'en'
BroxyDev.setLang('en')
BroxyDev.toggleLang()

// Settings
BroxyDev.getSettings()        // { theme, lang }

// Browser Info
BroxyDev.getBrowserInfo()     // { userAgent, platform, url, ... }

配置

Broxy使用配置系统来定义路线和工具:

window.__BROXY_INIT_DATA__ = {
  version: "1.0",
  data: {
    routes: [...],      // REST API endpoints
    tools: [...],       // MCP tools
    mcpConfig: {...},   // MCP server configuration
    initScript: ""      // Custom initialization script
  }
}

路线

定义自定义API终结点:

{
  name: "getTheme",
  pattern: "/theme",
  method: "get",
  handler: "async (method, path, query, body, headers) => { ... }",
  enabled: true
}

MCP工具

为AI助手定义工具:

{
  name: "setTheme",
  pattern: "/mcp/setTheme",
  description: "Set the website theme",
  handler: "async ({ theme }) => { ... }",
  inputSchema: {
    type: "object",
    properties: {
      theme: { type: "string", description: "dark | light" }
    },
    required: ["theme"]
  },
  enabled: true
}

发展

这是一个没有构建系统的静态网站。要在本地预览,请执行以下操作:

# Python
python3 -m http.server 8000

# Node.js
npx serve .

# PHP
php -S localhost:8000

然后打开 http://localhost:8000 在您的浏览器中。

项目结构

www/
├── index.html              # Main landing page
├── script.js               # Core functionality
├── i18n.js                 # Internationalization
├── styles.css              # Styling
└── assets/
    ├── broxy-v1.user.js    # Tampermonkey userscript
    ├── data.js             # Default configuration
    └── logo.png            # Logo image

浏览器支持

  • 支持ES6+的现代浏览器
  • Chrome、Firefox、Safari、Edge(最新版本)

许可证

MIT许可证

链接