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:9377Docker:
make up기술 스택
| 구성요소 | 기술 |
|---|---|
| 언어 | JavaScript 91.2%, TypeScript 7.3% |
| 엔진 | Camoufox (Firefox fork, C++ 패치) |
| API | REST (포트 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 트랜스크립트 추출)