Bin-Huang/camoufox-cli

해결하는 문제

camoufox-cli는 AI 에이전트가 봇으로 감지되지 않고 웹을 탐색할 수 있도록 해주는 앤티디텍트 브라우저의 명령줄 인터페이스를 제공합니다. 이 도구는 C++ 수준에서 하드웨어 및 소프트웨어 지문(예: canvas, WebGL, 오디오 등)을 위조함으로써 봇 탐지 문제를 해결하며, 브라우저가 실제 인간 사용자처럼 보이게 합니다.

작동 방식

이 도구는 Unix 소켓을 통해 Python 데몬과 통신하는 CLI로 작동합니다. 이 데몬은 Playwright를 통해 Camoufox(Firefox 기반) 브라우저 인스턴스를 관리합니다. 에이전트는 요소에 참조 ID(예: @e1)를 할당한 간소화된 접근성 트리 스냅샷 시스템을 사용하여 페이지와 상호작용할 수 있으며, 이를 통해 클릭, 폼 채우기, 텍스트 추출이 가능합니다.

대상 사용자

AI 에이전트(Claude Code, Cursor, OpenClaw 등) 및 피ン거프린트와 봇 탐지 시스템을 회피하면서 브라우저 작업을 자동화해야 하는 개발자들.

주요 기능

• C++ 수준의 지문 위조: canvas, WebGL, 오디오, 화면 메트릭스, 폰트를 위조하여 탐지 회피.
• 지속적인 정체성: 프로필 경로에 지문, OS, 로케일을 저장하여 다양한 세션 간 동일한 정체성 유지.
• 에이전트 친화적 상호작용: @ref를 통한 요소 타겟팅을 사용한 접근성 트리 스냅샷으로 간편한 탐색 및 상호작용.
• 세션 및 탭 격리: 별도의 브라우저 프로세스를 사용하는 여러 이름 붙인 세션과 공유 브라우저 프로세스를 사용하는 이름 붙인 탭을 지원하여 병렬 작업 가능.
• 쿠키 관리: 세션 지속성을 위해 JSON 형식으로 쿠키를 가져오거나 내보낼 수 있음.
• 프록시 및 GeoIP 지원: 프록시 IP 기반으로 자동 GeoIP 위조를 지원하는 통합 프록시 기능.