CaptchaSonic 브라우저 확장 프로그램은 수동 브라우징이나 Selenium 같은 자동화 프레임워크 안에서 CAPTCHA를 푸는 가장 쉬운 방법입니다. 이 가이드는 지원되는 모든 브라우저의 설치와 설정을 다룹니다.

---

## 🚀 주요 기능

*   **자동 풀이**: 대부분의 주요 CAPTCHA 유형을 자동으로 감지하고 풀이를 시작합니다.
*   **비표시 모드**: 화면을 가리지 않고 백그라운드에서 동작합니다.
*   **넓은 호환성**: reCAPTCHA(v2/v3/Invisible), hCaptcha, GeeTest 등을 지원합니다.
*   **차단 목록 지원**: 자동 풀이를 끄고 싶은 특정 도메인을 지정할 수 있습니다.

---

## 1. 사전 준비

설치하기 전에 다음이 필요합니다:
1.  [CaptchaSonic 계정](https://captchasonic.com).
2.  [대시보드](https://captchasonic.com/app)에서 발급받은 **API 키**.

> [!IMPORTANT]
> API 키는 비공개 정보입니다. 절대 다른 사람과 공유하거나 공개 저장소에 커밋하지 마세요.

---

## 2. 설치

### Google Chrome용

확장 프로그램은 새로운 AI 모델로 자주 업데이트되므로, 최신 기능을 원하면 "unpacked" 버전 설치를 권장합니다.

1.  **스토어에서 설치**: 가장 쉬운 방법입니다. [Chrome 웹 스토어](https://chromewebstore.google.com/detail/captchasonic-automatic-ca/dkkdakdkffippajmebplgnpmijmnejlh)에서 바로 추가하세요.

또는 아직 출시되지 않은 최신 빌드를 원한다면:

1.  **다운로드**: [GitHub 릴리스](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest)에서 최신 확장 프로그램 ZIP을 받습니다.
2.  **압축 풀기**: 내려받은 폴더를 드라이브의 고정된 위치에 압축 해제합니다.
3.  **확장 프로그램 관리**: Chrome을 열고 `chrome://extensions/`로 이동합니다.
4.  **개발자 모드**: 오른쪽 상단의 **Developer Mode** 토글을 켭니다.
5.  **압축 해제된 항목 로드**: **Load unpacked** 버튼을 클릭하고 압축 해제한 폴더를 선택합니다.

![Chrome 확장 프로그램 설정 단계](/guides/BE/guide.7.png)

### Mozilla Firefox용

1.  **스토어에서 설치**: [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/captchasonic/)에서 바로 추가하세요.

또는 `.xpi` 파일로 수동 설치할 수 있습니다:

1.  **다운로드**: [GitHub 릴리스](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest)에서 `.xpi` 파일을 받습니다.
2.  **부가 기능 메뉴**: Firefox를 열고 메뉴 버튼(세 줄)을 클릭한 뒤 **Add-ons and Themes**를 선택합니다.
3.  **파일에서 설치**: 관리 중인 확장 프로그램 위의 톱니바퀴 아이콘을 클릭하고 **Install Add-on From File...**을 선택합니다.
4.  **확인**: `.xpi` 파일을 선택하고 **Add**를 클릭합니다.

---

## 3. 설정

설치가 끝나면 브라우저 도구 모음의 CaptchaSonic 아이콘을 클릭해 설정 팝업을 엽니다.

1.  **인증**: 첫 번째 칸에 **API Key**를 붙여 넣고 **Save**를 클릭합니다.
2.  **모듈 활성화**: 자동으로 풀고 싶은 CAPTCHA 유형을 켭니다.
3.  **고급 옵션**:
    *   **Solving Delay**: 더 사람처럼 보이고 싶다면 지연 시간을 설정합니다.
    *   **Auto-Submit**: 챌린지가 풀리면 "Verify"를 자동으로 클릭합니다.

![확장 프로그램 설정 UI](/guides/BE/guide.17.png)

---

## 4. 사용법

이 확장 프로그램은 "한 번 설정하면 신경 쓸 필요 없는" 방식으로 설계되었습니다.

*   **감지**: CAPTCHA가 있는 페이지를 방문하면 확장 프로그램 아이콘의 상태가 바뀌어 챌린지를 찾았음을 알려 줍니다.
*   **상태**: CAPTCHA 위젯 근처에 작은 상태 배지가 나타나 풀이 진행 상황을 보여 줄 수 있습니다.
*   **완료**: 풀이가 끝나면 확장 프로그램이 결과 토큰을 입력하고, 설정되어 있다면 폼을 제출합니다.

---

## 5. 문제 해결 (FAQ)

**Q: 확장 프로그램이 CAPTCHA를 풀지 않아요.**
*   A: [대시보드](https://captchasonic.com/app)에서 크레딧이 충분한지 확인하세요. 설정에 API 키가 올바르게 붙여 넣어졌는지도 확인하세요.

**Q: reCAPTCHA v3에서 "Low Score" 오류가 나요.**
*   A: reCAPTCHA v3는 브라우저 방문 기록과 IP 평판에 따라 달라집니다. 고품질 프록시를 사용하거나 브라우저 캐시를 지워 보세요.

**Q: Chrome에서 확장 프로그램이 "손상됨"이라고 표시해요.**
*   A: 보통 확장 프로그램을 로드한 뒤 폴더를 옮겼을 때 발생합니다. `chrome://extensions/`에서 확장 프로그램을 제거한 다음 "Load unpacked"를 다시 클릭하세요.

---

## 6. 지원

문제가 계속되면 [공식 대시보드](https://captchasonic.com/app)의 실시간 채팅으로 기술 팀에 문의하세요.

---

> [!TIP]
> **개발자 참고**: 대량 스크레이핑을 하시나요? 처리량을 크게 높이려면 브라우저 확장 프로그램 대신 [REST API](/docs/api)를 사용하는 것을 고려하세요.
