TL;DR

camofox-browser는 Camoufox 기반의 독립형 stealth headless browser 서버로, AI 에이전트가 REST API를 통해 실제 웹을 탐색하도록 만듭니다. C++ 수준의 브라우저 지문 위조, accessibility snapshot, 안정적인 element ref, 세션 격리와 프록시 GeoIP 처리를 결합해 Playwright 기반 자동화가 차단되는 상황을 겨냥합니다. npm·Docker·Fly.io·Railway 배포와 OpenClaw 플러그인을 지원하고, YouTube 자막·검색 macro·다운로드·trace·Structured Extract 같은 에이전트용 기능을 제공합니다. 다만 Camoufox 바이너리 다운로드와 Firefox 실행 환경이 필요하며, 외부 공개 시 Bearer 인증·쿠키 보호·telemetry 설정을 별도로 점검해야 합니다.

핵심 포인트

• camofox-browser는 Camoufox를 기반으로 한 AI 에이전트용 독립형 브라우저 서버이자 REST API 도구입니다. Firefox를 C++ 구현 단계에서 수정해 navigator.hardwareConcurrency, WebGL, AudioContext, 화면 정보, WebRTC 지문을 JavaScript 노출 전에 위조하고 Playwright 대체 계층으로 동작합니다. OpenClaw에서는 @askjo/camofox-browser 플러그인으로 연결할 수 있으며, 일반 환경에서는 npm과 Docker로 별도 배포합니다.
• 원시 HTML 대신 약 90% 작은 accessibility snapshot과 e1, e2 형태의 안정적인 element ref를 반환해 에이전트의 클릭·입력·탐색 흐름을 단순화합니다. POST /tabs로 탭을 만들고 snapshot 조회, ref 기반 click·type, 검색 macro 실행, 스크린샷·다운로드·이미지 추출을 REST 호출로 이어갑니다. @google_search, @youtube_search, @amazon_search 등 사이트별 macro와 JSON Schema 기반 Structured Extract가 반복적인 웹 자동화 작업의 구현량을 줄입니다.
• 사용자별 BrowserContext를 분리해 cookies와 localStorage를 저장하고, 쿠키 파일 주입·VNC 로그인·프록시 GeoIP 동기화·파일 업로드를 지원합니다. 브라우저는 지연 실행되고 유휴 상태에서 종료되며 기본 설정상 메모리는 idle 시 약 40MB, 세션은 30분, 브라우저는 5분 동안 요청이 없으면 종료됩니다. Camoufox 바이너리는 설치 시 약 300MB를 내려받으므로 경량 REST 서버만 필요한 경우에도 브라우저 엔진 배포 공간과 실행 환경을 함께 확보해야 합니다.
• 실서비스 노출 전에는 보안 설정을 직접 구성해야 합니다. 서버는 기본적으로 모든 인터페이스에 바인딩될 수 있고, CAMOFOX_ACCESS_KEY가 설정되지 않으면 전역 Bearer 인증이 없으며, 익명화된 crash·hang telemetry도 기본 활성화되어 있습니다. CAMOFOX_ACCESS_KEY와 CAMOFOX_API_KEY를 설정하고 필요하면 CAMOFOX_BIND_HOST를 127.0.0.1로 제한하며, telemetry를 끄거나 자체 endpoint로 바꾸는 운영 검토가 필요합니다.