eze-is/web-access

해결하는 문제

많은 AI 에이전트는 고급 웹 브라우징 기능이 부족하여, 동적 콘텐츠, 사용자 인증, 복잡한 상호작용을 처리할 수 없는 기본적인 검색 또는 가져오기 도구에 의존한다. 이 프로젝트는 AI 에이전트에 고급 웹 액세스, 브라우저 자동화, 전략적 브라우징 로직을 추가하는 포괄적인 '스킬'을 제공하여, 에이전트가 인간처럼 웹과 상호작용할 수 있도록 한다.

작동 방식

이 프로젝트는 WebSocket을 통해 사용자의 기존 브라우저(Chrome 또는 Edge)에 직접 연결하는 CDP(Chrome DevTools Protocol) 프록시를 구현한다. 이를 통해 에이전트는 사용자의 활성 로그인 세션과 쿠키를 활용할 수 있다. 새로운 탭 생성, 자바스크립트 실행, 실제 마우스 클릭 시뮬레이션, 파일 업로드, 스크린샷 캡처와 같은 작업을 수행할 수 있는 HTTP API 세트를 제공한다. 또한 find-url.mjs 스크립트를 포함하여, 로컬 브라우저 북마크와 기록을 검색하여 공개 검색이 불가능한 내부 페이지나 이전에 방문한 페이지의 URL을 찾을 수 있다.

대상 사용자

SKILL.md 표준을 지원하는 AI 에이전트(예: Claude Code, Cursor, Gemini CLI, Codex CLI)의 개발자 및 사용자로, 에이전트가 완전한 인증된 웹 브라우징 및 자동화 기능을 갖추기를 원하는 사람.

주요 특징

• CDP 프록시 통합: Chrome 또는 Edge에 연결하여 기존 로그인 상태를 활용하고 동적 페이지를 처리한다.
• 자동 도구 선택: 상황에 따라 WebSearch, WebFetch, curl, Jina, CDP 중 하나를 자동으로 선택한다.
• 로컬 리소스 검색: 로컬 브라우저 기록과 북마크를 검색하여 공개 검색이 불가능한 URL을 찾는다.
• 병렬 실행: 단일 프록시를 공유하면서 여러 타겟을 병렬로 연구할 수 있는 하위 에이전트를 디스패치할 수 있다.
• 사이트 경험 축적: 세션 간에 도메인별로 URL 패턴, 플랫폼 특성 등을 저장하고 재사용한다.
• 고급 상호작용: JS 클릭, 실제 마우스 이벤트, 파일 업로드를 지원한다.