# CamoFox 瀏覽器

CamoFox 瀏覽器是一款無介面的反偵測瀏覽器自動化伺服器，以 Camoufox（具有 C++ 層級指紋偽造功能的 Firefox 分支）驅動。它使 AI 代理能夠可靠地瀏覽被 Cloudflare、Google 及其他機器人偵測系統封鎖的網站。

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

Language: zh-TW

Category: Tools & Extensions

Updated: 2026-04-08

## CamoFox Browser 是什麼？

CamoFox Browser 是一款專為 **AI 智慧體** 打造的無頭瀏覽器自動化伺服器。它由 **Camoufox** 驅動——一個 Firefox 的分支版本，能在 **C++ 引擎層級** 進行瀏覽器指紋偽裝，而非依賴脆弱的 JavaScript 修補程式。

這使得 AI 智慧體能夠訪問那些通常會封鎖自動化工具（如 Playwright 或 Puppeteer）的真實網站，包括受 Cloudflare、Google 和其他進階機器人偵測系統保護的網站。

它與 Jo AI 助手背後使用的瀏覽器引擎相同，並能與 OpenClaw 及其他智慧體框架無縫整合。

## 主要功能

-Detection**：在瀏覽器引擎層級偽裝 navigator 屬性、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；支援延遲啟動和閒置關閉。可在 Raspberry Pi 或廉價 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"
```

**透過參照點擊元素**

```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 網站保護的反機器人機制
- 使用匯入的 Cookies 進行認證瀏覽
- 在長期運行的代理程式工作流程中，進行權杖效率高的網頁互動
- 與 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)