Camofox Browser

AI 에이전트용 안티 디텍션 브라우저 서버. Camoufox(Firefox 포크, C++ 수준 지문 스푸핑) 기반 REST API.

개요

Playwright가 차단되고, Headless Chrome이 지문 감지되는 환경에서 AI 에이전트가 실제 웹을 탐색할 수 있도록 설계된 브라우저 자동화 서버. Camoufox는 Firefox를 C++ 구현 수준에서 패치하여 navigator.hardwareConcurrency, WebGL 렌더러, AudioContext, 화면 기하학, WebRTC 등을 모두 스푸핑한다.

핵심 기능

  • C++ 수준 안티 디텍션 (Google, Cloudflare, 대부분의 봇 탐지 우회)
  • 안정적인 엘리먼트 참조 (e1, e2, e3 형식)
  • 접근성 스냅샷 (raw HTML 대비 ~90% 크기 절감)
  • 세션 격리 (사용자별 쿠키/스토리지 분리)
  • 쿠키 임포트 (Netscape 포맷)
  • 프록시 + GeoIP 지원
  • YouTube 트랜스크립트 추출 (yt-dlp)
  • 검색 매크로 (@google_search, @youtube_search, @amazon_search 등 14개)
  • 스냅샷 스크린샷, 다운로드 캡처, DOM 이미지 추출
  • 대형 페이지 자동 트렁케이션 + 오프셋 기반 페이지네이션
  • Docker, Fly.io, Railway 배포 지원
  • 유휴 시 ~40MB 메모리 사용

설치

git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser
npm install && npm start
# → http://localhost:9377

Docker:

make up

기술 스택

구성요소기술
언어JavaScript 91.2%, TypeScript 7.3%
엔진Camoufox (Firefox fork, C++ 패치)
APIREST (포트 9377)
배포Docker, Fly.io, Railway

프로젝트 정보

  • Stars: 1,520 | Forks: 157
  • License: MIT
  • Created: 2026-01-26 | Latest: v1.5.0 (2026-04-06)
  • Contributors: 9

관련 프로젝트

  • 2026-04-11-reclip — 동일하게 yt-dlp 활용 (YouTube 트랜스크립트 추출)

Sources