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 MCP
透過 Model Context Protocol,為 AI 代理和 LLM 提供網頁搜尋、頁面擷取、結構化資料擷取和瀏覽器自動化功能。
適用於 AI 代理、程式碼代理、聊天助理,以及任何相容 MCP 的用戶端。
快速入門 • 定價 • 使用案例 • 工具 • 代理技能 • 文件 • 支援
免費方案:每月 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
- 前往: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 多個熱門網域的預先建置擷取器
- 網頁搜尋(Bing、Google)
- 網頁解除封鎖(繞過機器人偵測、CAPTCHA 解題、代理輪替)
- 瀏覽器自動化
- 地理位置鎖定
超出免費方案後 — 按量付費,無需承諾:
| 搜尋、擷取與提取 | 瀏覽器導覽 | |
|---|---|---|
| 按量付費 | 每 1K 筆結果 $1.50 | 每 GB $8 |
- 免費請求用完後,請求會停止。除非你已存入資金,否則不會有意外費用
- 新增信用卡僅用於驗證;只有在免費額度用盡且帳戶已存入資金時才會扣款
- 在控制面板設定支出上限,確保按量付費用量不會超出預算
使用案例
即時研究
使用即時網頁資料而非訓練資料回答問題。先搜尋,再閱讀來源。
| 任務 | 工具 |
|---|---|
| 搜尋網頁以取得最新資訊 | 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 代理
取代在受保護網站上會遭封鎖的內建擷取/搜尋工具。每個請求都會透過解除封鎖基礎架構,因此代理不會因機器人偵測、CAPTCHA 或地理限制而失敗。
| 任務 | 工具 |
|---|---|
| 直接替代內建網頁搜尋 | search_engine |
| 直接替代內建 URL 擷取 | scrape_as_markdown |
| 平行收集資料(一次 5 個) | search_engine_batch, scrape_batch |
| 互動式網站(登入牆、無限捲動、動態內容) | scraping_browser_*(14 種工具) |
程式碼代理
隨需取得套件登錄資料 — 無需擷取,也不會有過時的快取。
| 任務 | 工具 |
|---|---|
| npm 和 PyPI 套件版本、README、中繼資料 | 使用 run_scraper 搭配 npmjs 或 pypi 擷取器(使用 search_scrapers 尋找) |
| 從 GitHub 儲存庫讀取檔案 | 使用 run_scraper 搭配 GitHub 儲存庫擷取器 |
提示範例:「npm 上 express 的最新版本是什麼?」「取得 PyPI 套件 langchain-brightdata 的 README」。
GEO 與品牌能見度
向主要 LLM 傳送提示,並以結構化資料取得回覆。衡量 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(最多 5 個 URL) |
| 新聞與財經資料 | 使用 search_engine 搭配新聞查詢,使用 run_scraper 搭配 Yahoo Finance 擷取器 |
比較
| 功能 | Bright Data MCP | 一般網頁 MCP 伺服器 |
|---|---|---|
| 工具總數 | 30 | 2–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| 群組 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"
}
}
}
}
Coding 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"
}
}
}
}
工具參考(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/Perplexity 如何回答提示:
chatgpt_ai_insights/perplexity_ai_insights - 關於 Bright Data 本身的問題(產品、zones、錯誤、設定):
ask_brightdata_assistant
爬蟲執行注意事項:
- 回傳結構化 JSON,依回傳的記錄數計費
- 含有
error欄位的記錄會說明輸入失敗的原因,例如 URL 類型錯誤 - 結果可能很大。對
discover_by_*方法,請將limit_per_input設為較低值;若你的框架支援,請在子代理程式中執行大量收集,以免記錄塞滿主要上下文視窗 - 如果執行失敗,
scrape_as_markdown可作為同一 URL 的備用方案
搜尋與爬取 — 5 個工具
| 工具 | 說明 | 群組 |
|---|---|---|
search_engine | 搜尋 Bing(預設)或 Google。回傳 JSON(連結、標題、說明),每頁 10 筆結果。參數:country、page(從 0 開始)、time_range(hour、day、week、month、year、any;Bing 僅支援 day、week、year) | default / every group |
search_engine_batch | 一次呼叫最多執行 5 個搜尋查詢 | default / advanced_scraping |
scrape_as_markdown | 任意 URL。以 markdown(預設)、text、html 或 ld_json 格式回傳內容 | default / every group |
scrape_batch | 一次呼叫最多處理 5 個 URL。以 markdown(預設)、text、html 或 ld_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 快照,列出互動元素及其 refs。依 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、狀態 |
Refs 取自最新快照。如果點擊或導覽後頁面有所變更,請在下一次依 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 前請先呼叫此工具 | default / social、business |
search_dataset | 符合篩選條件的記錄,每次最多 10 筆,並提供可取得更多結果的游標 | default / social、business |
Bright Data 助理 — 1 個工具
| 工具 | 說明 | 群組 |
|---|---|---|
ask_brightdata_assistant | 向 Bright Data 的支援助理 Sophie 詢問產品、API、zones、錯誤或帳戶設定。傳入回傳的 dialog_id,即可在同一對話串中提出後續問題 | default / every group |
Agent Skills
可直接使用的技能,能教導你的代理程式正確使用此 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",
"SERP_ZONE": "custom_serp",
"BROWSER_ZONE": "custom_browser"
}
}
}
}
環境變數
| 變數 | 說明 | 預設值 | 範例 |
|---|---|---|---|
API_TOKEN | 你的 Bright Data API 權杖(必填) | - | your-token-here |
RATE_LIMIT | 自訂速率限制 | unlimited | 100/1h、50/30m |
SERP_ZONE | 自訂 SERP API zone 名稱,供搜尋工具使用 | mcp_serp | my_serp_zone |
BROWSER_ZONE | 自訂 Browser zone 名稱 | 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 一律只列出按鈕、連結和欄位。可節省 tokens,並避免將頁面文字誤認為可點擊元素(適用於敏感任務)。如有需要,可接著使用 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 設定的頁面(文件、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 token 有效且具備所需權限。Token 可在帳戶設定中管理。
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 |
| 電子郵件 | support@brightdata.com |
授權條款
MIT © Bright Data Ltd.