# @brightdata/mcp 中文文档

规范地址：https://npmcn.com/package/%40brightdata/mcp/

版本：4\.6\.0
npm 元数据更新时间：2026-11-05T11:08:46.392Z
中文译文更新时间：2026-11-08T15:20:20.902Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40brightdata/mcp
原文对照：https://npmcn.com/package/%40brightdata/mcp/?lang=original
项目主页：https://github.com/brightdata/brightdata-mcp#readme
源码仓库：https://github.com/brightdata/brightdata-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：152 kB，21 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：5 个
- 首次发布：2025-04-08T15:00:26.644Z
- 最新版本发布：2026-11-05T11:08:46.081Z
- 近 30 天下载量：67464（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：69（近 12 个月 36 个）

## 中文简介

亮相数据工具集中的 MCP 接口

## 安装

```sh
npm install @brightdata/mcp
```

也可以使用：`pnpm add @brightdata/mcp`、`yarn add @brightdata/mcp`、`bun add @brightdata/mcp`

## README

[![Bright Data Logo](https://github.com/user-attachments/assets/c21b3f7b-7ff1-40c3-b3d8-66706913d62f)](https://brightdata.com/ai/mcp-server)

# 亮数据 MCP

**网页搜索,页面刮取,结构化数据提取,以及浏览器自动化的AI代理和LLMs在"模型上下文协议"之上.**

与AI代理,编码代理,聊天助理以及任何MCP相容客户端合作.

[![npm version](https://img.shields.io/npm/v/@brightdata/mcp?style=flat-square)](https://www.npmjs.com/package/@brightdata/mcp) [![npm downloads](https://img.shields.io/npm/dw/@brightdata/mcp?style=flat-square)](https://www.npmjs.com/package/@brightdata/mcp) [![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/brightdata-com/brightdata-mcp/blob/main/LICENSE)

[快速启动](https://npmcn.com/package/%40brightdata/mcp/#readme-quick-start) 二. 支助 [定价](https://npmcn.com/package/%40brightdata/mcp/#readme-pricing-and-free-tier) 二. 支助 [使用大小写](https://npmcn.com/package/%40brightdata/mcp/#readme-use-cases) 二. 支助 [工具](https://npmcn.com/package/%40brightdata/mcp/#readme-tools-reference-30-tools) 二. 支助 [代理技能](https://npmcn.com/package/%40brightdata/mcp/#readme-agent-skills) 二. 支助 [文档](https://npmcn.com/package/%40brightdata/mcp/#readme-documentation) 二. 支助 [支助](https://npmcn.com/package/%40brightdata/mcp/#readme-support)

**免费等级:每月5 000份申请.** 无需信用卡。 每月更新.

* * *

## 概览

Bright Data MCP服务器允许AI代理实时访问公共网络数据. 它会暴露 **30个工具** 涵盖:

-   **网络搜索** ——Bing和Google结果作为结构化数据
-   **页面刮取** ——任何作为Markdown或HTML的URL,每个请求自动处理有bot检测,CAPTCHA解析,代理旋转
-   **结构化数据(Web Scraper API)** ——从1200+预建的刮取机上清理出JSON:亚马逊,LinkedIn,Instagram,TikTok,YouTube,X,Reddit,Facebook,Crunchbase,Zillow,npm,PyPI等,没有解析HTML. 六道工具找到并运行其中之一
-   **浏览器自动化** ——在远程浏览器会话中导航,点击,打入,截图并读取页面
-   **LLM 响应收集** – 向 ChatGPT 和 Persplexity 发送提示, 并将其答案作为结构化数据返回

每个请求都会通过Bright Data的解屏蔽基础设施来进行路由,因此屏蔽普通HTTP客户端(机器人检测,CAPTCHA,速率限制,地缘限制)的页面通常会返回. 没有代理设置,没有无头浏览器维护,没有重试逻辑可以写入.

两种部署选项:主机远程服务器(一个URL,没有安装)或通过本地实例 `npx @brightdata/mcp`。 。 。 .

* * *

## 快速启动

**主机服务器——没有安装.** 将此 URL 添加到您的 MCP 客户端 :

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

从您的 API 符号 [Bright 数据账户设置](https://brightdata.com/cp/setting/users)新账户每月可收到5 000份免费申请.

可选 URL 参数 :

| 参数 | 说明 | 示例 |
| --- | --- | --- |
| `groups=<ids>` | 限于特定工具组( 默认: 所有工具) | `...&groups=scrapers,browser` |
| `tools=<names>` | 限于特定工具 | `...&tools=search_engine,scrape_as_markdown` |

**克劳德桌面**

1.  转到: 设置 / 连接器 / 添加自定义连接器
2.  名称 : `Bright Data`
3.  URL : `https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN`
4.  点击“ 添加”

或在当地运行 :

```json
{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}
```
**克劳德代码**

```bash
claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
```
**光标**

添加为 `~/.cursor/mcp.json`数字 :

```json
{
  "mcpServers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
```
**VS 代码**

添加为 `.vscode/mcp.json`数字 :

```json
{
  "servers": {
    "brightdata": {
      "type": "http",
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
```
**风起浪起**

添加为 `~/.codeium/windsurf/mcp_config.json`数字 :

```json
{
  "mcpServers": {
    "brightdata": {
      "serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
```
**双子座CLI**

添加为 `~/.gemini/settings.json`数字 :

```json
{
  "mcpServers": {
    "brightdata": {
      "httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
```
**齐德**

添加到您的 Zed 设置 :

```json
{
  "context_servers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
```
**扭曲**

转到设置 > MCP 服务器 > 添加 MCP 程序 服务器并添加:

```json
{
  "brightdata": {
    "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  }
}
```
**其他客户(当地npx)**

对于任何支持本地 MCP 服务器的客户端:

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

* * *

## 定价和自由等级

每个账户包括一个经常性的每月自由级. **不需要信用卡或承诺开始.**

**每月5 000份免费申请**,每月1号续约. 未用请求不会翻转。 对于团队账户,免费分级由账户中的所有用户共享.

包括免费的:

-   获取任何网页并提取为 Markdown
-   为受欢迎领域使用60+预建的刮纸机
-   网页搜索( Bing, Google)
-   网络解锁( 机器人检测绕行、 CAPTCHA 解锁、 代理旋转)
-   浏览器自动化
-   地理目标

在免费级别之外—— 支付,没有承诺:

|  | 搜索、 拼接和提取 | 浏览器导航 |
| --- | --- | --- |
| **随你便** | 1.50美元/1K成果 | 8美元/ GB (单位:千美元) |

-   当免费请求耗尽时,请求停止. 没有意外收费——除非您存了钱
-   添加信用卡仅仅是一个验证步骤; 除非免费等级用完, 否则不收费 **财务报告和审定财务报表** 您有存款
-   设置支出上限 [控制面板](https://brightdata.com/cp) 所以,现收现付的使用 从未超过你的预算

[全面定价、数量计划和企业](https://brightdata.com/pricing/mcp-server)

* * *

## 使用大小写

### 实时研究

使用网上直播数据而不是培训数据回答问题。 搜索,然后读取来源.

| 任务 | 工具 |
| --- | --- |
| 搜索当前信息的网络 | `search_engine`, (中文(简体) ), `search_engine_batch` |
| 读取特定页面为 clean Markdown | `scrape_as_markdown`, (中文(简体) ), `scrape_batch` |

示例提示:"特斯拉的当前股价是多少","纽约今天的天气预报","从过去6个月中寻找欧盟AI条例被引用最多的来源".

### 电子商务情报

将产品数据读取为结构化的JSON:价格,可用性,评级,审查计数,销售者,图像.

| 任务 | 工具 |
| --- | --- |
| 来自亚马逊、沃尔玛、eBay、Best Buy、Etsy、Home Depot、Zara等商店的产品、审查和搜索结果 | `search_scrapers` → `get_scraper_details` → `run_scraper` |
| 跨零售价格视图 | 和Google购物机一样 |

示例提示:"在亚马逊 vs Walmart vs Best Buy上比较这台笔记本电脑的价格","获得ASIN B0D2Q9397Y的评分和评分","这个产品是否在库存".

### 市场和竞争者分析

从活数据构建竞争对手简介:资金,人头统计,聘用,客户审查,定价页面.

| 任务 | 工具 |
| --- | --- |
| 公司供资、规模、雇员、职位分配(Crunchbase、ZoomInfo、Linked) 内) | `search_scrapers` → `run_scraper` |
| 客户情绪(Google地图、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个工具) |

### 编码代理

按需提供一揽子登记数据——不刮取,不 stale缓存.

| 任务 | 工具 |
| --- | --- |
| npm 和 PyPI 软件包版本、 README 、 元数据 | `run_scraper` 与 npmjs 或 pypi 刮取器(用 `search_scrapers`(中文(简体) ) |
| 从 GitHub 仓库读取文件 | `run_scraper` 使用 GitHub 仓库刮取器 |

示例提示:"npm上的快递最新版本是什么?","Get the README for the langchain-brightdata PyPI package".

### 全球环境展望和品牌知名度

向主要 LLMs 发送提示, 并将其答案作为结构化的数据 。 测量AI助手如何描述你的品牌,他们引用哪些来源,以及他们推荐什么——Generative General Engine Optimization的反馈回路.

| 任务 | 工具 |
| --- | --- |
| ChatGPT 有引文和建议的回答 | `chatgpt_ai_insights` |
| 与来源的混淆解答 | `perplexity_ai_insights` |

示例即时:“请问 ChatGPT 和 困惑 ” “ 什么是最佳代理提供者 ” , 并比较每个代理提供者如何对我们进行排序 ”.

### 社交媒体监测

每个主要平台的结构化数据:简介、帖子、评论、参与度量表。 每个平台每个数据类型都有刮发器(链接) 在剖面图中,Instagram reels, TikTok 注释, ; 用 `search_scrapers` 和运行他们在一起 `run_scraper`。 。 。 .

| 平台 | 刮刮机的例子 |
| --- | --- |
| 链接 | 个人简介、公司简介、职务上市、职位、人员查询 |
| 内存 | 简介、帖子、相册、评论 |
| 叮当 | 简介、帖子、商店、评论 |
| 脸书 | 概况、员额、市场上市、公司审查、活动 |
| YouTube (英语) | 视频、频道、评论 |
| X (转动) | 按概况分列的员额 |
| 编辑 | 员额、评论 |

示例提示:"从TikTok简介中获取最后10个帖子并总结约定".

### 内容创建和学术研究

一次从多页中收集源材料,经过审慎性和相关性过滤.

| 任务 | 工具 |
| --- | --- |
| 在一个呼叫中收集多个来源 | `scrape_batch` (最多5个URL) |
| 二. 新闻和财务数据 | `search_engine` 有新闻查询, `run_scraper` 与雅虎金融刮刀 |

* * *

## 如何比较

| 能力 | 亮数据 MCP | 典型的网络 MCP 服务器 |
| --- | --- | --- |
| 工具共计 | 30个 | 2 - 10岁 |
| 平台特定结构的 JSON 提取器 | 1 200多台通过6个工具在电子商务、社会、商业、金融、旅行、应用商店进行预建的刮刮机 | 稀有; 普通刮取 |
| 解锁( 机器人检测绕行、 CAPTCHA 解析、 代理旋转) | 每个请求都包含在内 | 通常无; 在受保护地点被封锁 |
| 搜索引擎 | 宾,谷歌 | 通常一个 |
| 浏览器自动化 | 14个工具, 远程浏览器, 没有本地设置 | 有限或无 |
| LLM 响应收集( ChatGPT, 复杂度) | 对 | 未提供 |
| 软件包注册数据( 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`
-   组合标识 `custom` 保留; 使用 `TOOLS` 个人选择

| 组合标识 | 目录 | 工具计数 |
| --- | --- | --- |
| `scrapers` | 搜索和运行任何预建的 Web Scraper API 刮取器(Amazon, LinkedIn, TikTok, npm,...) | 6个 |
| `browser` | 远程浏览器自动化 | 页:1 |
| `geo` | ChatGPT 和 复杂度反应收集 | 2个 |
| `advanced_scraping` | 批量工具、 会话统计 | 3个 |

老年群体身份证`ecommerce`, (中文(简体) ), `social`, (中文(简体) ), `business`, (中文(简体) ), `finance`, (中文(简体) ), `research`, (中文(简体) ), `app_stores`, (中文(简体) ), `travel`, (中文(简体) ), `code`仍然在工作,并使 `scrapers` 工具; `social` 财务报告和审定财务报表 `business` 也添加 `search_dataset` 财务报告和审定财务报表 `list_dataset_fields`旧 `web_data_*` 名称在 `TOOLS` 启用 `scrapers` 工具也一样.

### 配置示例

具有浏览器自动化和批量工具的本地服务器 :

```json
{
  "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 数据通过预建的刮取器:

```json
{
  "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 语言 :** `scrape_as_markdown` 与 `format: 'html'`
-   **页面需要交互( 单击、 键入、 滚动、 登录) :** `scraping_browser_*` 工具
-   **ChatGPT/复杂度如何回答一个提示:** `chatgpt_ai_insights` 编号 : `perplexity_ai_insights`
-   **关于亮数据本身的问题(产品、区域、出错、设置):** `ask_brightdata_assistant`

关于刮刮机运行的说明 :

-   返回结构化的JSON,每回记录计费
-   记录 `error` 字段解释失败的输入,例如错误类型的 URL
-   结果可能很大。 保留 `limit_per_input` 低额 `discover_by_*` 在您框架支持的子剂中使用方法和运行批量收集, 因此记录不会淹没主上下文窗口
-   如果运行失败, `scrape_as_markdown` 运行于一个倒置的 URL

**搜索和搜索——5个工具**

| 工具 | 说明 | 组 |
| --- | --- | --- |
| `search_engine` | 搜索宾(默认)或谷歌. Return JSON (link, title, description),每页10个结果. 参数 : `country`, (中文(简体) ), `page` (从.), `time_range` (单位:千美元)`hour`, (中文(简体) ), `day`, (中文(简体) ), `week`, (中文(简体) ), `month`, (中文(简体) ), `year`, (中文(简体) ), `any`; Bing 仅支持 `day`, (中文(简体) ), `week`, (中文(简体) ), `year`(中文(简体) ) | 默认 / 每个组 |
| `search_engine_batch` | 一个电话中最多5个搜索查询 | 默认 / `advanced_scraping` |
| `scrape_as_markdown` | 任意URL. 返回内容为下标( 默认)、 文本、 html 或 ld json | 默认 / 每个组 |
| `scrape_batch` | 一个呼叫中最多有5个URL. 返回内容为下标( 默认)、 文本、 html 或 ld json | 默认 / `advanced_scraping` |
| `session_stats` | 本届会议的工具使用量计数 | 默认 / `advanced_scraping` |

**Web Scraper API - 6个工具**

搜索并运行任何Bright Data的1200+预建的刮发机. 刮发器列表来自 `docs.brightdata.com/scrapers.json` 并每天更新。 无论是主机还是本地服务器都可用 。 未选择工具或组时默认启用; 否则添加 `scrapers` 组`&groups=scrapers` 在主机URL上, `GROUPS=scrapers` (当地).

典型流量 : `search_scrapers` → `get_scraper_details` → `run_scraper`运行费用按记录计费; `discover_by_*` 方法收集最多为 `limit_per_input` 每个输入记录( 默认 10) .

| 工具 | 说明 | 组 |
| --- | --- | --- |
| `search_scrapers` | 按站点或数据类型(如"亚马逊评论","linkin.com")查找刮取器. 返回数据集ID、名称、域和收集方法 | 默认 / `scrapers` |
| `get_scraper_details` | 描述、输入字段、实例输入和一种刮取方法的主要输出字段 | 默认 / `scrapers` |
| `run_scraper` | 采用刮刮法. 等待最多45秒;如果还在运行,返回 a `snapshot_id` 稍后检查 | 默认 / `scrapers` |
| `get_scraper_progress` | 运行状态: 启动、 运行、 准备、 失败或取消 | 默认 / `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简介页面,列出互动元素与 refs. 在基于裁判的行动之前必须 |
| `scraping_browser_click_ref` | 通过从最新快照读取来单击元素 |
| `scraping_browser_type_ref` | 以 ref 键入元素; 可选择按 Enter 键提交 |
| `scraping_browser_fill_form` | 在一个调用中通过参考填入多个窗体字段 |
| `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 动作前取出新的快照. 对于静态页面, `scrape_as_markdown` 要比浏览器会话更快、更便宜.

**GEO和LLM能见度——2个工具**

| 工具 | 投入 | 回返 |
| --- | --- | --- |
| `chatgpt_ai_insights` | 提示 | ChatGPT 作为 Markdown 的答案 |
| `perplexity_ai_insights` | 提示 | 疑惑的答案是马克下 |

用于基因引擎优化(跟踪LLMs如何描述你的品牌)和LLM-as-a-judge工作流程.

**数据集搜索——2个工具**

过滤器搜索已存储的 LinkedIn 数据集; 立即返回匹配记录, 不运行 .

| 工具 | 说明 | 组 |
| --- | --- | --- |
| `list_dataset_fields` | 数据集的可过滤字段(名称、类型、描述)。 打电话之前 `search_dataset` | 默认 / `social`, (中文(简体) ), `business` |
| `search_dataset` | 匹配过滤器的记录,每个调用最多可有10个,并带有更多光标 | 默认 / `social`, (中文(简体) ), `business` |

**亮度数据助理——1个工具**

| 工具 | 说明 | 组 |
| --- | --- | --- |
| `ask_brightdata_assistant` | 询问Sophie,Bright Data的支持助手,关于产品,API,区,出错或账户设置. 传回 `dialog_id` 以询问同一线索中的后续 | 默认 / 每个组 |

[文件中的完整工具参考](https://docs.brightdata.com/ai/mcp-server/tools)

* * *

## 代理技能

准备使用技能, 教会您的代理如何正确使用 MCP 服务器 。 全部的收藏 生活在这里 [github.com/brightdata/技能 互联网档案馆的存檔,存档日期2013-12-02](https://github.com/brightdata/skills) ——21个技能,包括MCP管弦乐,竞争性智能,价格比较,品牌收听,SEO审计,刮取器建筑,RAG管线等.

三种影响最大的技能:

| 技能 | 它会做什么 |
| --- | --- |
| [亮数据- mcp](https://github.com/brightdata/skills/tree/main/skills/bright-data-mcp) | 让Bright Data MCP 成为所有网页数据操作的默认, 替换 WebFetch, WebSearch, 以及其他在bot 检测上失败的内置网络工具 |
| [竞争性英特尔](https://github.com/brightdata/skills/tree/main/skills/competitive-intel) | 竞争者快照、价格比较、审查采矿、雇用信号、内容/标准电子数据分析以及网上直播数据的市场景观图 |
| [价格比较](https://github.com/brightdata/skills/tree/main/skills/price-comparison) | 解决横跨亚马逊、沃尔玛、eBay、Best Buy、Google购物的产品 |

[浏览所有21个技能 ~](https://github.com/brightdata/skills)

* * *

## 配置

### 基本设置(当地)

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

### 高级配置

```json
{
  "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` | 您的亮数据 API 令牌( 需要) | \- 说吧 | `your-token-here` |
| `RATE_LIMIT` | 自定义利率限制 | 无限制 | `100/1h`, (中文(简体) ), `50/30m` |
| `SERP_ZONE` | 自定义搜索工具使用的 SERP API 区名 | `mcp_serp` | `my_serp_zone` |
| `BROWSER_ZONE` | 自定义浏览器区名 | `mcp_browser` | `my_browser_zone` |
| `CONTENT_GATE` | 当一个数据工具返回的页面内容看起来像指令来更改MCP配置时,服务器在返回之前先询问用户(通过MCP引出). 设定为 `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配置(文档,READMEs)自然会被提示. 客户 不支持 MCP 引出不包含匹配内容; 设置 `CONTENT_GATE=off` 狦 接受风险。 当服务器等待您的答案时, 它报告进度; 客户端没有 延长其进度工具超时时间将限制等待时间 `CONTENT_GATE_TIMEOUT` 是服务器侧的旋钮 。 浏览器工具没有覆盖 .

* * *

## 文档

| 资源 | 链接 |
| --- | --- |
| API 文档 | [docs.brightdata.com/ai/mcp-服务器/概览](https://docs.brightdata.com/ai/mcp-server/overview) |
| 完整工具参考 | [docs.brightdata.com/ai/mcp-服务器/工具](https://docs.brightdata.com/ai/mcp-server/tools) |
| 代理技能 | [github.com/brightdata/技能 互联网档案馆的存檔,存档日期2013-12-02](https://github.com/brightdata/skills) |
| 用法实例 | [实例](https://github.com/brightdata-com/brightdata-mcp/blob/main/examples) |
| 更改日志 | [变动情况](https://github.com/brightdata-com/brightdata-mcp/blob/main/CHANGELOG.md) |

* * *

## 解决问题

**共同问题和解决办法**

### “ sprawn npx ENOENT” 错误

安装节点( Node.js), 或使用节点的全部路径 :

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

### 复杂地点超时

将客户端设置中的超时时间增加到 180 个 .

### 认证问题

校验您的 API 令牌是有效的, 并具有所需的权限 。 控件在 [账户设置](https://brightdata.com/cp/setting/users)。 。 。 .

### run scraper 返回错误或没有数据

记录 `error` 字段解释失败的输入。 比较您的输入 `sample_input` 从 `get_scraper_details` (例如,亚马逊产品URL包含: `/dp/`沃尔玛 `/ip/`),并检查页面可公开访问. `scrape_as_markdown` 与倒计时器相同.

### 远程服务器连接失败

检查您的互联网连接和防火墙设置 .

* * *

## 捐款

-   [报告错误](https://github.com/brightdata-com/brightdata-mcp/issues)
-   [建议的特性](https://github.com/brightdata-com/brightdata-mcp/issues)
-   [提交 PR](https://github.com/brightdata-com/brightdata-mcp/pulls)

请跟随 [亮数据编码标准](https://brightdata.com/dna/js_code)。 。 。 .

* * *

## 支助

| 频道 | 链接 |
| --- | --- |
| GitHub 问题 | [github.com/brightdata-com/brightdata-mcp/问题](https://github.com/brightdata-com/brightdata-mcp/issues) |
| 文档 | [docs.brightdata.com/ai/mcp-服务器/概览](https://docs.brightdata.com/ai/mcp-server/overview) |
| 电子邮件 | [支持@brightdata.com](mailto:support@brightdata.com) |

* * *

## 许可证

麻省理工学院 [光明数据有限公司.](https://brightdata.com/)

## 常见问题

### @brightdata/mcp 是什么？

亮相数据工具集中的 MCP 接口

### 如何安装 @brightdata/mcp？

在项目目录运行 npm install @brightdata/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp，可以用 npx mcp 直接运行。

### @brightdata/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/brightdata\_\_mcp 是否存在。

### @brightdata/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @brightdata/mcp 可以商用吗？

@brightdata/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @brightdata/mcp 的下载量有多少？

根据 npm 官方下载统计，@brightdata/mcp 在 2026/10/09 – 2026/11/07 这 30 天内被下载 67,464 次，日均约 2,249 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @brightdata/mcp 还在维护吗？

最新版本 4\.6\.0 发布于 2026/11/05（3 天前）；至今共发布 69 个版本，其中过去 12 个月发布了 36 个；首次发布于 2025/04/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。