Browser Automation Studio(BAS)는 시각적 자동화를 위한 강력한 도구입니다. CaptchaSonic은 BAS의 기본 CAPTCHA 풀이 액션을 통해 연동됩니다.

---

## 방법 1: 기본 제공 액션 (표준)

BAS는 기본적으로 2Captcha 프로토콜을 지원합니다. 이 요청을 우리 서버로 그대로 보내도록 설정하면 됩니다.

1.  BAS에서 **Settings**를 엽니다.
2.  **Captchas** 탭으로 이동합니다.
3.  **2Captcha** 서비스를 선택합니다.
4.  **API Key**를 입력합니다.
5.  **Server URL** 또는 **Host** 필드에 `api.captchasonic.com`을 입력합니다.

---

## 방법 2: CaptchaSonic 전용 모듈

GeeTest v4 풀이나 AWS WAF 토큰 생성 같은 고급 기능에는 전용 BAS 모듈을 제공합니다.

### 설치
1.  [Releases 페이지](https://github.com/Captcha-Sonic/BAS-Module)에서 `CaptchaSonic.bas` 모듈을 내려받습니다.
2.  BAS에서 **Project** -> **Module Manager** -> **Install from file**로 이동합니다.
3.  BAS를 재시작하여 새 액션을 불러옵니다.

### 모듈 액션 사용하기
모듈은 액션 목록에 "CaptchaSonic" 폴더를 추가하며, 다음 블록이 포함됩니다:
*   **Solve reCAPTCHA**: 사용자 지정 User-Agent를 지원하는 개선된 로직.
*   **Generate AWS Token**: 유효한 AWS WAF 쿠키를 바로 출력합니다.
*   **GeeTest 4 Solver**: 최신 슬라이드 CAPTCHA의 전체 핸드셰이크를 처리합니다.

---

## 사전 풀이
BAS에서는 사이트키를 알고 있다면 페이지로 이동하기 *전에* CAPTCHA를 푸는 편이 더 효율적인 경우가 많습니다. 브라우저 세션 전체 시간을 줄여 줍니다.

```bas
// Example Logic Flow
1. Fetch API Balance
2. Submit Task (SiteKey, URL)
3. Navigate to URL
4. Wait for Task Result
5. Inject Token into Hidden Input
6. Click Submit
```

---

## 자주 발생하는 문제

*   **대기 시간 초과**: BAS의 "Wait time"을 최소 60초(60000ms)로 설정하세요. AI 풀이는 빠르지만 네트워크 오버헤드가 있습니다.
*   **브라우저 핑거프린팅**: BAS 내부에서 확장 프로그램을 사용할 때는 브라우저 설정에서 "Enable Extensions"가 체크되어 있는지 확인하세요.

---

[BAS 모듈 v1.2.0 다운로드](#)
