mirror of
https://github.com/j93es/browser-use-oauth.git
synced 2026-06-04 08:01:51 +09:00
imnyang
4b3637b762
- README.md: uv 실행 명령어 수정 - lib/llm/prompt: OAuth 리스트 추출 및 fallback 프롬프트 추가 - lib/utils/browser_use: 프로필 생성 시 스토리지 상태 파일 처리 개선 - lib/utils/browser_use/func: 안전한 JSON 읽기 및 쓰기 함수 추가 - main.py: OAuth 리스트 추출 및 개별 로그인 시도 통합 - model.py: OAuth 모델 수정
106 lines
3.3 KiB
Markdown
106 lines
3.3 KiB
Markdown
# 환경 설정
|
|
|
|
요구 사항
|
|
- [uv](https://docs.astral.sh/uv/getting-started/installation/) - Python Package Manager Written by Rust
|
|
- [oauth-backend](https://github.com/j93es/oauth-backend)
|
|
- [Google Chrome](https://www.google.com/intl/ko_kr/chrome/)
|
|
|
|
---
|
|
|
|
> [oauth-backend](https://github.com/j93es/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/
|
|
|
|
|
|
---
|
|
다음과 같은 명령어로 환경을 설정합니다.
|
|
|
|
설명하는 가이드를 잘 따라가면 설정할 수 있습니다.
|
|
|
|
```sh
|
|
uv run setup.py
|
|
```
|
|
|
|
|
|
<details>
|
|
<summary>설치 및 설정 (레거시)</summary>
|
|
|
|
uv 설치 후 다음과 같은 명령어를 입력합니다.
|
|
|
|
```sh
|
|
uv sync
|
|
```
|
|
|
|
venv와 패키지가 설치가 됩니다.
|
|
|
|
---
|
|
|
|
~~browser_use가 Playwright에 대한 의존성이 있어 브라우저 설치가 필요합니다~~
|
|
|
|
스텔스 기능 때문에 Google Chrome이 필요합니다.
|
|
|
|
만약 설치가 되어 있지 않다면
|
|
```
|
|
playwright install chrome
|
|
```
|
|
|
|
Environment는 .env.example에 따라 설정되어야합니다.
|
|
|
|
.env.example을 .env로 복사하여서 사용해주세요.
|
|
|
|
## 로그인 방안
|
|
|
|
### 쿠키와 로컬 스토리지 설정 방법 (추천)
|
|
|
|
|
|
|
|
```sh
|
|
uv run playwright open https://google.com/ --save-storage=./data/storage_state.json
|
|
```
|
|
|
|
위 명령어를 실행하면 playwright Browser가 하나 열리는데 여기서 원하는 프로바이더를 모두 로그인 한 후에 브라우저를 정상적으로 닫으면 ./data/storage_state.json 경로에 쿠키, 로컬스토리지를 저장한 파일이 생성됩니다.
|
|
|
|
### Browser Use에게 직접 로그인 요청 (선택)
|
|
<details>
|
|
위에 쿠키와 로컬스토리지 설정 방법과 혼용해서 사용가능합니다.
|
|
|
|
`.sensitive.example.json`을 `.sensitive.json`으로 복사해서
|
|
|
|
안에 있는 예시 내용을 참고해서 작성해주시면 됩니다.
|
|
더 자세한 내용은
|
|
[Sensitive Data - Browser Use](https://docs.browser-use.com/customize/sensitive-data)를 참고하시면 좋을 것 같습니다.
|
|
|
|
[Sensitive Data - Browser Use](https://docs.browser-use.com/customize/sensitive-data)에서도 권장하지 않는 방법인만큼 애매하긴 하지만 쿠키와 로컬 스토리지를 저장하기 어려운 경우나 일부 flow에서 접근이 어려운 경우 사용해주세요.
|
|
</details>
|
|
|
|
</details>
|
|
|
|
---
|
|
|
|
|
|
# 실행
|
|
|
|
domains.txt는 실행시 자동으로 다운로드 됩니다.
|
|
|
|
```sh
|
|
curl "https://f.imnya.ng/.whs/tp-domains/data/domains/latest.txt" -o domains.txt
|
|
```
|
|
|
|
```sh
|
|
# uv run run.py {domains.txt 시작 줄} {domains.txt 끝 줄} {--skh}
|
|
uv run run.py 1 100 --skh
|
|
```
|
|
|
|
# 참고하면 좋을만한 것
|
|
|
|
- [ ] 일부 웹사이트는 사용자의 언어에 따라 OAuth 옵션을 바꾸기도 합니다.
|
|
- [ ] https://docs.browser-use.com/customize/custom-functions
|