关于 Bright Data MCP
Bright Data MCP 是面向 AI Agent 和 LLM 的网页数据 MCP 服务,提供搜索、抓取、结构化提取与浏览器自动化。它通过 Bright Data 的解封锁基础设施访问公开网页,并可选择托管远程服务或本地运行。
主要功能
- 01搜索 Google、Bing 和 Yandex
- 02将网页抓取为 Markdown 或 HTML
- 03从预置抓取器提取结构化数据
- 04远程浏览器导航与交互
- 05收集 ChatGPT 和 Perplexity 回复
- 06批量搜索与抓取
适用场景
- 01研究实时信息并查看来源
- 02比较电商商品价格与评价
- 03分析竞争对手和社交媒体数据
- 04收集 npm、PyPI 与 GitHub 资料
MCP 相关
作为 MCP 服务向兼容客户端提供网页搜索、页面抓取、结构化数据提取、浏览器自动化和 LLM 回复收集工具。可连接托管远程服务,也可通过 npx 本地运行。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 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 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。