브라우저 확장 프로그램 설정 가이드
CaptchaSonic 브라우저 확장 프로그램은 수동 브라우징이나 Selenium 같은 자동화 프레임워크 안에서 CAPTCHA를 푸는 가장 쉬운 방법입니다. 이 가이드는 지원되는 모든 브라우저의 설치와 설정을 다룹니다.
🚀 주요 기능
- 자동 풀이: 대부분의 주요 CAPTCHA 유형을 자동으로 감지하고 풀이를 시작합니다.
- 비표시 모드: 화면을 가리지 않고 백그라운드에서 동작합니다.
- 넓은 호환성: reCAPTCHA(v2/v3/Invisible), hCaptcha, GeeTest 등을 지원합니다.
- 차단 목록 지원: 자동 풀이를 끄고 싶은 특정 도메인을 지정할 수 있습니다.
1. 사전 준비
설치하기 전에 다음이 필요합니다:
- CaptchaSonic 계정.
- 대시보드에서 발급받은 API 키.
IMPORTANT
API 키는 비공개 정보입니다. 절대 다른 사람과 공유하거나 공개 저장소에 커밋하지 마세요.
2. 설치
Google Chrome용
확장 프로그램은 새로운 AI 모델로 자주 업데이트되므로, 최신 기능을 원하면 "unpacked" 버전 설치를 권장합니다.
- 스토어에서 설치: 가장 쉬운 방법입니다. Chrome 웹 스토어에서 바로 추가하세요.
또는 아직 출시되지 않은 최신 빌드를 원한다면:
- 다운로드: GitHub 릴리스에서 최신 확장 프로그램 ZIP을 받습니다.
- 압축 풀기: 내려받은 폴더를 드라이브의 고정된 위치에 압축 해제합니다.
- 확장 프로그램 관리: Chrome을 열고
chrome://extensions/로 이동합니다. - 개발자 모드: 오른쪽 상단의 Developer Mode 토글을 켭니다.
- 압축 해제된 항목 로드: Load unpacked 버튼을 클릭하고 압축 해제한 폴더를 선택합니다.

Mozilla Firefox용
- 스토어에서 설치: Firefox Add-ons에서 바로 추가하세요.
또는 .xpi 파일로 수동 설치할 수 있습니다:
- 다운로드: GitHub 릴리스에서
.xpi파일을 받습니다. - 부가 기능 메뉴: Firefox를 열고 메뉴 버튼(세 줄)을 클릭한 뒤 Add-ons and Themes를 선택합니다.
- 파일에서 설치: 관리 중인 확장 프로그램 위의 톱니바퀴 아이콘을 클릭하고 **Install Add-on From File...**을 선택합니다.
- 확인:
.xpi파일을 선택하고 Add를 클릭합니다.
3. 설정
설치가 끝나면 브라우저 도구 모음의 CaptchaSonic 아이콘을 클릭해 설정 팝업을 엽니다.
- 인증: 첫 번째 칸에 API Key를 붙여 넣고 Save를 클릭합니다.
- 모듈 활성화: 자동으로 풀고 싶은 CAPTCHA 유형을 켭니다.
- 고급 옵션:
- Solving Delay: 더 사람처럼 보이고 싶다면 지연 시간을 설정합니다.
- Auto-Submit: 챌린지가 풀리면 "Verify"를 자동으로 클릭합니다.

4. 사용법
이 확장 프로그램은 "한 번 설정하면 신경 쓸 필요 없는" 방식으로 설계되었습니다.
- 감지: CAPTCHA가 있는 페이지를 방문하면 확장 프로그램 아이콘의 상태가 바뀌어 챌린지를 찾았음을 알려 줍니다.
- 상태: CAPTCHA 위젯 근처에 작은 상태 배지가 나타나 풀이 진행 상황을 보여 줄 수 있습니다.
- 완료: 풀이가 끝나면 확장 프로그램이 결과 토큰을 입력하고, 설정되어 있다면 폼을 제출합니다.
5. 문제 해결 (FAQ)
Q: 확장 프로그램이 CAPTCHA를 풀지 않아요.
- A: 대시보드에서 크레딧이 충분한지 확인하세요. 설정에 API 키가 올바르게 붙여 넣어졌는지도 확인하세요.
Q: reCAPTCHA v3에서 "Low Score" 오류가 나요.
- A: reCAPTCHA v3는 브라우저 방문 기록과 IP 평판에 따라 달라집니다. 고품질 프록시를 사용하거나 브라우저 캐시를 지워 보세요.
Q: Chrome에서 확장 프로그램이 "손상됨"이라고 표시해요.
- A: 보통 확장 프로그램을 로드한 뒤 폴더를 옮겼을 때 발생합니다.
chrome://extensions/에서 확장 프로그램을 제거한 다음 "Load unpacked"를 다시 클릭하세요.
6. 지원
문제가 계속되면 공식 대시보드의 실시간 채팅으로 기술 팀에 문의하세요.
TIP
개발자 참고: 대량 스크레이핑을 하시나요? 처리량을 크게 높이려면 브라우저 확장 프로그램 대신 REST API를 사용하는 것을 고려하세요.