# CamoFox ブラウザ

CamoFox Browser は、Camoufox（C++レベルのフィンガープリント偽装を搭載したFirefoxフォーク）を搭載したヘッドレスアンチ検出ブラウザ自動化サーバーです。AIエージェントがCloudflareやGoogleなどのボット検知システムによってブロックされたサイトを確実にブラウジングできるようにします。

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

Language: ja

Category: Tools & Extensions

Updated: 2026-04-08

## CamoFox ブラウザとは？

CamoFox ブラウザは、**AIエージェント**向けに特別に構築されたヘッドレスブラウザ自動化サーバーです。**Camoufox** — 脆弱なJavaScriptパッチではなく**C++エンジンレベル**でフィンガープリント偽装を実行するFirefoxフォーク — を搭載しています。

これにより、AIエージェントは、PlaywrightやPuppeteerなどの自動化ツールを通常ブロックするCloudflare、Google、その他の高度なボット検知システムで保護された実ウェブサイトを含む、実際のサイトを訪問できます。

これは、Jo AIアシスタントの背後で使用されているのと同じブラウジングエンジンであり、OpenClawやその他のエージェントフレームワークとシームレスに統合されます。

## 主な機能

- **C++レベルでの検出回避**: ナビゲータープロパティ、WebGL、AudioContext、画面ジオメトリ、WebRTCなどをブラウザエンジンレベルで偽装し、最大限の検出不可能性を実現。
- **トークン効率的なスナップショット**: アクセシビリティツリースナップショット（生のHTMLより約90％小さい）＋オプションのbase64スクリーンショットを返します。
- **安定した要素参照**: クリック、タイピング、インタラクションに信頼性の高い `e1`、`e2`、... refsを使用。
- **セッション分離**: ユーザーIDおよびsessionKeyごとの分離。自動有効期限切れとタブリサイクル。
- **プロキシとGeoIPの整合**: 一致するロケール、タイムゾーン、地理位置情報を持つリジデンシャルプロキシを介してトラフィックをルーティング。
- **Cookieインポート**: 認証済みセッション（LinkedIn、Amazonなど）のNetscape形式Cookieインジェクションをサポート。
- **組み込み検索マクロ**: `@google_search`、`@youtube_search`、`@amazon_search`、`@reddit_subreddit`など。
- **YouTubeトランスクリプト抽出**: yt-dlp経由の高速パスまたはブラウザフォールバック。
- **低リソース使用量**: アイドル時メモリ約40MB。遅延起動およびアイドルシャットダウン。Raspberry Piまたは安価なVPSで動作。
- **構造化API**: JSONロギングおよびリクエストIDトレーシング付きRESTエンドポイント。

## アーキテクチャ

- 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"
```

**参照IDによる要素クリック**

```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)