브라우저 자동화 MCP 서버

🤖 브라우저 자동화 에이전트

MCP(모델 제어 프로그램) 기반으로 구축된 강력한 브라우저 자동화 도구로, 웹 스크래핑 기능과 LLM 기반 인텔리전스를 결합했습니다. 이 에이전트는 Google 검색, 웹페이지 탐색, GitHub, Stack Overflow, 문서 사이트 등 다양한 웹사이트의 콘텐츠를 지능적으로 스크래핑할 수 있습니다.

🚀 특징

🔍 Google 검색 통합 : 모든 쿼리에 대한 상위 검색 결과를 찾아 검색합니다.
🕸️ 지능형 웹 스크래핑 : 다양한 웹사이트 유형에 맞는 맞춤형 스크래핑 전략:
- 📂 GitHub 저장소
- 💬 Stack Overflow 질문과 답변
- 📚 문서 페이지
- 🌐 일반 웹사이트
🧠 AI 기반 처리 : 스크래핑된 콘텐츠를 이해하고 처리하기 위해 Mistral AI를 사용합니다.
🥷 스텔스 모드 : 감지를 피하기 위해 브라우저 지문 보호 기능을 구현합니다.
💾 콘텐츠 저장 : 스크래핑된 페이지의 스크린샷과 텍스트 콘텐츠를 자동으로 저장합니다.

🏗️ 건축

이 프로젝트는 MCP로 구동되는 클라이언트-서버 아키텍처를 사용합니다.

🖥️ 서버 : 브라우저 자동화 및 웹 스크래핑 작업을 처리합니다.
👤 클라이언트 : Mistral AI와 LangGraph를 사용하여 AI 인터페이스를 제공합니다.
📡 통신 : 클라이언트-서버 통신을 위해 stdio를 사용합니다.

⚙️ 요구 사항

🐍 파이썬 3.8 이상
🎭 극작가
🧩 MCP(모델 제어 프로그램)
🔑 미스트랄 AI API 키

📥 설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

pip install -r requirements.txt

Playwright 브라우저 설치:

playwright install

프로젝트 루트에 .env 파일을 만들고 Mistral AI API 키를 추가하세요.

MISTRAL_API_KEY=your_api_key_here

📋 사용법

서버 실행

python main.py

클라이언트 실행

python client.py

샘플 상호작용

서버와 클라이언트가 모두 실행되면:

메시지가 표시되면 쿼리를 입력하세요
에이전트는 다음을 수행합니다.
- 🔍 관련 결과를 Google에서 검색하세요
- 🧭 상위 결과로 이동
- 📊 웹사이트 유형에 따라 콘텐츠 스크래핑
- 📸 스크린샷과 콘텐츠를 파일에 저장하세요
- 📤 처리된 정보를 반환합니다

🛠️ 도구 기능

`get_top_google_url`

🔍 Google에서 검색하여 주어진 쿼리에 대한 최상위 결과 URL을 반환합니다.

`browse_and_scrape`

🌐 URL로 이동하여 웹사이트 유형에 따라 콘텐츠를 스크래핑합니다.

`scrape_github`

📂 GitHub 저장소에서 README 콘텐츠와 코드 블록을 추출하는 데 특화되어 있습니다.

`scrape_stackoverflow`

💬 Stack Overflow 페이지에서 질문, 답변, 댓글 및 코드 블록을 추출합니다.

`scrape_documentation`

📚 문서 내용과 코드 예시를 추출하는 데 최적화되었습니다.

`scrape_generic`

🌐 일반 웹사이트에서 문단 텍스트와 코드 블록을 추출합니다.

📁 파일 구조

browser-automation-agent/
├── main.py            # MCP server implementation
├── client.py          # Mistral AI client implementation
├── requirements.txt   # Project dependencies
├── .env               # Environment variables (API keys)
└── README.md          # Project documentation

📤 출력 파일

에이전트는 타임스탬프가 포함된 두 가지 유형의 출력 파일을 생성합니다.

📸 final_page_YYYYMMDD_HHMMSS.png : 최종 페이지 상태 스크린샷
📄 scraped_content_YYYYMMDD_HHMMSS.txt : 페이지에서 추출된 텍스트 콘텐츠

⚙️ 맞춤 설정

다음 매개변수를 코드에서 수정할 수 있습니다.

🖥️ 브라우저 창 크기: browse_and_scrape 에서 width 와 height 조정하세요
👻 헤드리스 모드: 보이지 않는 브라우저 작업을 위해 headless=True 설정하세요.
🔢 Google 검색 결과 수: get_top_google_url 에서 num_results 변경하세요.

❓ 문제 해결

🔌 연결 문제 : 서버와 클라이언트가 별도의 터미널에서 실행 중인지 확인하세요.
🎭 Playwright 오류 : 브라우저에 playwright install 가 되어 있는지 확인하세요.
🔑 API 키 오류 : Mistral API 키가 .env 파일에 올바르게 설정되었는지 확인하세요.
🛣️ 경로 오류 : 필요한 경우 client.py 에서 main.py 경로를 업데이트하세요.

📜 라이센스

MIT 라이센스

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

🧩 MCP, 🎭 Playwright, 🧠 Mistral AI로 구축됨

Browser Automation MCP Server

Integrations