Bright Data

官方

发现、提取并与网络交互——一个接口驱动对公共互联网的自动化访问。

你可以用 Bright Data MCP 做什么?

  • 网页搜索 — 让你的助手运行 Bing 或 Google 搜索,并返回包含链接、标题和描述的结构化结果。
  • 页面抓取 — 将任意 URL 获取为整洁的 Markdown、文本、HTML 或 ld_json,并内置机器人检测和 CAPTCHA 处理功能。
  • 结构化平台数据 — 查找并运行适用于 Amazon、LinkedIn、TikTok 和 npm 等网站的预构建抓取器,获取整洁的 JSON,而无需解析 HTML。
  • 浏览器自动化 — 在远程浏览器会话中浏览、点击、输入、滚动并截取页面,以处理交互式网站或需要登录的网站。
  • LLM 答案收集 — 向 ChatGPT 或 Perplexity 发送提示词并获取回答,以比较它们各自如何描述某个品牌。
  • 批量采集 — 单次调用最多运行 5 次搜索或抓取 5 个 URL,以并行收集数据。

文档

Bright Data Logo

Bright Data MCP

通过模型上下文协议,为 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) — 从 1,200 多个预构建抓取器获取干净的 JSON 数据,涵盖 Amazon、LinkedIn、Instagram、TikTok、YouTube、X、Reddit、Facebook、Crunchbase、Zillow、npm、PyPI 等,无需解析 HTML。六种工具可查找并运行任意抓取器
  • 浏览器自动化 — 在远程浏览器会话中导航、点击、输入、截屏和读取页面
  • 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"
  }
}
其他客户端(本地 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、轮换代理)
  • 浏览器自动化
  • 地理定位

超出免费套餐后 — 按量付费,无需承诺:

搜索、抓取和提取浏览器导航
按量付费每 1K 条结果 $1.50每 GB $8
  • 免费请求用完后,请求将停止。不会产生意外费用 — 除非你已存入资金
  • 添加信用卡仅用于验证;只有在免费额度用尽且账户中有存入资金时才会扣费
  • 在控制面板中设置支出上限,确保按量付费的使用金额不会超出预算

查看完整定价、批量套餐和企业方案 →


使用场景

实时研究

使用实时网络数据而非训练数据回答问题。先搜索,再阅读来源。

任务工具
搜索网络以获取最新信息search_engine, search_engine_batch
将指定页面读取为干净的 Markdownscrape_as_markdown, scrape_batch

提示示例:“特斯拉当前股价是多少?”、“获取纽约今天的天气预报”、“查找过去 6 个月欧盟 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 智能体

替换在受保护网站上会被拦截的内置抓取/搜索工具。每个请求都会通过解封基础设施,因此智能体不会因机器人检测、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 仓库抓取器调用 run_scraper

提示示例:“npm 上 express 的最新版本是什么?”、“获取 langchain-brightdata PyPI 软件包的 README”。

GEO 和品牌曝光度

向主流 LLM 发送提示,并以结构化数据形式获取回答。衡量 AI 助手如何描述你的品牌、引用哪些来源以及推荐什么 — 为生成式引擎优化提供反馈闭环。

任务工具
获取包含引用和推荐内容的 ChatGPT 回答chatgpt_ai_insights
获取包含来源的 Perplexity 回答perplexity_ai_insights

提示示例:“向 ChatGPT 和 Perplexity 提问‘最好的代理服务提供商是什么’,并比较它们如何为我们排名”。

社交媒体监控

从各大平台获取结构化数据:个人资料、帖子、评论和互动指标。每个平台都针对不同数据类型提供抓取器(LinkedIn 个人资料、Instagram Reels、TikTok 评论等);使用 search_scrapers 查找抓取器,并使用 run_scraper 运行。

平台抓取器示例
LinkedIn个人资料、公司资料、职位列表、帖子、人员搜索
Instagram个人资料、帖子、Reels、评论
TikTok个人资料、帖子、商店、评论
Facebook个人资料、帖子、Marketplace 列表、公司评论、活动
YouTube视频、频道、评论
X (Twitter)帖子、按个人资料筛选的帖子
Reddit帖子、评论

提示示例:“获取此 TikTok 个人资料最近的 10 条帖子,并总结互动情况”。

内容创作和学术研究

一次收集多个页面的来源资料,并按时效性和相关性筛选。

任务工具
一次调用收集多个来源scrape_batch(最多 5 个 URL)
新闻和金融数据使用新闻查询调用 search_engine,使用 Yahoo Finance 抓取器调用 run_scraper

对比

功能Bright Data MCP常见网页 MCP 服务器
工具总数302–10
平台专用结构化 JSON 提取器通过 6 种工具提供 1,200 多个预构建抓取器,涵盖电商、社交、商业、金融、旅游和应用商店少见;通常仅提供通用抓取
解封(绕过机器人检测、解决 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 | Group 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。旧版 web_data_* 名称在 TOOLS 中也可启用 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一次调用最多处理 5 个 URL。以 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页面 ARIA 快照,列出带有 ref 的交互元素。按 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 助手 — 1 个工具
工具描述组
ask_brightdata_assistant向 Bright Data 支持助手 Sophie 咨询产品、API、区域、错误或账户设置。传入返回的 dialog_id,即可在同一对话中提出后续问题默认 / 所有组

文档中的完整工具参考 →


Agent Skills

可直接使用的技能,帮助你的代理正确使用此 MCP 服务器。完整技能集位于 github.com/brightdata/skills,包含 21 项技能,涵盖 MCP 编排、竞争情报、价格比较、品牌舆情、SEO 审核、抓取器构建、RAG 管道等。

以下是影响力最大的三项技能:

技能功能
bright-data-mcp将 Bright Data MCP 设为所有 Web 数据操作的默认工具,取代在机器人检测面前失效的 WebFetch、WebSearch 和其他内置 Web 工具
competitive-intel基于实时 Web 数据生成竞争对手快照、价格比较、评论挖掘、招聘信号、内容/SEO 分析和市场格局图
price-comparison在 Amazon、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_TOKEN你的 Bright Data API 令牌(必填)-your-token-here
RATE_LIMIT自定义速率限制unlimited100/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
Agent 技能github.com/brightdata/skills
使用示例示例
更新日志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 字段的记录会说明哪些输入未能成功处理。将你的输入与 sample_input 中的 get_scraper_details 进行比较(例如,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.