# CamoFox浏览器

CamoFox浏览器是由Camoufox（具有C++级指纹伪装的Firefox分支）驱动的无头反检测浏览器自动化服务器。它能让AI代理可靠地浏览被Cloudflare、Google和其他机器人检测系统屏蔽的网站。

Canonical URL: https://a2a-mcp.org/entry/camofox-browser-zh

Language: zh

Category: Tools & Extensions

Updated: 2026-04-08

## CamoFox 浏览器是什么？

CamoFox 浏览器是一款专为**AI智能体**打造的无头浏览器自动化服务器。它由 **Camoufox** 提供支持——这是一个 Firefox 的分支版本，能够在 **C++ 引擎层面**执行浏览器指纹欺骗，而不是依赖脆弱的 JavaScript 补丁。

这使得 AI 智能体能够访问那些通常会屏蔽 Playwright 或 Puppeteer 等自动化工具的真实网站，包括受 Cloudflare、Google 和其他高级机器人检测系统保护的网站。

它与 Jo AI 助手背后使用的是相同的浏览引擎，并能与 OpenClaw 及其他智能体框架无缝集成。

## 主要特性

- **C++ 层面反检测**：在浏览器引擎层面欺骗导航器属性、WebGL、AudioContext、屏幕几何、WebRTC 等，实现最高级别的不可检测性。
- **高效的快照令牌**：返回无障碍树快照（比原始 HTML 小约 90%）+ 可选的 base64 截图。
- **稳定的元素引用**：使用可靠的 `e1`、`e2` 等引用进行点击、输入和交互操作。
- **会话隔离**：按 userId 和 sessionKey 进行隔离，具备自动过期和标签页回收机制。
- **代理与 GeoIP 对齐**：通过匹配语言环境、时区和地理位置的住宅代理路由流量。
- **Cookie 导入**：支持 Netscape 格式的 Cookie 注入，用于已认证的会话（例如 LinkedIn、Amazon 等）。
- **内置搜索宏**：`@google_search`、`@youtube_search`、`@amazon_search`、`@reddit_subreddit` 及更多。
- **YouTube 字幕提取**：通过 yt-dlp 快速提取，或使用浏览器作为备用方案。
- **低资源占用**：闲置内存约 40MB；支持延迟启动和空闲关闭。可在树莓派或廉价 VPS 上运行。
- **结构化 API**：提供 REST 端点，具备 JSON 日志记录和请求 ID 追踪功能。

## 架构

- 浏览器由 Camoufox 驱动
- 每个用户拥有独立的 BrowserContext
- 按 sessionKey 组织的标签页组
- 自动空闲关闭与按需重新启动

## 安装与快速开始

### 独立安装

```bash
git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser
npm install
npm start
```

服务器运行于 `http://localhost:9377`。Camoufox（约 300MB）将在首次运行时自动下载。

### Docker 安装

```bash
make up
```

支持 Fly.io、Railway 以及多架构构建。

### OpenClaw 集成

```bash
openclaw plugins install @askjo/camofox-browser
```

## 使用示例

**新建标签页**

```bash
curl -X POST http://localhost:9377/tabs \
  -H "Content-Type: application/json" \
  -d '{"userId": "agent1", "sessionKey": "task1", "url": "https://example.com"}'
```

**获取无障碍快照 + 截图**

```bash
curl "http://localhost:9377/tabs/{TAB_ID}/snapshot?userId=agent1&includeScreenshot=true"
```

**通过 ref 点击元素**

```bash
curl -X POST http://localhost:9377/tabs/{TAB_ID}/click \
  -d '{"userId": "agent1", "ref": "e1"}'
```

**使用宏进行搜索**

```bash
curl -X POST http://localhost:9377/tabs/{TAB_ID}/navigate \
  -d '{"userId": "agent1", "macro": "@google_search", "query": "best wireless headphones"}'
```

## 应用场景

- 需要可靠网络浏览的AI智能体（用于调研、购物、社交媒体等）
- 绕过受Cloudflare保护或Google网站的反机器人防护
- 使用导入的Cookie进行身份验证的浏览
- 在长时间运行的智能体工作流中实现令牌高效的网络交互
- 与 OpenClaw、Claude Desktop（通过 MCP）、LangChain 及自定义智能体集成

## 资源链接

- GitHub: https://github.com/jo-inc/camofox-browser
- Camoufox: https://camoufox.com
- OpenClaw 集成: https://openclaw.ai
- 文档: https://jo-inc-camofox-browser.mintlify.app

CamoFox Browser 采用 MIT 许可证，持续维护（最新版本发布于 2026 年 4 月），并广泛用于生产环境中的 AI 智能体网络自动化。

## Tags

- AI代理
- 无头浏览器
- 反检测
- 浏览器自动化
- camoufox
- openclaw
- mcp
- playwright
- 指纹伪装
- typescript
- node-js

## Sources

- [Project website](https://github.com/jo-inc/camofox-browser)