Bright Data

공식

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

Bright Data MCP(으)로 무엇을 할 수 있나요?

  • 웹 검색 — 어시스턴트에게 Bing 또는 Google 검색을 실행하고 링크, 제목, 설명이 포함된 구조화된 결과를 반환하도록 요청하세요.
  • 페이지 스크래핑 — 봇 감지 및 CAPTCHA 처리가 내장된 상태로 URL을 가져와 깔끔한 Markdown, 텍스트, HTML 또는 ld_json 형식으로 제공받으세요.
  • 구조화된 플랫폼 데이터 — Amazon, LinkedIn, TikTok, npm과 같은 사이트용 사전 구축 스크래퍼를 찾아 실행해 HTML을 파싱하는 대신 깔끔한 JSON을 가져오세요.
  • 브라우저 자동화 — 원격 브라우저 세션에서 페이지를 탐색하고, 클릭하고, 입력하고, 스크롤하고, 스크린샷을 찍어 상호작용이 필요하거나 로그인이 필요한 사이트를 이용하세요.
  • LLM 답변 수집 — ChatGPT 또는 Perplexity에 프롬프트를 보내고 답변을 받아 각 서비스가 브랜드를 어떻게 설명하는지 비교하세요.
  • 일괄 수집 — 한 번의 호출로 검색을 최대 5건 실행하거나 URL을 최대 5개 스크래핑해 데이터를 병렬로 수집하세요.

문서

Bright Data Logo

Bright Data MCP

Model Context Protocol을 통해 AI 에이전트와 LLM에 웹 검색, 페이지 스크래핑, 구조화된 데이터 추출 및 브라우저 자동화를 제공합니다.

AI 에이전트, 코딩 에이전트, 채팅 어시스턴트 및 MCP 호환 클라이언트와 함께 사용할 수 있습니다.

npm version npm downloads License

빠른 시작 • 요금 • 사용 사례 • 도구 • 에이전트 스킬 • 문서 • 지원

무료 요금제: 월 5,000회 요청. 신용카드가 필요하지 않습니다. 매월 갱신됩니다.


개요

Bright Data MCP 서버는 AI 에이전트에 실시간 공개 웹 데이터 액세스를 제공합니다. 다음을 포함하는 30개 도구를 제공합니다.

  • 웹 검색 — Bing 및 Google 결과를 구조화된 데이터로 제공
  • 페이지 스크래핑 — 모든 URL을 Markdown 또는 HTML로 가져오며, 봇 감지, CAPTCHA 해결 및 프록시 로테이션을 모든 요청에서 자동으로 처리
  • 구조화된 데이터(Web Scraper API) — Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI 등 1,200개 이상의 사전 구축 스크래퍼에서 HTML 파싱 없이 깔끔한 JSON을 제공합니다. 도구 6개로 원하는 스크래퍼를 찾아 실행할 수 있습니다
  • 브라우저 자동화 — 원격 브라우저 세션에서 페이지 이동, 클릭, 입력, 스크린샷 촬영 및 페이지 읽기
  • LLM 응답 수집 — ChatGPT 및 Perplexity에 프롬프트를 보내고 답변을 구조화된 데이터로 가져오기

모든 요청은 Bright Data의 차단 해제 인프라를 통해 라우팅되므로 일반 HTTP 클라이언트를 차단하는 페이지(봇 감지, CAPTCHA, 요청 제한, 지역 제한)도 정상적으로 반환됩니다. 프록시 설정, 헤드리스 브라우저 유지 관리, 재시도 로직 작성이 필요하지 않습니다.

두 가지 배포 옵션: 호스팅 원격 서버(단일 URL, 설치 불필요) 또는 npx @brightdata/mcp을 통한 로컬 인스턴스.


빠른 시작

호스팅 서버 — 설치 불필요. 이 URL을 MCP 클라이언트에 추가하세요.

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

Bright Data 계정 설정에서 API 토큰을 가져오세요. 신규 계정에는 매월 5,000회의 무료 요청이 제공됩니다.

선택적 URL 매개변수:

매개변수설명예시
groups=<ids>특정 도구 그룹으로 제한(기본값: 모든 도구)...&groups=scrapers,browser
tools=<names>특정 도구로 제한...&tools=search_engine,scrape_as_markdown
Claude Desktop
  1. 이동: Settings → Connectors → Add custom connector
  2. 이름: Bright Data
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. "Add"를 클릭합니다

또는 로컬에서 실행하세요.

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}
Claude Code
claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
Cursor

~/.cursor/mcp.json에 추가하세요.

{
  "mcpServers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
VS Code

.vscode/mcp.json에 추가하세요.

{
  "servers": {
    "brightdata": {
      "type": "http",
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Windsurf

~/.codeium/windsurf/mcp_config.json에 추가하세요.

{
  "mcpServers": {
    "brightdata": {
      "serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Gemini CLI

~/.gemini/settings.json에 추가하세요.

{
  "mcpServers": {
    "brightdata": {
      "httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Zed

Zed 설정에 추가하세요.

{
  "context_servers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Warp

Settings > MCP Servers > Add MCP Server로 이동해 다음을 추가하세요.

{
  "brightdata": {
    "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  }
}
기타 클라이언트(local npx)

로컬 MCP 서버를 지원하는 모든 클라이언트에서 사용할 수 있습니다.

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

요금 및 무료 요금제

모든 계정에는 매월 갱신되는 무료 요금제가 포함됩니다. 시작하는 데 신용카드나 약정이 필요하지 않습니다.

매월 5,000회 무료 요청이 제공되며, 매월 1일에 갱신됩니다. 사용하지 않은 요청은 다음 달로 이월되지 않습니다. 팀 계정의 경우 무료 요금제는 계정 내 모든 사용자가 공유합니다.

무료로 제공되는 항목:

  • 모든 웹페이지를 가져와 Markdown으로 추출
  • 인기 도메인용 사전 구축 스크래퍼 60개 이상 이용
  • 웹 검색(Bing, Google)
  • 웹 차단 해제(봇 감지 우회, CAPTCHA 해결, 프록시 로테이션)
  • 브라우저 자동화
  • 지역 타겟팅

무료 요금제 초과분 — 약정 없이 사용량만큼 결제:

검색, 스크래핑 및 추출브라우저 탐색
사용량 기반 결제결과 1,000건당 $1.50GB당 $8
  • 무료 요청을 모두 사용하면 요청이 중단됩니다. 예치금이 있는 경우를 제외하면 예상치 못한 요금이 청구되지 않습니다
  • 신용카드 추가는 인증 절차일 뿐입니다. 무료 요금제를 모두 사용하고 또한 예치금이 있는 경우가 아니면 요금이 청구되지 않습니다
  • 제어판에서 지출 한도를 설정해 사용량 기반 결제가 예산을 초과하지 않도록 하세요

전체 요금, 대량 사용 요금제 및 엔터프라이즈 →


사용 사례

실시간 조사

학습 데이터 대신 실시간 웹 데이터를 사용해 질문에 답하세요. 검색한 다음 출처를 읽습니다.

작업도구
최신 정보를 웹에서 검색search_engine, search_engine_batch
특정 페이지를 깔끔한 Markdown으로 읽기scrape_as_markdown, scrape_batch

프롬프트 예시: "테슬라의 현재 주가는 얼마야?", "오늘 뉴욕의 일기예보를 알려줘", "지난 6개월간 EU AI 규제에 대해 가장 많이 인용된 출처를 찾아줘".

이커머스 인텔리전스

가격, 재고 여부, 평점, 리뷰 수, 판매자, 이미지 등 제품 데이터를 구조화된 JSON으로 확인하세요.

작업도구
Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara 및 기타 매장의 제품, 리뷰 및 검색 결과search_scrapers → get_scraper_details → run_scraper
여러 소매업체의 가격 비교Google Shopping 스크래퍼를 사용한 동일한 흐름

프롬프트 예시: "이 노트북의 Amazon, Walmart, Best Buy 가격을 비교해줘", "ASIN B0D2Q9397Y의 평점과 리뷰 수를 알려줘", "이 제품은 재고가 있나요?".

시장 및 경쟁사 분석

실시간 데이터로 경쟁사 프로필을 구축하세요. 자금 조달, 직원 수, 채용, 고객 리뷰, 가격 페이지 등을 확인할 수 있습니다.

작업도구
기업의 자금 조달, 규모, 직원, 채용 공고(Crunchbase, ZoomInfo, LinkedIn)search_scrapers → run_scraper
고객 정서(Google Maps, Facebook, 앱 스토어 리뷰)search_scrapers → run_scraper
경쟁사 가격 페이지scrape_as_markdown, scrape_batch
시장 탐색search_engine_batch

프롬프트 예시: "Notion을 경쟁사로 분석해줘. 가격, 자금 조달, 채용 중점 분야, 고객 불만 사항을 알려줘".

안정적인 웹 액세스를 제공하는 AI 에이전트

보호된 사이트에서 차단되는 내장 fetch/search 도구를 대체하세요. 모든 요청은 차단 해제 인프라를 거치므로 봇 감지, CAPTCHA 또는 지역 제한으로 에이전트가 실패하지 않습니다.

작업도구
내장 웹 검색을 바로 대체search_engine
내장 URL 가져오기를 바로 대체scrape_as_markdown
병렬 데이터 수집(한 번에 5개)search_engine_batch, scrape_batch
대화형 사이트(로그인 제한, 무한 스크롤, 동적 콘텐츠)scraping_browser_*(도구 14개)

코딩 에이전트

필요할 때 패키지 레지스트리 데이터를 가져오세요. 스크래핑이나 오래된 캐시가 필요하지 않습니다.

작업도구
npm 및 PyPI 패키지 버전, README, 메타데이터npmjs 또는 pypi 스크래퍼와 함께 run_scraper 사용( search_scrapers로 찾기)
GitHub 저장소에서 파일 읽기GitHub repository 스크래퍼와 함께 run_scraper 사용

프롬프트 예시: "npm의 express 최신 버전은 뭐야?", "langchain-brightdata PyPI 패키지의 README를 가져와줘".

GEO 및 브랜드 가시성

주요 LLM에 프롬프트를 보내고 답변을 구조화된 데이터로 가져오세요. AI 어시스턴트가 브랜드를 어떻게 설명하는지, 어떤 출처를 인용하는지, 무엇을 추천하는지 측정할 수 있습니다. 이는 생성형 엔진 최적화(Generative Engine Optimization)를 위한 피드백 루프입니다.

작업도구
인용 및 추천이 포함된 ChatGPT 답변chatgpt_ai_insights
출처가 포함된 Perplexity 답변perplexity_ai_insights

프롬프트 예시: "ChatGPT와 Perplexity에 '최고의 프록시 제공업체는 어디인가요?'라고 묻고, 각 서비스가 우리를 어떻게 평가하는지 비교해줘".

소셜 미디어 모니터링

주요 플랫폼의 프로필, 게시물, 댓글, 참여 지표 등 구조화된 데이터를 확인하세요. 각 플랫폼에는 데이터 유형별 스크래퍼가 있습니다(LinkedIn 프로필, Instagram 릴스, TikTok 댓글 등). search_scrapers으로 찾아 run_scraper로 실행하세요.

플랫폼스크래퍼 예시
LinkedIn개인 프로필, 회사 프로필, 채용 공고, 게시물, 사람 검색
Instagram프로필, 게시물, 릴스, 댓글
TikTok프로필, 게시물, 쇼핑, 댓글
Facebook프로필, 게시물, 마켓플레이스 목록, 회사 리뷰, 이벤트
YouTube동영상, 채널, 댓글
X (Twitter)게시물, 프로필별 게시물
Reddit게시물, 댓글

프롬프트 예시: "이 TikTok 프로필의 최근 게시물 10개를 가져와 참여도를 요약해줘".

콘텐츠 제작 및 학술 연구

최신성 및 관련성 기준으로 필터링해 여러 페이지에서 한 번에 자료를 수집하세요.

작업도구
한 번의 호출로 여러 출처 수집scrape_batch(최대 URL 5개)
뉴스 및 금융 데이터뉴스 검색어와 함께 search_engine, Yahoo Finance 스크래퍼와 함께 run_scraper

비교

기능Bright Data MCP일반적인 웹 MCP 서버
전체 도구 수302–10
플랫폼별 구조화 JSON 추출기이커머스, 소셜, 비즈니스, 금융, 여행, 앱 스토어 전반의 사전 구축 스크래퍼 1,200개 이상을 도구 6개로 제공드묾. 일반 스크래핑만 제공
차단 해제(봇 감지 우회, CAPTCHA 해결, 프록시 로테이션)모든 요청에 기본 제공대개 없음. 보호된 사이트에서 차단됨
검색 엔진Bing, Google대개 하나
브라우저 자동화도구 14개, 원격 브라우저, 로컬 설정 불필요제한적이거나 없음
LLM 응답 수집(ChatGPT, Perplexity)제공제공하지 않음
패키지 레지스트리 데이터(npm, PyPI)제공제공하지 않음
일괄 작업호출당 검색 10건 또는 스크래핑 10건대개 단일 요청만 가능
지역 타겟팅제공제한적이거나 없음
무료 요금제월 5,000회 요청, 브라우저 자동화 포함, 신용카드 불필요서비스마다 다름. 키 없이 이용하는 경우 요청 제한이 있는 경우가 많음

도구 선택: 그룹

필요한 도구만 불러올 수 있도록 도구를 그룹으로 구성했습니다. 도구 수가 적을수록 에이전트가 처리해야 하는 컨텍스트가 줄어듭니다.

  • GROUPS 또는 TOOLS를 지정하지 않으면 도구 30개가 모두 활성화됩니다. 둘 중 하나를 설정하면 서버는 해당 도구만 사용합니다
  • GROUPS은 도구 번들을 활성화합니다. 쉼표로 구분해 GROUPS="scrapers,browser"(로컬) 또는 &groups=scrapers,browser(호스팅 URL)로 지정합니다
  • TOOLS은 개별 도구를 추가합니다: TOOLS="scrape_batch,session_stats". 단독으로 사용하면 지정한 도구만 활성화됩니다
  • 모든 그룹에는 search_engine, scrape_as_markdown 및 ask_brightdata_assistant도 포함됩니다
  • 그룹 ID custom은 예약되어 있습니다. 개별 도구를 선택하려면 TOOLS를 사용하세요 | 그룹 ID | 내용 | 도구 수 | |----------|----------|-----------| | scrapers | 사전 구축된 Web Scraper API 스크레이퍼(Amazon, LinkedIn, TikTok, npm 등)를 검색하고 실행 | 6 | | browser | 원격 브라우저 자동화 | 14 | | geo | ChatGPT 및 Perplexity 응답 수집 | 2 | | advanced_scraping | 일괄 처리 도구, 세션 통계 | 3 |

이전 그룹 ID(ecommerce, social, business, finance, research, app_stores, travel, code)도 계속 작동하며 scrapers 도구를 활성화합니다. social 및 business는 search_dataset와 list_dataset_fields도 추가합니다. 이전 TOOLS의 web_data_* 이름도 scrapers 도구를 활성화합니다.

구성 예시

브라우저 자동화 및 일괄 처리 도구를 사용하는 로컬 서버:

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

코딩 에이전트 설정(Claude Code / Cursor / Windsurf) — 사전 구축된 스크레이퍼를 통한 npm, PyPI 및 GitHub 데이터:

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

도구 참조(도구 30개)

사용할 도구 선택

  • URL을 알고 있고 콘텐츠가 필요한 경우: scrape_as_markdown. URL 여러 개(최대 5개): scrape_batch
  • 정보를 찾아야 하는 경우: search_engine. 검색어 여러 개(최대 5개): search_engine_batch
  • 알려진 플랫폼(Amazon, LinkedIn, TikTok, npm, PyPI 등)의 구조화된 데이터: search_scrapers → get_scraper_details → run_scraper — 깔끔한 JSON을 반환하며, 같은 페이지를 스크레이핑하는 것보다 빠르고 안정적입니다.
  • 원시 HTML: format: 'html'과 함께 scrape_as_markdown
  • 페이지와 상호작용해야 하는 경우(클릭, 입력, 스크롤, 로그인): scraping_browser_* 도구
  • ChatGPT/Perplexity가 프롬프트에 어떻게 답하는지 확인하려는 경우: chatgpt_ai_insights / perplexity_ai_insights
  • Bright Data 자체에 관한 질문(제품, 존, 오류, 설정): ask_brightdata_assistant

스크레이퍼 실행 관련 참고 사항:

  • 구조화된 JSON을 반환하며, 반환된 레코드별로 요금이 부과됩니다.
  • error 필드가 있는 레코드는 잘못된 유형의 URL 등 입력이 실패한 이유를 설명합니다.
  • 결과가 클 수 있습니다. discover_by_* 메서드에서는 limit_per_input를 낮게 설정하고, 프레임워크에서 지원하는 경우 대량 수집을 하위 에이전트에서 실행해 레코드가 기본 컨텍스트 창을 가득 채우지 않도록 하세요.
  • 실행에 실패하면 같은 URL에서 scrape_as_markdown을 대체 수단으로 사용할 수 있습니다.
검색 및 스크레이핑 — 도구 5개
도구설명그룹
search_engineBing(기본값) 또는 Google 검색. JSON(링크, 제목, 설명)을 반환하며 페이지당 결과 10개입니다. 매개변수: country, page(0부터 시작), time_range(hour, day, week, month, year, any; Bing은 day, week, year만 지원)기본값 / 모든 그룹
search_engine_batch한 번의 호출로 검색어 최대 5개 검색기본값 / advanced_scraping
scrape_as_markdown모든 URL. 콘텐츠를 Markdown(기본값), 텍스트, HTML 또는 ld_json으로 반환기본값 / 모든 그룹
scrape_batch한 번의 호출로 URL 최대 5개. 콘텐츠를 Markdown(기본값), 텍스트, HTML 또는 ld_json으로 반환기본값 / advanced_scraping
session_stats현재 세션의 도구 사용 횟수기본값 / advanced_scraping
Web Scraper API — 도구 6개

Bright Data의 사전 구축 스크레이퍼 1,200개 이상을 검색하고 실행합니다. 스크레이퍼 목록은 docs.brightdata.com/scrapers.json에서 불러오며 매일 새로 고쳐집니다. 호스팅 서버와 로컬 서버 모두에서 사용할 수 있습니다. 도구나 그룹을 선택하지 않으면 기본적으로 활성화됩니다. 그렇지 않은 경우 scrapers 그룹을 추가하세요(호스팅 URL에서는 &groups=scrapers, 로컬에서는 GROUPS=scrapers).

일반적인 흐름: search_scrapers → get_scraper_details → run_scraper. 실행 요금은 레코드별로 부과되며, discover_by_* 메서드는 입력당 최대 limit_per_input개의 레코드를 수집합니다(기본값 10).

도구설명그룹
search_scrapers사이트 또는 데이터 유형(예: "amazon reviews", "linkedin.com")별로 스크레이퍼를 찾습니다. 데이터 세트 ID, 이름, 도메인 및 수집 메서드를 반환합니다.기본값 / scrapers
get_scraper_details스크레이퍼 메서드 하나의 설명, 입력 필드, 입력 예시 및 주요 출력 필드기본값 / scrapers
run_scraper스크레이퍼 메서드를 실행합니다. 최대 45초 동안 대기하며, 계속 실행 중이면 나중에 확인할 수 있도록 snapshot_id을 반환합니다.기본값 / scrapers
get_scraper_progress실행 상태: starting, running, ready, failed 또는 canceled기본값 / scrapers
get_scraper_results완료된 실행의 레코드기본값 / scrapers
refresh_scrapers매일 새로 고쳐질 때까지 기다리지 않고 지금 스크레이퍼 목록을 다시 불러옵니다.기본값 / scrapers
브라우저 자동화 — 도구 14개

원격 브라우저 세션. 일반적인 순서: 탐색 → 스냅샷 → ref로 상호작용 → 추출 또는 스크린샷.

도구설명
scraping_browser_navigate브라우저 세션을 열거나 재사용하고 URL로 이동합니다.
scraping_browser_go_back이전 페이지로 이동합니다.
scraping_browser_go_forward다음 페이지로 이동합니다.
scraping_browser_snapshotref가 포함된 페이지의 ARIA 스냅샷을 생성합니다. ref 기반 작업 전에 필요합니다.
scraping_browser_click_ref최신 스냅샷의 ref로 요소를 클릭합니다.
scraping_browser_type_refref로 요소에 입력합니다. 선택적으로 Enter 키를 눌러 제출할 수 있습니다.
scraping_browser_fill_form한 번의 호출로 여러 양식 필드를 ref로 채웁니다.
scraping_browser_screenshot현재 페이지의 스크린샷. 선택적 full_page
scraping_browser_get_text페이지 본문의 텍스트 콘텐츠
scraping_browser_get_html현재 페이지의 HTML
scraping_browser_scroll페이지 맨 아래로 스크롤합니다.
scraping_browser_scroll_to_ref요소가 보이도록 스크롤합니다.
scraping_browser_wait_for_ref선택적 시간 제한을 지정해 요소가 표시될 때까지 기다립니다.
scraping_browser_network_requests페이지 로드 이후의 네트워크 요청: 메서드, URL, 상태

ref는 최신 스냅샷에서 가져옵니다. 클릭이나 탐색 후 페이지가 바뀌면 다음 ref 기반 작업 전에 새 스냅샷을 생성하세요. 정적 페이지에서는 scrape_as_markdown가 브라우저 세션보다 빠르고 비용도 적게 듭니다.

GEO 및 LLM 가시성 — 도구 2개
도구입력반환값
chatgpt_ai_insights프롬프트ChatGPT의 답변을 Markdown으로 반환
perplexity_ai_insights프롬프트Perplexity의 답변을 Markdown으로 반환

생성형 엔진 최적화(LLM이 브랜드를 어떻게 설명하는지 추적) 및 LLM-as-a-judge 워크플로에 사용하세요.

데이터 세트 검색 — 도구 2개

저장된 LinkedIn 데이터 세트를 필터링해 검색합니다. 스크레이퍼를 실행하지 않고 일치하는 레코드를 한 번에 반환합니다.

도구설명그룹
list_dataset_fields데이터 세트의 필터링 가능한 필드(이름, 유형, 설명). search_dataset 전에 호출하세요.기본값 / social, business
search_dataset필터와 일치하는 레코드를 호출당 최대 10개 반환하며, 추가 결과를 위한 커서를 제공합니다.기본값 / social, business
Bright Data Assistant — 도구 1개
도구설명그룹
ask_brightdata_assistantBright Data의 지원 어시스턴트 Sophie에게 제품, API, 존, 오류 또는 계정 설정에 관해 질문합니다. 반환된 dialog_id을 전달하면 같은 스레드에서 후속 질문을 할 수 있습니다.기본값 / 모든 그룹

문서에서 전체 도구 참조 보기 →


에이전트 스킬

에이전트가 이 MCP 서버를 올바르게 사용하도록 안내하는 즉시 사용 가능한 스킬입니다. 전체 모음은 github.com/brightdata/skills에 있으며, MCP 오케스트레이션, 경쟁 정보, 가격 비교, 브랜드 모니터링, SEO 감사, 스크레이퍼 구축, RAG 파이프라인 등을 다루는 스킬 21개가 포함되어 있습니다.

가장 효과가 큰 스킬 세 가지:

스킬기능
bright-data-mcpBright Data MCP를 모든 웹 데이터 작업의 기본 도구로 설정합니다. 봇 감지로 실패하는 WebFetch, WebSearch 및 기타 내장 웹 도구를 대체합니다.
competitive-intel실시간 웹 데이터로 경쟁사 현황, 가격 비교, 리뷰 분석, 채용 신호, 콘텐츠/SEO 분석 및 시장 환경 지도를 제공합니다.
price-comparisonAmazon, Walmart, eBay, Best Buy 및 Google Shopping에서 제품을 찾아 가장 저렴한 재고 보유 옵션을 알려줍니다.

스킬 21개 모두 보기 →


구성

기본 설정(로컬)

{
  "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",
        "RATE_LIMIT": "100/1h",
        "SERP_ZONE": "custom_serp",
        "BROWSER_ZONE": "custom_browser"
      }
    }
  }
}

환경 변수

변수설명기본값예시
API_TOKENBright Data API 토큰(필수)-your-token-here
RATE_LIMIT사용자 지정 속도 제한무제한100/1h, 50/30m
SERP_ZONE검색 도구에서 사용하는 사용자 지정 SERP API 존 이름mcp_serpmy_serp_zone
BROWSER_ZONE사용자 지정 Browser 존 이름mcp_browsermy_browser_zone
CONTENT_GATE데이터 도구가 반환한 페이지 콘텐츠가 MCP 구성을 변경하라는 지시처럼 보이면, 서버는 콘텐츠를 반환하기 전에 MCP elicitation을 통해 사용자에게 확인합니다. 비활성화하려면 off로 설정하세요.onoff
CONTENT_GATE_TIMEOUT콘텐츠를 보류하기 전에 사용자 응답을 기다리는 시간(초)12060, 300
BROWSER_FILTERED_SNAPSHOTscraping_browser_snapshot에는 버튼, 링크 및 필드만 표시됩니다. 토큰을 절약하고 페이지 텍스트가 클릭 가능한 요소인 것처럼 가장하는 것을 방지합니다(민감한 작업에 유용). 필요한 경우 scraping_browser_get_text로 페이지 텍스트를 읽을 수 있습니다.offon
BASE_TIMEOUT기본 도구(검색 및 스크레이핑)의 요청 시간 제한(초)제한 없음60, 120
BASE_MAX_RETRIES일시적 오류 발생 시 기본 도구의 최대 재시도 횟수(0-3)01, 3
GROUPS쉼표로 구분된 도구 그룹 ID. 서버에서 해당 그룹만 사용할 수 있도록 제한합니다.모든 도구scrapers,browser
TOOLS쉼표로 구분된 개별 도구 이름. 서버에서 해당 도구만 사용할 수 있도록 제한합니다.모든 도구scrape_batch,session_stats

콘텐츠 게이트

scrape_as_markdown, search_engine 및 해당 일괄 처리 변형은 웹 페이지에 있는 내용을 그대로 반환합니다. 콘텐츠에 MCP 구성을 변경하라는 지시처럼 보이는 텍스트(서버 등록, npx -y 패키지 실행, MCP 구성 파일 편집 등)가 포함되어 있으면 서버는 일시 중지하고 MCP 클라이언트를 통해 사용자에게 확인한 후 콘텐츠를 반환합니다. 승인하면 콘텐츠가 변경 없이 반환되고, 거부하면 어시스턴트에 간단한 설명을 제공하며 콘텐츠를 보류합니다. 이러한 텍스트가 없는 페이지는 이전과 똑같이 프롬프트 없이 반환됩니다. 일괄 호출에서는 조건에 일치하는 항목만 보류됩니다.

MCP 구성에 관한 페이지(문서, README)는 자연스럽게 확인 메시지를 표시합니다. MCP elicitation을 지원하지 않는 클라이언트에서는 조건에 일치하는 콘텐츠가 보류됩니다. 위험을 감수하려면 CONTENT_GATE=off를 설정하세요. 서버가 응답을 기다리는 동안 진행 상황을 보고합니다. 진행 상황에 따라 도구 시간 제한을 연장하지 않는 클라이언트는 자체 제한 시간까지만 대기합니다. 서버 측에서 이를 조정하는 설정은 CONTENT_GATE_TIMEOUT입니다. 브라우저 도구에는 적용되지 않습니다.


문서

리소스링크
API 문서docs.brightdata.com/ai/mcp-server/overview
전체 도구 참조docs.brightdata.com/ai/mcp-server/tools
에이전트 스킬github.com/brightdata/skills
사용 예시examples
변경 로그CHANGELOG.md

문제 해결

일반적인 문제와 해결 방법

"spawn npx ENOENT" 오류

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

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

복잡한 사이트에서 시간 초과 발생

클라이언트 설정에서 시간 제한을 180s로 늘리세요.

인증 문제

API 토큰이 유효하고 필요한 권한이 있는지 확인하세요. 토큰은 계정 설정에서 관리합니다.

run_scraper에서 오류가 반환되거나 데이터가 없음

error 필드가 있는 레코드는 실패한 입력을 설명합니다. 입력을 get_scraper_details의 sample_input과 비교하고(예: Amazon 제품 URL에는 /dp/가 포함되고 Walmart URL에는 /ip/이 포함됨), 페이지에 공개적으로 액세스할 수 있는지 확인하세요. scrape_as_markdown은 대체 수단으로 동일한 URL에서 작동합니다.

원격 서버 연결 실패

인터넷 연결과 방화벽 설정을 확인하세요.


기여하기

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


지원

채널링크
GitHub 이슈github.com/brightdata-com/brightdata-mcp/issues
문서docs.brightdata.com/ai/mcp-server/overview
이메일support@brightdata.com

라이선스

MIT © Bright Data Ltd.