nicobailon/surf-cli

해결하는 문제

Surf는 AI 에이전트를 위한 번거로운 브라우저 자동화 문제를 해결합니다. 대부분의 기존 도구는 복잡한 설정이 필요하고, 특정 AI 제공업체에 묶여 있거나, 실제 웹 페이지에서 작동하지 않습니다. Surf는 모든 AI 에이전트(또는 셸 스크립트)가 Chrome을 제어할 수 있는 간단한 명령줄 인터페이스를 제공하며, 제로 구성이고 특정 AI 공급업체에 의존하지 않습니다.

작동 방식

Surf는 전역 npm 패키지와 브라우저 확장 프로그램으로 설치됩니다. 확장 프로그램은 네이티브 메시징 호스트에 연결되고, 호스트는 Unix 소켓을 통해 CLI와 통신합니다. 에이전트는 surf go, surf read, surf click, surf screenshot 같은 간단한 명령을 실행하여 페이지를 탐색하고 상호 작용합니다. 이 도구는 페이지의 접근성 트리를 읽어 안정적인 요소 참조 집합을 생성하고, iframe 전환, 의미론적 로케이터(역할, 텍스트 또는 레이블 기준)를 지원하며, 작업 후 스크린샷을 자동으로 캡처하여 왕복을 줄입니다. 또한 나중에 필터링하고 재생하기 위해 네트워크 요청을 캡처합니다. 원격 사용을 위해 Surf는 상호 Ed25519 인증과 함께 Tailscale을 통해 작동할 수 있으며, 리버스 프록시를 통한 TLS를 지원합니다. 브라우저의 기존 쿠키를 사용하여 ChatGPT, Gemini 등의 서비스에 질의할 수 있으므로 API 키가 필요 없습니다.

대상 사용자

Surf는 AI 에이전트, 자동화 파이프라인을 구축하는 개발자 또는 LLM 에이전트에 웹 브라우징 기능을 부여하려는 모든 사람을 위해 설계되었습니다. Claude Code, GPT, Gemini, Cursor, 사용자 정의 에이전트 또는 일반 셸 스크립트와도 작동합니다—명령을 실행할 수 있는 모든 것과 호환됩니다.

주요 기능

• 에이전트 비종속: 명령줄 명령을 실행할 수 있는 모든 도구와 작동, 공급업체 종속 없음.
• 제로 구성: 확장 프로그램 설치 후 명령 실행; MCP 서버나 릴레이 프로세스 불필요.
• 스마트 기본값: 토큰 절약을 위해 스크린샷을 자동으로 1200px로 크기 조정, 작업 후 자동 캡처.
• 네트워크 캡처: 모든 요청을 기록하고 필터링, 검색, 재생 기능 제공.
• 브라우저 쿠키로 AI 사용: API 키 없이 ChatGPT, Gemini, Perplexity, Grok에 질의 가능.
• 강력한 iframe 및 프레임 처리, 프레임 불일치 진단 포함.
• 강력한 Ed25519 인증과 선택적 TLS를 갖춘 Tailscale을 통한 원격 액세스.
• 다중 브라우저 지원: Chrome, Brave, Edge, Arc, Helium, Chromium(WSL2 포함).