mcpField
B
Bright Data MCP

Bright Data MCP

本地服务
brightdata.com数据与分析2.7k2 天前更新

关于 Bright Data MCP

Bright Data MCP 为 AI Agent 和 MCP 客户端提供网页搜索、抓取、结构化数据提取及浏览器自动化工具。它支持托管远程服务和本地运行,并通过网页解锁基础设施处理请求。

主要功能

  1. 01搜索 Google、Bing 和 Yandex
  2. 02将网页抓取为 Markdown 或 HTML
  3. 03通过抓取器提取结构化数据
  4. 04自动操作远程浏览器会话
  5. 05收集 ChatGPT 和 Perplexity 的回答
  6. 06按组或名称选择工具

适用场景

  1. 01结合网页来源研究当前话题
  2. 02比较商品价格与库存情况
  3. 03分析公司及竞争对手信息
  4. 04收集社交媒体帖子和互动数据

MCP 相关

该 MCP 服务提供网页搜索、抓取、结构化数据提取、浏览器自动化及 LLM 回答收集工具。可作为托管远程服务使用,也可通过 `npx @brightdata/mcp` 在本地运行。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"brightdata": {
"command": "npx",
"args": [
"-y",
"@brightdata/mcp"
],
"env": {
"API_TOKEN": "<API_TOKEN>",
"WEB_UNLOCKER_ZONE": "<WEB_UNLOCKER_ZONE>",
"BROWSER_AUTH": "<BROWSER_AUTH>"
}
}
}
}
启动命令npx -y @brightdata/mcp
需要配置的环境变量
API_TOKEN密钥
WEB_UNLOCKER_ZONE
BROWSER_AUTH密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@brightdata/mcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Bright Data 徽标

Bright Data MCP

通过 Model Context Protocol,为 AI Agent 和大模型提供网页搜索、页面抓取、结构化数据提取和浏览器自动化功能。

适用于 AI Agent、编码 Agent、聊天助手和任何兼容 MCP 的客户端。

npm 版本 npm 下载量 许可证

快速开始 • 定价 • 使用场景 • 工具 • Agent 技能 • 文档 • 支持

免费套餐:每月 5,000 次请求。无需信用卡。每月续期。


概述

Bright Data MCP 服务让 AI Agent 实时访问公开网页数据。它提供 32 个工具,涵盖:

  • 网页搜索 — 将 Google、Bing 和 Yandex 的搜索结果作为结构化数据返回
  • 页面抓取 — 将任意 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 多个面向热门域名的预构建抓取工具
  • 网页搜索(Google、Bing、Yandex)
  • 网页解锁(绕过机器人检测、解决 CAPTCHA、轮换代理)
  • 浏览器自动化
  • 地理位置定位

超出免费额度后——按用量付费,无须承诺:

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

完整定价、批量方案和企业版 →


使用场景

实时研究

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

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

提示词示例:“Tesla 当前股价是多少?”,“获取纽约今天的天气预报”,“查找过去 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 Agent

替换在受保护网站上容易被拦截的内置抓取/搜索工具。每个请求都会通过解封基础设施,因此 Agent 不会因机器人检测、CAPTCHA 或地理限制而失败。

任务工具
内置网络搜索工具的即插即用替代方案search_engine
内置 URL 抓取工具的即插即用替代方案scrape_as_markdown
并行收集数据(一次最多 10 项)search_engine_batch、scrape_batch
交互式网站(登录墙、无限滚动、动态内容)scraping_browser_*(14 个工具)
从任意页面提取结构化 JSON,无需定义架构extract
编码 Agent

按需获取软件包注册表数据——无需抓取,也没有过期缓存。

任务工具
npm 和 PyPI 软件包版本、README、元数据使用 npmjs 或 pypi 抓取器运行 run_scraper(通过 search_scrapers 查找)
读取 GitHub 仓库中的文件使用 GitHub 仓库抓取器运行 run_scraper

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

GEO 与品牌曝光度

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

任务工具
ChatGPT 的回答、引用和推荐chatgpt_ai_insights
Perplexity 的回答和来源perplexity_ai_insights

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

社交媒体监控

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

平台抓取器示例
LinkedIn个人资料、公司资料、职位列表、帖子、人物搜索
Instagram个人资料、帖子、Reels、评论
TikTok个人资料、帖子、商城、评论
Facebook个人资料、帖子、商城列表、公司评价、活动
YouTube视频、频道、评论
X (Twitter)帖子、按个人资料查找帖子
Reddit帖子、评论

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

内容创作与学术研究

一次从多个页面收集素材,并按时效性和相关性筛选。

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

对比情况

功能Bright Data MCP常见的 Web MCP 服务
工具总数322–10
平台专用结构化 JSON 提取器通过 6 个工具提供 1,200 多个适用于电商、社交、商业、金融、旅游和应用商店的预构建抓取器很少;通常仅支持通用抓取
解封(绕过机器人检测、解决 CAPTCHA、轮换代理)内置于每个请求中通常不具备;受保护的网站会拦截请求
搜索引擎Google、Bing、Yandex通常只有一个
浏览器自动化14 个工具、远程浏览器、无需本地设置功能有限或不支持
LLM 回复收集(ChatGPT、Perplexity)支持不提供
软件包注册表数据(npm、PyPI)支持不提供
批量操作每次调用可进行 10 次搜索或 10 次抓取通常仅支持单次请求
地理定位支持功能有限或不支持
免费套餐每月 5,000 次请求,包含浏览器自动化,无需信用卡因服务而异;通常是有速率限制的免密钥访问

工具选择:分组

工具按组组织,让你只需加载所需工具。工具越少,Agent 需要处理的上下文就越少。

  • 不设置 GROUPS 或 TOOLS 时,会启用全部 32 个工具。设置其中任意一个后,服务器只会启用指定的工具
  • GROUPS 用于启用工具包。多个组以逗号分隔:GROUPS="scrapers,browser"(本地)或 &groups=scrapers,browser(托管 URL)
  • TOOLS 用于额外添加单个工具:TOOLS="extract,scrape_as_html"。单独设置时,只会启用你列出的工具
  • 每个组还会包含 search_engine、scrape_as_markdown 和 ask_brightdata_assistant
  • 组 ID custom 为保留项;如需单独选择工具,请使用 TOOLS
组 ID内容工具数
scrapers搜索并运行任意预构建的 Web Scraper API 抓取器(Amazon、LinkedIn、TikTok、npm 等)6
browser远程浏览器自动化14
geoChatGPT 和 Perplexity 回复收集2
advanced_scraping批量工具、HTML 抓取、AI 提取、会话统计5

旧组 ID(ecommerce、social、business、finance、research、app_stores、travel、code)仍可使用,并会启用 scrapers 工具;social 和 business 还会添加 search_dataset 和 list_dataset_fields。在 TOOLS 中使用旧版 web_data_* 名称,也会启用 scrapers 工具。

配置示例

启用浏览器自动化和 AI 提取的本地服务器:

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

编码 Agent 配置(Claude Code / Cursor / Windsurf)——通过预构建抓取器获取 npm、PyPI 和 GitHub 数据:

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

工具参考(32 个工具)

选择合适的工具
  • 已知 URL,需要获取内容: scrape_as_markdown。多个 URL(最多 10 个):scrape_batch
  • 需要查找信息: search_engine。多个查询(最多 10 个):search_engine_batch
  • 获取已知平台的结构化数据(Amazon、LinkedIn、TikTok、npm、PyPI 等): search_scrapers → get_scraper_details → run_scraper — 返回整洁的 JSON,速度比抓取同一页面更快、可靠性也更高
  • 获取没有对应抓取器的页面的结构化 JSON: extract
  • 获取原始 HTML: scrape_as_html
  • 页面需要交互(点击、输入、滚动、登录): scraping_browser_* 工具
  • 了解 ChatGPT/Perplexity 如何回答提示词: chatgpt_ai_insights / perplexity_ai_insights
  • 询问 Bright Data 本身的问题(产品、区域、错误、设置): ask_brightdata_assistant

关于抓取器运行的说明:

  • 返回结构化 JSON,并按返回的记录数计费
  • 带有 error 字段的记录会说明失败的输入,例如类型错误的 URL
  • 结果可能很大。对于 discover_by_* 方法,请将 limit_per_input 设得较低;如果你的框架支持在子 Agent 中执行批量采集,也请使用此方式,以免记录充斥主上下文窗口
  • 如果运行失败,可对同一 URL 使用 scrape_as_markdown 作为备用方案
搜索与抓取 — 7 个工具 | 工具 | 描述 | 分组 | |------|-------------|-------| | `search_engine` | 搜索 Google、Bing 或 Yandex。Google 返回 JSON(URL、标题、描述);Bing 和 Yandex 返回 Markdown。使用 `cursor` 参数翻页 | default / 每个分组 | | `search_engine_batch` | 一次调用最多执行 10 个搜索查询 | default / `advanced_scraping` | | `scrape_as_markdown` | 将任意 URL 转换为 Markdown。自动处理机器人防护和 CAPTCHA | default / 每个分组 | | `scrape_batch` | 一次调用最多处理 10 个 URL;以 Markdown 返回 URL/内容对数组 | default / `advanced_scraping` | | `scrape_as_html` | 获取任意 URL 的原始 HTML | default / `advanced_scraping` | | `extract` | 抓取页面并使用 AI 将其转换为结构化 JSON,可选自定义提取提示词 | default / `advanced_scraping` | | `session_stats` | 当前会话的工具使用次数 | default / `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、名称、域名和采集方法default / scrapers
get_scraper_details获取某个抓取器方法的描述、输入字段、输入示例和主要输出字段default / scrapers
run_scraper运行抓取器方法。最多等待 45 秒;若仍在运行,则返回可供稍后查询的 snapshot_iddefault / scrapers
get_scraper_progress查看运行状态:starting、running、ready、failed 或 canceleddefault / scrapers
get_scraper_results获取已完成运行的记录default / scrapers
refresh_scrapers立即重新加载抓取器列表,无需等待每日刷新default / 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 和大模型可见度 — 2 个工具
工具输入返回内容
chatgpt_ai_insights提示词ChatGPT 的回答(Markdown 格式)
perplexity_ai_insights提示词Perplexity 的回答(Markdown 格式)

用于生成式引擎优化(追踪大模型如何描述你的品牌)和大模型裁判工作流。

数据集搜索 — 2 个工具

对存储的 LinkedIn 数据集进行筛选搜索;一次返回匹配记录,不会运行抓取器。

工具描述组
list_dataset_fields数据集可筛选的字段(名称、类型、描述)。在 search_dataset 前调用default / social、business
search_dataset与筛选条件匹配的记录,每次最多 10 条;可使用游标获取更多default / social、business
Bright Data 助手 — 1 个工具
工具描述组
ask_brightdata_assistant向 Bright Data 的支持助手 Sophie 询问产品、API、区域、错误或账户设置。传入返回的 dialog_id,即可在同一对话中继续提问default / 所有组

查看文档中的完整工具参考 →


Agent 技能

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

以下是其中三个影响力最大的技能:

技能功能
bright-data-mcp将 Bright Data MCP 设为所有网页数据操作的默认工具,替代 WebFetch、WebSearch 和其他内置网页工具,解决这些工具无法通过机器人检测的问题
competitive-intel基于实时网页数据,提供竞争对手概况、价格比较、评论挖掘、招聘信号、内容/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",
        "WEB_UNLOCKER_ZONE": "custom",
        "BROWSER_ZONE": "custom_browser"
      }
    }
  }
}
环境变量
变量说明默认值示例
API_TOKEN你的 Bright Data API 令牌(必需)-your-token-here
RATE_LIMIT自定义速率限制不限100/1h、50/30m
WEB_UNLOCKER_ZONE自定义 Web Unlocker 区域名称mcp_unlockermy_custom_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以逗号分隔的单个工具名称。将服务限制为这些工具所有工具extract,scrape_as_html
内容检查门

scrape_as_markdown、search_engine、extract 及其批量变体会返回网页上的内容。如果这些内容中包含看起来像是要求更改 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
使用示例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
电子邮件[email protected]

许可证

MIT © Bright Data Ltd.

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。