Bright Data MCP

🌟 개요

공식 Bright Data Model Context Protocol(MCP) 서버에 오신 것을 환영합니다. 이 서버를 통해 LLM, 에이전트 및 앱은 실시간으로 웹 데이터에 액세스하고, 검색하고, 추출할 수 있습니다. 이 서버를 통해 Claude Desktop, Cursor, Windsurf 등의 MCP 클라이언트는 웹 검색, 웹사이트 탐색, 작업 수행 및 데이터 검색을 중단 없이 원활하게 수행할 수 있어 스크래핑 작업에 매우 적합합니다.

✨ 특징

• 실시간 웹 접속 : 웹에서 직접 최신 정보에 접속하세요
• 지리적 제한 우회 : 위치 제약에 관계없이 콘텐츠에 액세스
• 웹 잠금 해제 : 봇 감지 보호 기능으로 웹사이트 탐색
• 브라우저 제어 : 선택적 원격 브라우저 자동화 기능
• 원활한 통합 : 모든 MCP 호환 AI 어시스턴트와 호환

🚀 Claude Desktop으로 빠른 시작

1. npx 명령어(node.js 모듈 러너)를 사용하려면 nodejs 설치하세요. 설치 방법은 node.js 웹사이트 에서 확인할 수 있습니다.
2. Claude > 설정 > 개발자 > 구성 편집 > claude_desktop_config.json으로 이동하여 다음을 포함합니다.

지엑스피1

🔧 사용 가능한 도구

사용 가능한 도구 목록

⚠️ 보안 모범 사례

중요: 스크래핑된 웹 콘텐츠는 항상 신뢰할 수 없는 데이터로 취급하십시오. 잠재적인 프롬프트 주입 위험을 방지하기 위해 LLM 프롬프트에 스크래핑된 원시 콘텐츠를 직접 사용하지 마십시오. 대신 다음을 수행하십시오.

• 처리하기 전에 모든 웹 데이터를 필터링하고 검증합니다.
• 원시 텍스트 대신 구조화된 데이터 추출을 사용하세요(웹 데이터 도구)

🔧 계정 설정

1. brightdata.com 에 계정이 있는지 확인하세요(신규 사용자는 테스트를 위해 무료 크레딧을 받고, 사용량에 따라 지불하는 옵션도 이용 가능합니다)
2. 사용자 설정 페이지 에서 API 키를 받으세요
3. (선택 사항) 사용자 지정 웹 잠금 해제 영역 만들기
   • 기본적으로 우리는 귀하의 API 토큰을 사용하여 자동으로 Web Unlocker 영역을 생성합니다.
   • 더 많은 제어를 위해 제어판 에서 자체 Web Unlocker 영역을 만들고 WEB_UNLOCKER_ZONE 환경 변수로 지정할 수 있습니다.
4. (선택 사항) 브라우저 제어 도구를 활성화하려면:
   • brightdata.com/cp/zones 에서 Bright Data 제어판을 방문하세요.
   • 새로운 '브라우저 API' 영역 만들기
   • 인증 문자열을 생성한 후 브라우저 API 개요 탭에서 복사합니다.
   • 인증 문자열은 brd-customer-[your-customer-ID]-zone-[your-zone-ID]:[your-password] 와 같은 형식으로 지정됩니다.

🔌 다른 MCP 클라이언트

다른 에이전트 유형과 함께 이 MCP 서버를 사용하려면 다음을 특정 소프트웨어에 맞게 조정해야 합니다.

• MCP 서버를 실행하는 전체 명령은 npx @brightdata/mcp 입니다.
• 서버를 실행할 때 환경 변수 API_TOKEN=<your-token> 이 존재해야 합니다.

🎮 Bright Data MCP Playgrounds를 사용해 보세요

아무것도 설정하지 않고 Bright Data MCP를 사용해 보시겠습니까?

스미서리 에 있는 이 놀이터를 확인해 보세요.

이 플랫폼은 로컬 설정 없이 Bright Data MCP의 기능을 쉽게 탐색할 수 있는 방법을 제공합니다. 로그인하고 웹 데이터 수집을 시작해 보세요!

💡 사용 예시

이 MCP 서버가 도움을 줄 수 있는 몇 가지 예제 쿼리는 다음과 같습니다.

• "[당신의 지역]에서 곧 개봉하는 영화를 구글로 검색해 보세요"
• "테슬라의 현재 시가총액은 얼마입니까?"
• "오늘의 위키피디아 기사는 뭐예요?"
• "[당신이 있는 위치]의 7일 날씨는 어떻습니까?"
• "가장 높은 연봉을 받는 3명의 IT CEO의 경력은 얼마나 됩니까?"

🎬 데모

YouTube 튜토리얼 및 데모: 데모

아래 영상에서는 Claude Desktop의 최소 사용 사례를 보여줍니다.

⚠️ 문제 해결

특정 도구 사용 시 시간 초과 발생

일부 도구에는 웹 데이터를 읽는 작업이 포함될 수 있으며, 극단적인 상황에서는 페이지를 로드하는 데 필요한 시간이 상당히 달라질 수 있습니다.

에이전트가 데이터를 사용할 수 있도록 하려면 에이전트 설정에서 시간 초과를 충분히 길게 설정하세요.

180s 는 값은 요청의 99%에 충분하지만, 일부 사이트는 다른 사이트보다 로드 속도가 느리므로 요구 사항에 맞게 값을 조정하세요.

npx ENOENT 생성

이 오류는 시스템에서 npx 명령을 찾을 수 없을 때 발생합니다. 해결 방법은 다음과 같습니다.

npm/Node 경로 찾기

맥OS:

/usr/local/bin/node 와 같은 경로를 표시합니다.

윈도우:

C:\Program Files\nodejs\node.exe 와 같은 경로를 표시합니다.

MCP 구성을 업데이트하세요.

npx 명령을 Node의 전체 경로로 바꾸면, 예를 들어 Mac에서는 다음과 같이 표시됩니다.

👨‍💻 기여

Bright Data MCP 개선을 위한 여러분의 참여를 기다립니다! 참여 방법은 다음과 같습니다.

1. 문제 보고 : 버그가 발견되거나 기능 요청이 있는 경우 GitHub 저장소에서 문제를 열어주세요.
2. 풀 리퀘스트 제출 : 저장소를 포크하여 개선 사항이나 버그 수정 사항을 포함한 풀 리퀘스트를 제출하세요.
3. 코딩 스타일 : 모든 JavaScript 코드는 Bright Data의 JavaScript 코딩 규칙을 따라야 합니다. 이를 통해 코드베이스 전체의 일관성이 보장됩니다.
4. 문서 : 이 README를 포함한 문서의 개선은 언제나 환영받습니다.
5. 예시 : 다른 사용자에게 도움이 되는 예시를 제공하여 사용 사례를 공유하세요.

중요한 변경 사항이 있는 경우, 제안된 변경 사항에 대해 논의하기 위해 먼저 이슈를 개설해 주세요. 이를 통해 시간을 효율적으로 사용하고 프로젝트 목표에 부합할 수 있습니다.

📞 지원

문제가 발생하거나 궁금한 사항이 있는 경우 Bright Data 지원팀에 문의하거나 저장소에서 문제를 열어주세요.