Custos AI

About

Custos AI는 AI 에이전트와 연동하여 온라인 쇼핑몰의 상품 검색부터
옵션 선택, 결제까지의 전 과정을 자동으로 처리해주는 브라우저 자동화
확장프로그램입니다.


■ 주요 기능

• AI 에이전트 실시간 연동
  백엔드 AI 에이전트로부터 지시를 실시간으로 수신하여 클릭, 텍스트
  입력, 페이지 이동, 스크롤 등의 동작을 순서대로 실행합니다.

• 지원 쇼핑몰
  알리익스프레스, 네이버쇼핑을 지원합니다.

• 사람처럼 동작하는 입력 처리
  Chrome DevTools Protocol(CDP)을 통해 마우스 클릭과 키보드 입력을
  OS 수준의 실제 입력으로 처리합니다. 일반 스크립트 방식으로는
  동작하지 않는 결제 팝업, 새 탭 열기 등이 정상적으로 작동합니다.

• 실시간 상태 모니터링
  사이드 패널에서 현재 실행 중인 단계, 진행 상태, 실시간 로그를
  확인할 수 있습니다.

• 캡챠 감지 및 수동 재개
  캡챠가 감지되면 자동화를 일시 중단하고 사용자에게 알립니다.
  캡챠 해결 후 버튼 한 번으로 자동화를 재개할 수 있으며, 네이버
  캡챠처럼 해결 후 리다이렉트가 발생하는 경우 자동으로 감지하여
  재개합니다.

• 중단 복구
  브라우저 재시작이나 네트워크 오류로 중단된 작업을 자동으로
  복구합니다.


■ 사용 방법

1. 확장프로그램 아이콘을 클릭해 사이드 패널을 엽니다.
2. Custos AI 웹 서비스에 로그인한 뒤 디바이스 페어링을 완료합니다.
3. AI 에이전트에게 구매할 상품을 지시하면 확장프로그램이 실시간으로
   쇼핑몰을 자동 조작합니다.
4. 결제 전 승인이 필요한 경우 사이드 패널에서 확인 후 진행합니다.


■ 권한 사용 목적

• 디버거 (debugger)
  쇼핑몰에서의 클릭, 텍스트 입력, 결제 진행을 실제 사용자 입력처럼
  처리하기 위해 Chrome DevTools Protocol(CDP)을 사용합니다.
  일반 스크립트(scripting) 방식으로는 User Activation이 필요한
  결제 팝업이나 새 탭 열기가 동작하지 않기 때문입니다.
  디버거는 각 동작이 실행되는 순간에만 연결되며 완료 즉시 해제됩니다.

• 모든 사이트 접근 (<all_urls>)
  알리익스프레스와 네이버쇼핑을 지원하며, 서버에서 허용 도메인
  목록을 동적으로 수신하여 해당 도메인에서만 자동화가 동작합니다.
  서버 설정에 따라 지원 도메인이 추가될 수 있어 이 권한이 필요합니다.

• 저장소 및 알람 (storage, alarms)
  디바이스 인증 정보와 실행 상태를 로컬에 저장하고, 주기적으로
  서버와 연결 상태를 확인하는 데 사용합니다.

• 사이드 패널, 탭, 스크립팅, 알림
  (sidePanel, tabs, scripting, notifications)
  실시간 상태 패널 표시, 탭 관리, 페이지 상태 수집, 사용자 알림에
  사용합니다.