웹 스크래핑과 AI 에이전트를 위한 오픈소스 안티디텍트 브라우저
중간맛 분석
스택: C++와 Python (Playwright 호환). 난이도: 중급 이상. 바로 쓸 수 있나: 네. pip로 설치 후 Playwright 코드의 브라우저 초기화만 바꾸면 됩니다. 핵심 기능: 지문 속성 위장(네비게이터·WebGL·WebRTC·오디오·위치정보), 헤드리스 탐지 우회, 시스템 폰트 자동 매칭, 플레이라이트 기본 지원. 주의: 아직 개발 중이므로 안정적인 프로덕션 사용에는 미흡할 수 있습니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 대규모 웹 스크래핑 프로젝트에서 Bot 탐지 우회
- AI 에이전트의 자동화된 웹 상호작용
- 광고 검증 및 가격 모니터링 자동화
핵심 기능
대안 대비 차별점
Firefox 엔진 기반으로 Chrome 대체 도구들과 달리 최신 Playwright API와 실제 야생 지문 프리셋을 기본 제공하며, 하드웨어 스푸핑과 프리셋 기반 검증 우회에 특화되어 있습니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Python 3.7+
- 가상환경 (권장)
- Firefox 브라우저 호환성
바로 차려먹기Docker
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/daijro/camoufox.git && cd camoufox && docker build -t camoufox . && docker run --rm -it camoufox
Docker가 필요해요 — 맥이라면 OrbStack(brew install --cask orbstack)을 추천해요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- 가상환경을 만들고 기본 패키지를 설치합니다.
pip install camoufox
- 동기 API를 사용하여 브라우저 인스턴스를 생성하고 페이지를 엽니다.
python3 << 'EOF'
from camoufox.sync_api import Camoufox
with Camoufox() as browser:
page = browser.new_page()
page.goto("https://example.com")
print(page.title())
EOF
- 최신 프리릴리스 브라우저와 하드웨어 스푸핑을 원한다면 별도 패키지를 설치합니다.
pip install cloverlabs-camoufox
- 최신 프리릴리스 브라우저를 다운로드합니다.
python -m camoufox sync
python -m camoufox set official/prerelease
python -m camoufox fetch
- 비동기 API로 사용합니다 (Playwright와 동일한 구문).
python3 << 'EOF'
import asyncio
from camoufox.async_api import AsyncCamoufox
async def main():
async with AsyncCamoufox() as browser:
page = await browser.new_page()
await page.goto("https://example.com")
print(await page.title())
asyncio.run(main())
EOF
- (선택사항) 실제 지문 프리셋을 활성화하여 더 강력한 회피를 구성합니다.
python3 << 'EOF'
from camoufox.sync_api import Camoufox
with Camoufox(fingerprint_preset=True, os="macos") as browser:
page = browser.new_page()
page.goto("https://example.com")
EOF
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try daijro/camoufox
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2024년 생성
「데이터·크롤링」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/daijro/camoufox)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기