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 MCP
Model Context Protocol을 통해 AI 에이전트와 LLM에 웹 검색, 페이지 스크래핑, 구조화된 데이터 추출 및 브라우저 자동화를 제공합니다.
AI 에이전트, 코딩 에이전트, 채팅 어시스턴트 및 MCP 호환 클라이언트와 함께 사용할 수 있습니다.
빠른 시작 • 요금 • 사용 사례 • 도구 • 에이전트 스킬 • 문서 • 지원
무료 요금제: 월 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
- 이동: Settings → Connectors → Add custom connector
- 이름:
Bright Data - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - "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.50 | GB당 $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로 실행하세요.
| 플랫폼 | 스크래퍼 예시 |
|---|---|
| 개인 프로필, 회사 프로필, 채용 공고, 게시물, 사람 검색 | |
| 프로필, 게시물, 릴스, 댓글 | |
| TikTok | 프로필, 게시물, 쇼핑, 댓글 |
| 프로필, 게시물, 마켓플레이스 목록, 회사 리뷰, 이벤트 | |
| YouTube | 동영상, 채널, 댓글 |
| X (Twitter) | 게시물, 프로필별 게시물 |
| 게시물, 댓글 |
프롬프트 예시: "이 TikTok 프로필의 최근 게시물 10개를 가져와 참여도를 요약해줘".
콘텐츠 제작 및 학술 연구
최신성 및 관련성 기준으로 필터링해 여러 페이지에서 한 번에 자료를 수집하세요.
| 작업 | 도구 |
|---|---|
| 한 번의 호출로 여러 출처 수집 | scrape_batch(최대 URL 5개) |
| 뉴스 및 금융 데이터 | 뉴스 검색어와 함께 search_engine, Yahoo Finance 스크래퍼와 함께 run_scraper |
비교
| 기능 | Bright Data MCP | 일반적인 웹 MCP 서버 |
|---|---|---|
| 전체 도구 수 | 30 | 2–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_engine | Bing(기본값) 또는 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_snapshot | ref가 포함된 페이지의 ARIA 스냅샷을 생성합니다. ref 기반 작업 전에 필요합니다. |
scraping_browser_click_ref | 최신 스냅샷의 ref로 요소를 클릭합니다. |
scraping_browser_type_ref | ref로 요소에 입력합니다. 선택적으로 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_assistant | Bright Data의 지원 어시스턴트 Sophie에게 제품, API, 존, 오류 또는 계정 설정에 관해 질문합니다. 반환된 dialog_id을 전달하면 같은 스레드에서 후속 질문을 할 수 있습니다. | 기본값 / 모든 그룹 |
에이전트 스킬
에이전트가 이 MCP 서버를 올바르게 사용하도록 안내하는 즉시 사용 가능한 스킬입니다. 전체 모음은 github.com/brightdata/skills에 있으며, MCP 오케스트레이션, 경쟁 정보, 가격 비교, 브랜드 모니터링, SEO 감사, 스크레이퍼 구축, RAG 파이프라인 등을 다루는 스킬 21개가 포함되어 있습니다.
가장 효과가 큰 스킬 세 가지:
| 스킬 | 기능 |
|---|---|
| bright-data-mcp | Bright Data MCP를 모든 웹 데이터 작업의 기본 도구로 설정합니다. 봇 감지로 실패하는 WebFetch, WebSearch 및 기타 내장 웹 도구를 대체합니다. |
| competitive-intel | 실시간 웹 데이터로 경쟁사 현황, 가격 비교, 리뷰 분석, 채용 신호, 콘텐츠/SEO 분석 및 시장 환경 지도를 제공합니다. |
| price-comparison | Amazon, Walmart, eBay, Best Buy 및 Google Shopping에서 제품을 찾아 가장 저렴한 재고 보유 옵션을 알려줍니다. |
구성
기본 설정(로컬)
{
"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_TOKEN | Bright Data API 토큰(필수) | - | your-token-here |
RATE_LIMIT | 사용자 지정 속도 제한 | 무제한 | 100/1h, 50/30m |
SERP_ZONE | 검색 도구에서 사용하는 사용자 지정 SERP API 존 이름 | mcp_serp | my_serp_zone |
BROWSER_ZONE | 사용자 지정 Browser 존 이름 | mcp_browser | my_browser_zone |
CONTENT_GATE | 데이터 도구가 반환한 페이지 콘텐츠가 MCP 구성을 변경하라는 지시처럼 보이면, 서버는 콘텐츠를 반환하기 전에 MCP elicitation을 통해 사용자에게 확인합니다. 비활성화하려면 off로 설정하세요. | on | off |
CONTENT_GATE_TIMEOUT | 콘텐츠를 보류하기 전에 사용자 응답을 기다리는 시간(초) | 120 | 60, 300 |
BROWSER_FILTERED_SNAPSHOT | scraping_browser_snapshot에는 버튼, 링크 및 필드만 표시됩니다. 토큰을 절약하고 페이지 텍스트가 클릭 가능한 요소인 것처럼 가장하는 것을 방지합니다(민감한 작업에 유용). 필요한 경우 scraping_browser_get_text로 페이지 텍스트를 읽을 수 있습니다. | off | on |
BASE_TIMEOUT | 기본 도구(검색 및 스크레이핑)의 요청 시간 제한(초) | 제한 없음 | 60, 120 |
BASE_MAX_RETRIES | 일시적 오류 발생 시 기본 도구의 최대 재시도 횟수(0-3) | 0 | 1, 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.