alchaincyf/huashu-chrome

해결하는 문제

AI 에이전트가 일반적으로 기존 로그인 상태, 쿠키 또는 개인 브라우저 기록에 접근할 수 없는 격리된 "깨끗한" 브라우저 세션에서 작동하는 한계를 해결합니다. MCP 호환 AI 에이전트가 실제 일상 사용 Chrome 브라우저를 제어할 수 있게 하여 양식 작성, 인증된 대시보드와 상호 작용, 이미 로그인한 사이트에서 데이터 스크래핑과 같은 작업을 가능하게 합니다.

작동 방식

AI 에이전트와 브라우저 사이의 브리지 역할을 하며 npm 패키지, CLI, MCP 서버, 로컬 브리지 프로세스, Chrome 확장 프로그램의 5가지 부분 아키텍처를 사용합니다. 명령을 내리면 에이전트는 MCP 서버를 통해 로컬 브리지와 통신하고, 브리지는 지침을 Chrome 확장 프로그램에 중계합니다. 확장 프로그램은 브라우저와 상호 작용하는 "손" 역할을 하여 에이전트에게 페이지의 구조화된 스냅샷(참조 번호가 있는 요소 사용)을 제공하고 작업을 실행합니다. 20개 이상의 웹사이트에 대한 내장 "사이트 지식"이 포함되어 에이전트가 일반적인 함정을 피하도록 돕고, 에이전트가 사이트별 패턴을 로컬에 학습하고 저장할 수 있게 합니다.

대상 사용자

이 프로젝트는 AI 코딩 에이전트(Claude Code, Cursor, Cline, Windsurf 등)를 사용하고 CRM 데이터 입력, 클라우드 콘솔 관리, 내부 웹 도구와의 상호 작용과 같이 인증이 필요한 브라우저 기반 워크플로를 자동화하려는 파워 유저와 개발자를 위한 것입니다.

주요 특징

• 실제 로그인 유지: 활성 Chrome 브라우저 내에서 직접 작동하므로 재인증이나 복잡한 로그인 흐름을 처리할 필요가 없습니다.
• 검증 우선 작업: 모든 쓰기 작업에는 에이전트가 페이지 변경 증거를 보고해야 합니다. 페이지가 예상대로 반응하지 않으면 에이전트는 중지하여 연쇄 오류를 방지합니다.
• 사이트별 인텔리전스: 20개 이상의 인기 사이트에 대한 사전 구성된 "경험" 노트가 포함되어 있으며 에이전트가 새 발견 사항을 로컬에 저장하여 향후 성능을 개선할 수 있습니다.
• 안전 중심 설계: 에이전트가 우회할 수 없는 결제용 필수 확인 UI 및 자동 민감 데이터 편집과 같은 보안 조치를 LLM 외부에 구현합니다.
• 광범위한 호환성: 20개 이상의 인기 AI 에이전트 및 CLI 도구에 대한 MCP 설정을 자동으로 감지하고 구성합니다.