설치 및 ApiServer 구성
첫 번째 Selenium 코드를 작성하기 전에 세 가지를 준비해야 합니다: Python 환경, Selenium 라이브러리, 그리고 Mbbrowser ApiServer입니다. 이 과정은 약 10분 정도 소요됩니다.
1단계: Python 설치
Selenium의 Python 바인딩을 사용하려면 Python 3.8 이상이 필요합니다.
다운로드 및 설치
- Python 공식 웹사이트에서 3.10 또는 3.11 LTS 버전을 다운로드합니다 (권장).
- 설치 중에 반드시 다음 항목을 체크하십시오:
✅ Add Python to PATH (이 설정을 누락하면 모든 후속 명령에서 오류가 발생합니다!) - 설치가 완료되면 **명령 프롬프트(CMD)**를 열어 확인합니다.
python --version # Python 3.10.x 이상이 출력되어야 합니다.
pip --version # pip 버전 정보가 출력되어야 합니다.NOTE
Windows에서 python 명령이 작동하지 않는 경우, Python 설치 디렉토리(예: C:\Python310\ 및 C:\Python310\Scripts\)를 시스템 환경 변수 → Path에 수동으로 추가하십시오.
2단계: Selenium 라이브러리 설치
CMD 또는 PowerShell에서 다음 명령을 실행합니다.
pip install selenium requestsselenium: 핵심 자동화 라이브러리입니다.requests: Mbbrowser ApiServer의 HTTP 인터페이스를 호출하는 데 사용됩니다.
ChromeDriver에 대하여 (중요!)
Selenium 4.6 이상에는 Selenium Manager가 포함되어 있어, Mbbrowser 커널 버전과 일치하는 ChromeDriver를 자동으로 다운로드합니다.
하지만 Mbbrowser는 커스텀 크롬 커널을 사용하므로 버전이 공식 크롬과 다를 수 있습니다. 다음 단계 중 하나를 따르세요.
방법 A (권장): Mbbrowser 설치 디렉토리에 포함된 chromedriver 사용
Mbbrowser 설치 디렉토리 내에 보통 chromedriver.exe가 있으며, 경로는 다음과 비슷합니다:
C:\Program Files (x86)\Mbbrowser_vX.X.X\chromedriver.exe코드에서 이 경로를 직접 지정해 주면 됩니다 (다음 장에서 자세히 설명).
방법 B: 수동 다운로드
- Mbbrowser 클라이언트에 로그인하여 "도움말 → 정보"로 이동한 뒤 커널 버전(예: Chrome 140)을 확인합니다.
- Chrome for Testing에서 동일한 버전의 chromedriver를 다운로드합니다.
chromedriver.exe를 프로젝트 디렉토리나 PATH에 둡니다.
3단계: Mbbrowser ApiServer 활성화
Mbbrowser는 ApiServer.exe를 통해 외부 스크립트에 인터페이스를 노출합니다.
IMPORTANT
스크립트가 Mbbrowser와 통신하려면 먼저 ApiServer가 활성화되어 있어야 합니다! ApiServer 터미널 창을 닫지 마십시오.
API 인증 정보 가져오기
- Mbbrowser 클라이언트를 열고 로그인이 되어 있는지 확인합니다.
- 왼쪽 상단 메뉴 → 개인 센터 → API 설정으로 이동합니다.
- 자신의
APP_ID와APP_KEY를 확인합니다 (없다면 "생성" 클릭).
ApiServer 시작
관리자 권한으로 CMD를 열고 Mbbrowser 설치 디렉토리로 이동하여 다음을 실행합니다.
apiserver.exe --port=8186 --app_id=사용자_APP_ID --app_key=사용자_APP_KEY --hide=off매개변수 설명:
| 매개변수 | 의미 | 기본값 |
|---|---|---|
--port | ApiServer가 수신 대기할 포트 | 8186 |
--app_id | 사용자 인증 ID (개인 센터 정보) | - |
--app_key | 사용자 인증 키 | - |
--hide=off | off는 브라우저 창이 보이고, on은 탐지 방지 모드(Headless와 유사) | off |
성공적으로 시작되면 CMD 창에 다음과 같이 표시됩니다.
ApiServer started at http://127.0.0.1:8186ApiServer 상태 확인
브라우저나 Postman에서 http://127.0.0.1:8186/에 접속해 보세요. API 문서 페이지가 보인다면 정상적으로 실행된 것입니다.
4단계: 환경 Session_ID 확인
각 Mbbrowser 환경은 고유한 Session_ID(32자리 16진수 문자열, 예: 373808cb37bd63f5f7d92415e736e85f)를 가지고 있습니다.
확인 방법:
- Mbbrowser 메인 패널에서 조작하려는 환경을 찾습니다.
- 환경을 마우스 오른쪽 버튼으로 클릭하고 **환경 ID 복사 (Copy Environment ID / Session_ID)**를 선택합니다.
5단계: 권장 프로젝트 구조
컴퓨터에 다음과 같이 명확한 프로젝트 폴더를 생성하는 것을 추천합니다.
my-mbbrowser-selenium/
├── start_selenium.py ← 메인 스크립트
├── config.py ← 설정 파일 (API_URL, SESSION_ID 등 저장)
├── utils.py ← 공통 유틸리티 함수 (환경 시작, 스크린샷 등)
└── requirements.txt ← 의존성 목록requirements.txt 내용:
selenium>=4.15.0
requests>=2.31.0다른 팀원들은 다음 명령으로 의존성을 쉽게 설치할 수 있습니다:
pip install -r requirements.txt환경 설정 체크리스트
다음 장으로 넘어가기 위해 아래 사항을 확인하십시오.
- [ ] Python 3.8 이상이 설치되었고
python --version이 정상 출력되는가? - [ ]
pip install selenium requests가 완료되었는가? - [ ] Mbbrowser 디렉토리 내의
chromedriver.exe경로를 확인했는가? - [ ] ApiServer가 시작되었고
http://127.0.0.1:8186/에 접속 가능한가? - [ ] 대상 환경의
Session_ID를 확인했는가?
TIP
준비되셨나요? 다음 장 빠른 시작: 연결하기에서 첫 번째 기능 스크립트를 작성해 봅니다!