eze-is/web-access

해결하는 문제

Web-Access는 AI 에이전트에게 포괄적인 웹 연결성 및 브라우저 자동화 기능을 제공합니다. 이 도구는 기본적인 웹 검색 및 가져오기 도구의 한계를 해결하며, 스케줄링 전략, Chrome DevTools Protocol(CDP)을 통한 직접적인 브라우저 제어, 그리고 향후 상호작용을 개선하기 위해 사이트별 운영 경험을 축적하는 기능을 추가합니다.

작동 방식

이 프로젝트는 WebSocket을 통해 사용자의 기존 브라우저(Chrome 또는 Edge)에 직접 연결되는 CDP 프록시를 구현합니다. 이를 통해 에이전트는 사용자의 활성 세션 내에서 작동하며, 로그인 상태를 상속받고 동적 콘텐츠를 처리할 수 있습니다. 에이전트가 새 탭 생성, JavaScript 실행, 실제 마우스 클릭 시뮬레이션, 파일 업로드, 스크린샷 촬영 등의 작업을 수행할 수 있도록 일련의 HTTP API를 제공합니다. 또한 시스템에는 내부 또는 이전에 방문한 URL을 찾기 위해 로컬 브라우저 북마크와 기록을 검색하는 메커니즘이 포함되어 있습니다.

대상 사용자

SKILL.md 형식을 지원하는 AI 에이전트(Claude Code, Cursor, Gemini CLI, Codex CLI 등)의 개발자 및 사용자로, 에이전트가 사람과 같은 완전한 웹 브라우징 및 상호작용 기능을 갖추기를 원하는 경우 적합합니다.

주요 특징

• CDP 프록시 통합: Chrome 또는 Edge에 연결하여 기존 로그인 세션을 사용하고 동적 페이지를 처리합니다.
• 자동 도구 선택: 시나리오에 따라 WebSearch, WebFetch, curl, Jina, CDP 중에서 지능적으로 선택합니다.
• 로컬 리소스 검색: 로컬 브라우저 북마크와 기록을 검색하여 공개 웹에서 찾을 수 없는 URL을 찾을 수 있습니다.
• 사이트 경험 축적: 도메인별로 세션 전반에 걸쳐 운영 경험(URL 패턴, 플랫폼 특성)을 저장하고 재사용합니다.
• 병렬 실행: 탭 수준의 격리를 통해 여러 대상에 대해 병렬 조사를 수행하도록 하위 에이전트를 파견하는 기능을 지원합니다.
• 고급 상호작용: 여러 클릭 방식(JS 클릭 및 실제 마우스 이벤트)과 파일 업로드를 지원합니다.