Bin-Huang/camoufox-cli

해결하는 문제

AI 에이전트가 탐지를 피하면서 웹을 탐색할 수 있는 방법을 제공합니다. 많은 웹사이트가 핑거프린팅을 사용하여 자동화된 봇을 식별하고 차단하지만, 이 도구를 사용하면 에이전트가 하드웨어 및 소프트웨어 서명을 위조하고, 지속적인 ID를 유지하며, 단순화된 명령줄 인터페이스를 통해 페이지와 상호 작용함으로써 실제 인간 사용자를 모방할 수 있습니다.

작동 원리

이 도구는 Camoufox 브라우저를 감싸는 CLI 래퍼 역할을 합니다. Playwright를 통해 브라우저와 통신하는 Python 데몬을 사용합니다. AI 에이전트가 CLI로 셸 명령을 보내면, 이 명령이 데몬으로 전달되어 URL 이동, 요소 클릭, 스크린샷 촬영 등의 작업을 수행합니다. 탐지를 방지하기 위해 C++ 수준의 핑거프린트(canvas, WebGL, 오디오 포함)를 위조하며, 이러한 ID를 디스크에 저장할 수 있어 에이전트가 동일한 "장치"로 사이트에 다시 방문할 수 있습니다.

대상 사용자

웹 자동화, 데이터 추출 또는 엄격한 봇 방지 기능이 있는 웹사이트와의 상호 작용이 필요한 AI 에이전트(Claude Code, Cursor, OpenClaw와 같은 프레임워크 사용)를 구축하는 개발자.

주요 특징

• 안티 디텍션: canvas, WebGL, 오디오, 화면 메트릭 및 글꼴을 위조하여 봇 탐지를 우회합니다.
• 에이전트 친화적 상호 작용: 고유한 요소 참조 (@ref)가 포함된 접근성 트리 스냅샷을 사용하여 에이전트가 요소를 쉽게 타겟팅하고 클릭할 수 있습니다.
• ID 관리: 지속적인 핑거프린트와 쿠키를 지원하여 에이전트가 실행 간에도 안정적인 세션을 유지할 수 있습니다.
• 세션 격리: 서로 다른 핑거프린트와 프록시를 가진 여러 개의 격리된 브라우저 프로세스를 활성화하여 다중 계정 관리를 지원합니다.
• json 출력: --json 플래그를 통해 구조화된 데이터 추출을 제공하여 에이전트가 결과를 더 쉽게 파싱할 수 있도록 합니다.