您的浏览器已经可以使用了！

English | 中文 | Deutsch | Español | Français | 日本語 | 한국어 | Português | Русский

---

AIPex — 一个开源的浏览器自动化代理，直接运行在您现有的浏览器中。

• 零迁移：无需安装新浏览器，也无需学习新的工作流程。
• 开源：采用 MIT 许可证，完全透明、可审计且可扩展。
• 隐私优先：您的数据永远不会离开您的设备。自带密钥（BYOK）。

---

我们为什么开发它

目前所有的浏览器自动化工具都要求您：

• 安装一个独立的浏览器（如 Dia/Comet）
• 支付月度订阅费用（如 ChatGPT Atlas）
• 交出您的浏览数据

我们问自己：为什么自动化不能直接在您已经使用的浏览器中运行呢？

AIPex 就是答案。只需安装扩展程序，带上您自己的 API 密钥，就可以在您日常工作的地方直接自动化任何任务。

---

快速开始

1. 安装 — Chrome Web Store 或 Edge Add-ons
2. 打开 — 点击 AIPex 图标
3. 自动化 — 用自然语言输入或说出您想要的操作

---

与 AI 编码代理（MCP）结合使用

AIPex 现在支持 模型上下文协议 (MCP)，使像 Cursor、Claude Code 和 VS Code Copilot 这样的 AI 编码代理可以直接控制您的浏览器。

AI 代理 ──stdio──▶ aipex-mcp-bridge ──WebSocket──▶ AIPex 扩展 ──▶ 浏览器

第一步：配置您的代理

Cursor（.cursor/mcp.json）· Claude Desktop（claude_desktop_config.json）· Windsurf（mcp_config.json）：

{
  "mcpServers": {
    "aipex-browser": {
      "command": "npx",
      "args": ["-y", "aipex-mcp-bridge"]
    }
  }
}

Claude Code：

claude mcp add aipex-browser -- npx -y aipex-mcp-bridge

VS Code Copilot（.vscode/mcp.json）：

{
  "servers": {
    "aipex-browser": {
      "command": "npx",
      "args": ["-y", "aipex-mcp-bridge"]
    }
  }
}

第二步：连接扩展程序

1. 打开 Chrome → AIPex 图标 → 选项
2. 将 WebSocket URL 设置为 ws://localhost:9223
3. 点击 连接

现在，您的代理可以通过 MCP 使用超过 30 种浏览器自动化工具。更多高级选项请参阅 mcp-bridge/README.md。

---

技能

AIPex 自带一个 aipex-browser 技能包——这是一个即用型技能包，适用于支持技能协议的代理（例如 Claude Code 和兼容 OpenClaw 的运行时）。

该技能包包含了工具的使用策略、所有 30 多种浏览器工具的完整参数模式以及常见的自动化模式，因此代理无需从头探索工具，就能有效地控制浏览器。

完整的技能定义请参阅 skill/SKILL.md。

---

演示

“我打开了 100 个标签页，请帮忙。”

https://github.com/user-attachments/assets/4a4f2a64-691c-4783-965e-043b329a8035

“在我不离开浏览器的情况下研究这个主题”

https://github.com/user-attachments/assets/71ec4efd-d80e-4e8f-8e39-88baee3ec38e

“帮我写一条推文”

https://github.com/user-attachments/assets/81f6b482-84d0-4fd9-924b-dca634b208ec

“帮我通过这次考试”

https://github.com/user-attachments/assets/ba454715-c759-41df-bf87-e835f76be365

---

路线图？

• 页面理解

  • 可访问性树

  • 优化后的 DOM

  • 视觉处理

• 上下文工程

  • 基于搜索的检索

  • 删除未使用的快照

  • 基于 ID 的操作

• 集成

  • Cursor

  • Claude Code

• 技能

  • 文件系统

  • 脚本执行

• 评估 - Online-Mind2Web

为什么浏览器自动化需要调试器？

---

贡献

我们非常欢迎贡献！请参阅 DEVELOPMENT.md 获取设置说明。

贡献者

---

星标历史

---

由 AIPex 团队用心打造

AIPex 快速上手指南

AIPex 是一款开源的浏览器自动化代理工具，直接运行在你现有的浏览器中。无需安装新浏览器，无需迁移数据，支持自然语言控制。

环境准备

• 操作系统：Windows / macOS / Linux
• 浏览器：
  • Google Chrome（推荐最新版）
  • Microsoft Edge（推荐最新版）
• 前置依赖：
  • 若需与 AI 编程助手（如 Cursor、Claude Code）联动，需安装 Node.js (用于运行 npx 命令)
  • 自备大模型 API Key（BYOK 模式，数据本地处理）

安装步骤

方式一：通过应用商店安装（推荐）

直接点击以下链接一键安装扩展程序：

• Chrome 网上应用店安装
• Edge 加载项安装

方式二：配置 MCP 桥接（可选，用于连接 AI 编程助手）

如果你希望让 Cursor、Claude Code 或 VS Code Copilot 直接控制浏览器，请执行以下步骤：

1. 配置 AI 助手

   根据你的开发工具，在对应的配置文件中添加以下内容：

   Cursor (.cursor/mcp.json) 或 VS Code Copilot (.vscode/mcp.json)：

   {
     "mcpServers": {
       "aipex-browser": {
         "command": "npx",
         "args": ["-y", "aipex-mcp-bridge"]
       }
     }
   }
   

   Claude Code (命令行执行)：

   claude mcp add aipex-browser -- npx -y aipex-mcp-bridge
   

2. 连接扩展程序

   • 打开浏览器，点击 AIPex 图标进入 Options (选项)。
   • 将 WebSocket URL 设置为 ws://localhost:9223。
   • 点击 Connect。

基本使用

1. 启动自动化

安装完成后，点击浏览器右上角的 AIPex 图标 打开面板。

2. 输入指令

在输入框中直接使用自然语言（中文或英文）描述你想要执行的操作。支持文本输入或语音输入。

使用示例：

• 标签页管理：

  "我打开了 100 个标签页，帮我整理一下，关闭不相关的页面。"

• 信息检索：

  "在不离开当前浏览器的情况下，帮我研究一下 'Rust 语言异步编程' 的最新趋势，并总结要点。"

• 内容创作：

  "根据当前页面的内容，帮我写一条推文。"

• 辅助学习：

  "帮我解答这个在线考试题目，并解释原因。"

3. 执行与观察

AIPex 将自动解析你的指令，操作浏览器 DOM 树，执行点击、滚动、输入等操作，并将结果反馈给你。整个过程数据保留在本地，安全隐私。