Bright Data MCP Server

공식

웹을 발견, 추출, 상호작용하세요 - 하나의 인터페이스로 공개 인터넷 전반에 걸친 자동화된 접근을 지원합니다.

문서

Bright Data Logo

The Web MCP

🌐 AI에 실시간 웹 초능력을 부여하세요
차단 없이 LLM을 실시간 웹에 원활하게 연결하세요

npm version npm downloads License

빠른 시작기능가격데모문서지원

🎉 무료 티어 이용 가능! 🎉

월 5,000 크레딧 무료
신용카드 불필요 · 매월 자동 갱신 · 프로토타이핑 및 일상적인 AI 워크플로우에 완벽


신규: Code 도구 그룹 - 코딩 에이전트의 가장 친한 친구

AI 에이전트에서 바로 npm 및 PyPI 패키지 데이터에 즉시 액세스하세요.

패키지의 최신 버전이 필요하신가요? 워크플로우를 벗어나지 않고 README를 읽고 싶으신가요?
Code 도구 그룹은 코딩 에이전트에게 필요할 때 구조화되고 신뢰할 수 있는 패키지 메타데이터를 제공합니다 —
스크래핑도, 오래된 캐시도 없이, 에이전트가 현명한 의존성 결정을 내리는 데 필요한 데이터만 제공합니다.

npm
패키지 버전, README, 메타데이터 및 의존성
PyPI
Python 패키지 정보, 버전 및 프로젝트 세부 정보

GROUPS="code" · Claude Code, Cursor, Windsurf 및 모든 MCP 기반 코딩 에이전트를 위한 필수 도구

GEO 및 AI 브랜드 가시성 도구

ChatGPT, Grok, Perplexity가 브랜드에 대해 어떻게 이야기하는지 확인하세요.

에이전트에서 직접 주요 LLM에 쿼리하고 구조화된 마크다운 형식의 답변을 받아보세요.
생성 엔진 최적화(GEO)를 위한 궁극의 피드백 루프 — AI가 생성한 추천을 모니터링하고, LLM 전반에서 브랜드 언급을 추적하며, AI가 제품을 어떻게 인식하는지 이해하세요.

ChatGPT
AI 생성 인사이트, 인용 및 추천
Grok
X 데이터 기반 실시간 AI 분석
Perplexity
출처가 있는 검색 증강 AI 답변

GROUPS="geo" · 모든 MCP 호환 에이전트와 작동


🌟 개요

The Web MCP는 AI 어시스턴트에게 진정한 웹 기능을 부여하는 관문입니다. 더 이상 오래된 응답이나 "실시간 정보에 접근할 수 없습니다"라는 말은 없습니다. 실제로 작동하는 원활하고 신뢰할 수 있는 웹 접근만 있을 뿐입니다.

세계 1위 웹 데이터 플랫폼인 Bright Data가 구축한 이 MCP 서버는 AI가 차단되거나, 속도 제한에 걸리거나, CAPTCHA를 받는 일이 없도록 보장합니다.

모든 LLM과 작동
Claude, GPT, Gemini, Llama
🛡️ 절대 차단되지 않음
엔터프라이즈급 차단 해제
🚀 5,000 무료 크레딧
월간 · 카드 불필요
설정 불필요
바로 사용 가능

🎯 완벽한 활용 사례

  • 🔍 실시간 연구 - 현재 가격, 뉴스, 실시간 데이터 확보
  • 🛍️ 이커머스 인텔리전스 - 제품, 가격, 재고 모니터링
  • 📊 시장 분석 - 경쟁사 및 업계 동향 추적
  • 🤖 AI 에이전트 - 실제로 웹을 탐색할 수 있는 에이전트 구축
  • 💻 코딩 에이전트 - npm/PyPI 패키지, 버전, README를 실시간으로 조회
  • 🧠 GEO 및 브랜드 가시성 - ChatGPT, Grok, Perplexity가 브랜드를 어떻게 인식하는지 확인
  • 📝 콘텐츠 제작 - 최신 정보에 접근하여 글쓰기
  • 🎓 학술 연구 - 여러 소스에서 효율적으로 데이터 수집

⚡ 빠른 시작

설정 마법사 사용:

GIF for day2

📡 호스팅 서버 사용 - 설치 불필요!

설정이 전혀 필요 없는 사용자에게 완벽합니다. MCP 클라이언트에 이 URL을 추가하기만 하면 됩니다:

https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE

Claude Desktop에서 설정:

  1. 이동: 설정 → 커넥터 → 사용자 정의 커넥터 추가
  2. 이름: Bright Data Web
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. "추가"를 클릭하면 완료! ✨
로컬 머신에서 실행
{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}

🚀 가격 및 모드

⚡ 빠른 모드 (무료 티어)💎 프로 모드🔧 사용자 정의 모드

월 $0

5,000 크레딧


✅ 웹 검색
✅ 웹 차단 해제로 스크래핑
✅ AI 순위 디스커버 검색
❌ 브라우저 자동화
❌ 웹 데이터 도구


기본 모드

종량제

빠른 모드의 모든 기능 + 60개 이상의 도구


✅ 브라우저 제어
✅ 웹 데이터 API



PRO_MODE=true

사용량 기반

필요한 도구 선택


✅ 도구 그룹 결합
✅ 개별 도구 추가
❌ 프로 자격 재정의


GROUPS="browser"
TOOLS="scrape_as_html"

💡 무료 티어 작동 방식: 계정에 월 5,000 크레딧 (약 $7.50 상당)이 제공되며, 신용카드 없이 매월 1일에 자동 갱신됩니다. MCP 요청은 이 공유 풀에서 차감됩니다 — 기본 도구(search_engine, scrape_as_markdown, discover)는 요청당 1 크레딧이 소요되며, web_data_* 도구는 반환된 레코드당 1 크레딧이 소요됩니다. 사용하지 않은 크레딧은 이월되지 않으며, 소진 시 요청이 중단됩니다(자금을 예치하지 않는 한 예상치 못한 요금이 발생하지 않음). 프로 모드는 무료 티어에 포함되지 않으며 사용량에 따라 추가 요금이 발생합니다.


🧠 고급 도구 선택

  • GROUPS을(를) 사용하면 선별된 도구 번들을 활성화할 수 있습니다. ecommerce,browser과(와) 같은 쉼표로 구분된 그룹 ID를 사용하세요.
  • TOOLS은(는) 선택된 그룹 위에 명시적 도구 이름을 추가합니다.
  • 모드 우선순위: PRO_MODE=true (모든 도구) → GROUPS / TOOLS (화이트리스트) → 기본 빠른 모드 (기본 툴킷).
  • 항상 활성화되는 기본 도구: search_engine, search_engine_batch, scrape_as_markdown, scrape_batch, discover.
  • 그룹 ID custom은(는) 예약되어 있습니다. 맞춤 선택에는 TOOLS을(를) 사용하세요.
그룹 ID설명주요 도구
ecommerce소매 및 마켓플레이스 데이터셋web_data_amazon_product, web_data_walmart_product, web_data_google_shopping
social소셜, 커뮤니티 및 크리에이터 인사이트web_data_linkedin_posts, web_data_tiktok_posts, web_data_youtube_videos
browserBright Data 스크래핑 브라우저 자동화 도구scraping_browser_snapshot, scraping_browser_click_ref, scraping_browser_screenshot
finance금융 인텔리전스 데이터셋web_data_yahoo_finance_business
business회사 및 위치 인텔리전스 데이터셋web_data_crunchbase_company, web_data_zoominfo_company_profile, web_data_zillow_properties_listing
research뉴스 및 개발자 데이터 피드web_data_github_repository_file, web_data_reuter_news
app_stores앱 스토어 데이터web_data_google_play_store, web_data_apple_app_store
travel여행 정보web_data_booking_hotel_listings
geoGEO 및 LLM 브랜드 가시성web_data_chatgpt_ai_insights, web_data_grok_ai_insights, web_data_perplexity_ai_insights
code코딩 에이전트를 위한 패키지 인텔리전스web_data_npm_package, web_data_pypi_package
advanced_scraping배치 및 AI 지원 추출 도우미search_engine_batch, scrape_batch, extract

Claude Desktop 예시

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "browser,advanced_scraping",
        "TOOLS": "extract"
      }
    }
  }
}

코딩 에이전트 예시 (Claude Code / Cursor / Windsurf)

코딩 에이전트에 실시간 패키지 인텔리전스를 제공하세요 — 스크래핑 없이 npm 및 PyPI의 최신 버전, README, 의존성, 메타데이터를 제공합니다:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "code"
      }
    }
  }
}

✨ 기능

🔥 핵심 기능

🔍 스마트 웹 검색
AI에 최적화된 Google 수준의 결과
📄 깨끗한 마크다운
AI 준비 완료 콘텐츠 추출
🌍 글로벌 액세스
지리적 제한 자동 우회
🛡️ 안티봇 보호
차단 또는 속도 제한 없음
🤖 브라우저 자동화
실제 브라우저 원격 제어 (프로)
초고속
최소 지연 시간에 최적화

🎯 바로 작동하는 예시 쿼리

✅ "What's Tesla's current stock price?"
✅ "Find the best-rated restaurants in Tokyo right now"
✅ "Get today's weather forecast for New York"
✅ "What movies are releasing this week?"
✅ "What are the trending topics on Twitter today?"
✅ "What's the latest version of express on npm?"
✅ "Get the README for the langchain-brightdata PyPI package"

🎬 데모

참고: 이 비디오는 이전 버전을 보여줍니다. 새로운 데모가 곧 제공됩니다! 🎥

데모 비디오 보기

기본 웹 검색 데모

https://github.com/user-attachments/assets/59f6ebba-801a-49ab-8278-1b2120912e33

고급 스크래핑 데모

https://github.com/user-attachments/assets/61ab0bee-fdfa-4d50-b0de-5fab96b4b91d

📺 YouTube에서 더 많은 튜토리얼 보기 →


🔧 사용 가능한 도구

⚡ 빠른 모드 도구 (기본 - 무료)

도구설명사용 사례
🔍 search_engineAI 최적화 결과를 제공하는 웹 검색연구, 사실 확인, 시사 문제
📄 scrape_as_markdown모든 웹페이지를 깨끗한 마크다운으로 변환콘텐츠 추출, 문서화
🎯 discover의도 기반 관련성 점수를 매기는 AI 순위 웹 검색심층 연구, RAG 파이프라인, 경쟁 분석

💎 프로 모드 도구 (60개 이상)

모든 프로 도구를 보려면 클릭
카테고리도구설명
브라우저 제어scraping_browser.*완전한 브라우저 자동화
웹 데이터 APIweb_data_*구조화된 데이터 추출
이커머스제품 스크래퍼Amazon, eBay, Walmart 데이터
소셜 미디어소셜 스크래퍼Twitter, LinkedIn, Instagram
지도 및 로컬위치 도구Google Maps, 비즈니스 데이터

📚 전체 도구 문서 보기 →


🎮 지금 사용해 보세요!

🧪 온라인 플레이그라운드

설정 없이 Web MCP를 사용해 보세요:


🔧 설정

기본 설정

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "your-token-here"
      }
    }
  }
}

고급 설정

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "your-token-here",
        "PRO_MODE": "true",              // Enable all 60+ tools
        "RATE_LIMIT": "100/1h",          // Custom rate limiting
        "WEB_UNLOCKER_ZONE": "custom",   // Custom unlocker zone
        "BROWSER_ZONE": "custom_browser", // Custom browser zone
        "POLLING_TIMEOUT": "600"         // Polling timeout in seconds (default: 600)
      }
    }
  }
}

환경 변수

변수설명기본값예시
API_TOKENBright Data API 토큰 (필수)-your-token-here
PRO_MODE60개 이상의 모든 도구 활성화falsetrue
RATE_LIMIT사용자 정의 속도 제한무제한100/1h, 50/30m
WEB_UNLOCKER_ZONE사용자 정의 Web Unlocker 영역 이름mcp_unlockermy_custom_zone
BROWSER_ZONE사용자 정의 Browser 영역 이름mcp_browsermy_browser_zone
POLLING_TIMEOUTweb_data_* 도구 폴링 제한 시간(초)600300, 1200
BASE_TIMEOUT기본 도구의 요청 제한 시간(초) (검색 및 스크래핑)제한 없음60, 120
BASE_MAX_RETRIES일시적 오류 발생 시 기본 도구의 최대 재시도 횟수 (0-3)01, 3
GROUPS쉼표로 구분된 도구 그룹 ID-ecommerce,browser
TOOLS쉼표로 구분된 개별 도구 이름-extract,scrape_as_html

참고:

  • POLLING_TIMEOUT은(는) web_data_* 도구가 결과를 기다리는 시간을 제어합니다. 1초 = 1회 폴링 시도입니다.
  • 낮은 값(예: 300)은 느린 데이터 수집 시 더 빨리 실패합니다.
  • 높은 값(예: 1200)은 복잡한 스크래핑 작업에 더 많은 시간을 허용합니다.

📚 문서


🚨 일반적인 문제 및 해결책

🔧 문제 해결 가이드

❌ "spawn npx ENOENT" 오류

해결책: Node.js를 설치하거나 node의 전체 경로를 사용하세요:

"command": "/usr/local/bin/node"  // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe"  // Windows

⏱️ 복잡한 사이트에서 제한 시간 초과

해결책: 클라이언트 설정에서 제한 시간을 180초로 늘리세요

🔑 인증 문제

해결책: API 토큰이 유효하고 적절한 권한이 있는지 확인하세요

📡 원격 서버 연결

해결책: 인터넷 연결 및 방화벽 설정을 확인하세요

더 많은 문제 해결 →


🤝 기여하기

기여를 환영합니다! 다음 방법으로 도움을 줄 수 있습니다:

Bright Data의 코딩 표준을 따라 주세요.


📞 지원


📜 라이선스

MIT © Bright Data Ltd.


❤️로 제작
Bright Data

세계 1위 웹 데이터 플랫폼


⭐ GitHub에서 별표 주기블로그 읽기