# 카모폭스 브라우저

카모폭스 브라우저는 카모우폭스(C++ 수준 지문 스푸핑 기능을 탑재한 Firefox 포크)로 구동되는 헤드리스 안티 디텍션 브라우저 자동화 서버입니다. AI 에이전트가 Cloudflare, Google 및 기타 봇 탐지 시스템에 의해 차단된 사이트를 안정적으로 탐색할 수 있도록 합니다.

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

Language: ko

Category: Tools & Extensions

Updated: 2026-04-08

## CamoFox 브라우저란 무엇인가요?

CamoFox 브라우저는 **AI 에이전트**를 위해 특별히 구축된 헤드리스 브라우저 자동화 서버입니다. **Camoufox**를 기반으로 작동합니다. Camoufox는 취약한 JavaScript 패치 대신 **C++ 엔진 수준**에서 지문 스푸핑을 수행하는 Firefox 포크입니다.

이를 통해 AI 에이전트는 일반적으로 Playwright나 Puppeteer와 같은 자동화 도구를 차단하는 실제 웹사이트들, Cloudflare, Google 및 기타 고급 봇 탐지 시스템으로 보호되는 사이트들까지 접근할 수 있습니다.

이는 Jo AI 어시스턴트 배후에서 사용되는 동일한 브라우징 엔진이며, OpenClaw 및 기타 에이전트 프레임워크와 원활하게 통합됩니다.

## 주요 기능

- **C++ 수준의 탐지 방지**: 브라우저 엔진 수준에서 navigator 속성, WebGL, AudioContext, 화면 기하학, WebRTC 등을 스푸핑하여 최대한의 탐지 불가능성을 제공합니다.
- **토큰 효율적인 스냅샷**: 접근성 트리 스냅샷(~90% 원본 HTML보다 작음) + 선택적 base64 스크린샷을 반환합니다.
-tabl
.  **안정적인 요소 참조**: 클릭, 입력 및 상호 작용을 위해 신뢰할 수 있는 `e1`, `e2`, ... 참조를 사용합니다.
- **세션 격리**: 자동 만료 및 탭 재활용과 함께 사용자ID와 sessionKey별 격리.
- **프록시 및 GeoIP 정렬**: 일치하는 로케일, 시간대 및 지리적 위치를 가진 주거용 프록시를 통해 트래픽을 라우팅합니다.
- **쿠키 가져오기**: 인증된 세션(LinkedIn, Amazon 등)을 위한 Netscape 형식 쿠키 주입을 지원합니다.
- **내장 검색 매크로**: `@google_search`, `@youtube_search`, `@amazon_search`, `@reddit_subreddit` 등.
- **YouTube 자막 추출**: yt-dlp를 통한 빠른 경로 또는 브라우저 대체 방법.
1.  **낮은 리소스 사용량**: 유휴 메모리 약 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"
```

**참조(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 사이트에서 봇 방지 시스템 우회

- 가져온 쿠키를 이용한 인증 브라우징

- 장기 실행 에이전트 워크플로우에서 효율적인 토큰 사용을 통한 웹 상호작용

1. 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)