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를 통한 빠른 경로 또는 브라우저 대체 방법.

낮은 리소스 사용량: 유휴 메모리 약 40MB; 지연 실행 및 유휴 시 종료. Raspberry Pi 또는 저렴한 VPS에서 실행 가능.

구조화된 API: JSON 로깅 및 요청 ID 추적 기능을 갖춘 REST 엔드포인트.

아키텍처

Camoufox로 구동되는 브라우저
사용자별 격리된 BrowserContext
sessionKey별로 구성된 탭 그룹
자동 유휴 종료 및 주문형 재시작

설치 및 빠른 시작

독립 실행형

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

서버는 http://localhost:9377에서 실행됩니다. Camoufox(~300MB)는 첫 실행 시 자동으로 다운로드됩니다.

Docker

make up

Fly.io, Railway 및 멀티 아키텍처 빌드를 지원합니다.

OpenClaw 통합

openclaw plugins install @askjo/camofox-browser

사용 예시

새 탭 생성

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

접근성 스냅샷 + 스크린샷 가져오기

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

참조(ref)로 요소 클릭

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

매크로로 검색

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

사용 사례

믿을 수 있는 웹 브라우징이 필요한 AI 에이전트(연구, 쇼핑, 소셜 미디어 등)

Cloudflare나 Google 사이트에서 봇 방지 시스템 우회
가져온 쿠키를 이용한 인증 브라우징
장기 실행 에이전트 워크플로우에서 효율적인 토큰 사용을 통한 웹 상호작용

OpenClaw, Claude Desktop(MCP 통해), LangChain 및 커스텀 에이전트와의 통합

카모폭스 브라우저