关于 Bright Data MCP
Bright Data MCP 为 AI Agent 和 MCP 客户端提供网页搜索、抓取、结构化数据提取及浏览器自动化工具。它支持托管远程服务和本地运行,并通过网页解锁基础设施处理请求。
主要功能
- 01搜索 Google、Bing 和 Yandex
- 02将网页抓取为 Markdown 或 HTML
- 03通过抓取器提取结构化数据
- 04自动操作远程浏览器会话
- 05收集 ChatGPT 和 Perplexity 的回答
- 06按组或名称选择工具
适用场景
- 01结合网页来源研究当前话题
- 02比较商品价格与库存情况
- 03分析公司及竞争对手信息
- 04收集社交媒体帖子和互动数据
MCP 相关
该 MCP 服务提供网页搜索、抓取、结构化数据提取、浏览器自动化及 LLM 回答收集工具。可作为托管远程服务使用,也可通过 `npx @brightdata/mcp` 在本地运行。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Bright Data MCP
通过 Model Context Protocol,为 AI Agent 和大模型提供网页搜索、页面抓取、结构化数据提取和浏览器自动化功能。
适用于 AI Agent、编码 Agent、聊天助手和任何兼容 MCP 的客户端。
快速开始 • 定价 • 使用场景 • 工具 • 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
- 前往: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"
}
}
其他客户端(本地 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 |
| 将指定页面读取为干净的 Markdown | scrape_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 运行。
| 平台 | 抓取器示例 |
|---|---|
| 个人资料、公司资料、职位列表、帖子、人物搜索 | |
| 个人资料、帖子、Reels、评论 | |
| TikTok | 个人资料、帖子、商城、评论 |
| 个人资料、帖子、商城列表、公司评价、活动 | |
| YouTube | 视频、频道、评论 |
| X (Twitter) | 帖子、按个人资料查找帖子 |
| 帖子、评论 |
示例提示词:“获取这个 TikTok 个人资料最近的 10 条帖子,并总结互动情况”。
内容创作与学术研究
一次从多个页面收集素材,并按时效性和相关性筛选。
| 任务 | 工具 |
|---|---|
| 一次调用收集多个来源 | scrape_batch(最多 10 个 URL) |
| 新闻和金融数据 | 使用新闻查询调用 search_engine,使用 Yahoo Finance 抓取器运行 run_scraper |
对比情况
| 功能 | Bright Data MCP | 常见的 Web MCP 服务 |
|---|---|---|
| 工具总数 | 32 | 2–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 |
geo | ChatGPT 和 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_id | default / scrapers |
get_scraper_progress | 查看运行状态:starting、running、ready、failed 或 canceled | default / 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 上查找同一商品,并指出现货中价格最低的选项 |
配置
基本设置(本地)
{
"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_unlocker | my_custom_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 | 以逗号分隔的单个工具名称。将服务限制为这些工具 | 所有工具 | 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.
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。