browser-use-oauth/README.md

3.2 KiB

환경 설정

요구 사항


oauth-backend 프록시를 사용한다면 이 가이드에 따라 인증서 또한 설정되어야만 합니다.

그렇지 않으면 실행되지 않습니다.

윈도우 환경에서는 sudo certutil -addstore root mitmproxy-ca-cert.cer로 인증합니다.

Sudo가 활성화되어있지 않은 환경에서는 관리자로 상향된 쉘에서 실행합니다.

MacOS 환경에서는 sudo security add-trusted-cert -d -p ssl -p basic -k /Library/Keychains/System.keychain ~/.mitmproxy/mitmproxy-ca-cert.pem으로 인증합니다.

다른 플렛폼은 수동으로 설정되어야만 합니다. https://docs.mitmproxy.org/stable/concepts/certificates/


uv 설치 후 다음과 같은 명령어를 입력합니다.

uv sync

venv와 패키지가 설치가 됩니다.


browser_use가 Playwright에 대한 의존성이 있어 브라우저 설치가 필요합니다

스텔스 기능 때문에 Google Chrome이 필요합니다.

만약 설치가 되어 있지 않다면

playwright install chrome

다음과 같은 명령어로 실행합니다.

uv run main.py

Environment는 .env.example에 따라 설정되어야합니다.

.env.example을 .env로 복사하여서 사용해주세요.

로그인 방안

쿠키와 로컬 스토리지 설정 방법 (추천)

1

uv run playwright open https://google.com/ --save-storage=./data/storage_state.json

위 명령어를 실행하면 playwright Browser가 하나 열리는데 여기서 원하는 프로바이더를 모두 로그인 한 후에 브라우저를 정상적으로 닫으면 ./data/storage_state.json 경로에 쿠키, 로컬스토리지를 저장한 파일이 생성됩니다.

Browser Use에게 직접 로그인 요청 (선택)

위에 쿠키와 로컬스토리지 설정 방법과 혼용해서 사용가능합니다.

.sensitive.example.json.sensitive.json으로 복사해서

안에 있는 예시 내용을 참고해서 작성해주시면 됩니다. 더 자세한 내용은 Sensitive Data - Browser Use를 참고하시면 좋을 것 같습니다.

Sensitive Data - Browser Use에서도 권장하지 않는 방법인만큼 애매하긴 하지만 쿠키와 로컬 스토리지를 저장하기 어려운 경우나 일부 flow에서 접근이 어려운 경우 사용해주세요.

실행

domains.txt는 실행시 자동으로 다운로드 됩니다.

curl "https://f.imnya.ng/.whs/tp-domains/data/domains/latest.txt" -o domains.txt
# uv run run.py {domains.txt 시작 줄} {domains.txt 끝 줄} {HTML 검사 Skip}
uv run run.py 12540 13000 False

참고하면 좋을만한 것