www (Broxy Dev)

中文文档 |英语

布罗克西

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

Broxy是什么？

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

特性

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

用例

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

安装

面向网站开发人员

在您的网站上添加一行：

访问者可以立即使用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许可证

链接

• 网站： https://broxy.dev
• 篡改密钥： https://www.tampermonkey.net