Bright Data

chính thức

Khám phá, trích xuất và tương tác với web - một giao diện duy nhất cung cấp khả năng truy cập tự động trên toàn bộ internet công cộng.

Bạn có thể làm gì với Bright Data MCP?

  • Tìm kiếm trên web — Yêu cầu trợ lý thực hiện tìm kiếm trên Bing hoặc Google và trả về kết quả có cấu trúc, kèm liên kết, tiêu đề và mô tả.
  • Thu thập dữ liệu trang — Tải bất kỳ URL nào dưới dạng Markdown, văn bản, HTML hoặc ld_json gọn gàng, tích hợp sẵn tính năng phát hiện bot và xử lý CAPTCHA.
  • Dữ liệu nền tảng có cấu trúc — Tìm và chạy các trình thu thập dữ liệu dựng sẵn cho những trang như Amazon, LinkedIn, TikTok và npm để nhận JSON gọn gàng thay vì phải phân tích HTML.
  • Tự động hóa trình duyệt — Điều hướng, nhấp, nhập văn bản, cuộn và chụp ảnh màn hình các trang trong phiên trình duyệt từ xa, phù hợp với các trang có tính tương tác hoặc yêu cầu đăng nhập.
  • Thu thập câu trả lời từ LLM — Gửi câu lệnh đến ChatGPT hoặc Perplexity và nhận câu trả lời để so sánh cách mỗi công cụ mô tả một thương hiệu.
  • Thu thập hàng loạt — Thực hiện tối đa 5 lượt tìm kiếm hoặc thu thập dữ liệu từ tối đa 5 URL trong một lần gọi để thu thập dữ liệu song song.

Tài liệu

Bright Data Logo

Bright Data MCP

Tìm kiếm web, thu thập dữ liệu trang, trích xuất dữ liệu có cấu trúc và tự động hóa trình duyệt cho các tác nhân AI và LLM thông qua Model Context Protocol.

Hoạt động với các tác nhân AI, tác nhân lập trình, trợ lý trò chuyện và mọi ứng dụng khách tương thích với MCP.

npm version npm downloads License

Bắt đầu nhanh • Giá • Trường hợp sử dụng • Công cụ • Kỹ năng tác nhân • Tài liệu • Hỗ trợ

Gói miễn phí: 5.000 yêu cầu mỗi tháng. Không cần thẻ tín dụng. Gia hạn hàng tháng.


Tổng quan

Máy chủ Bright Data MCP cung cấp cho các tác nhân AI quyền truy cập theo thời gian thực vào dữ liệu web công khai. Máy chủ cung cấp 30 công cụ, bao gồm:

  • Tìm kiếm web — kết quả từ Bing và Google dưới dạng dữ liệu có cấu trúc
  • Thu thập dữ liệu trang — lấy bất kỳ URL nào dưới dạng Markdown hoặc HTML; tự động xử lý phát hiện bot, giải CAPTCHA và xoay vòng proxy trong mọi yêu cầu
  • Dữ liệu có cấu trúc (Web Scraper API) — JSON sạch từ hơn 1.200 trình thu thập dữ liệu dựng sẵn: Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI và nhiều nền tảng khác, không cần phân tích cú pháp HTML. Sáu công cụ giúp tìm và chạy bất kỳ trình thu thập dữ liệu nào
  • Tự động hóa trình duyệt — điều hướng, nhấp, nhập văn bản, chụp ảnh màn hình và đọc trang trong phiên trình duyệt từ xa
  • Thu thập phản hồi LLM — gửi lời nhắc đến ChatGPT và Perplexity, rồi nhận câu trả lời dưới dạng dữ liệu có cấu trúc

Mọi yêu cầu đều được định tuyến qua hạ tầng gỡ chặn của Bright Data, vì vậy các trang chặn ứng dụng khách HTTP thông thường (phát hiện bot, CAPTCHA, giới hạn tốc độ, hạn chế theo vị trí địa lý) vẫn trả về kết quả bình thường. Không cần thiết lập proxy, bảo trì trình duyệt headless hay tự viết logic thử lại.

Có hai tùy chọn triển khai: máy chủ từ xa được lưu trữ (một URL, không cần cài đặt) hoặc phiên bản cục bộ thông qua npx @brightdata/mcp.


Bắt đầu nhanh

Máy chủ được lưu trữ — không cần cài đặt. Thêm URL này vào ứng dụng khách MCP của bạn:

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

Lấy mã thông báo API từ cài đặt tài khoản Bright Data. Tài khoản mới được cấp 5.000 yêu cầu miễn phí mỗi tháng.

Tham số URL tùy chọn:

Tham sốMô tảVí dụ
groups=<ids>Giới hạn ở các nhóm công cụ cụ thể (mặc định: tất cả công cụ)...&groups=scrapers,browser
tools=<names>Giới hạn ở các công cụ cụ thể...&tools=search_engine,scrape_as_markdown
Claude Desktop
  1. Truy cập: Settings → Connectors → Add custom connector
  2. Tên: Bright Data
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. Nhấp vào "Add"

Hoặc chạy cục bộ:

{
  "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

Thêm vào ~/.cursor/mcp.json:

{
  "mcpServers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
VS Code

Thêm vào .vscode/mcp.json:

{
  "servers": {
    "brightdata": {
      "type": "http",
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Windsurf

Thêm vào ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "brightdata": {
      "serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Gemini CLI

Thêm vào ~/.gemini/settings.json:

{
  "mcpServers": {
    "brightdata": {
      "httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Zed

Thêm vào cài đặt Zed:

{
  "context_servers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Warp

Truy cập Settings > MCP Servers > Add MCP Server rồi thêm:

{
  "brightdata": {
    "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  }
}
Các ứng dụng khách khác (npx cục bộ)

Dành cho mọi ứng dụng khách hỗ trợ máy chủ MCP cục bộ:

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

Giá và gói miễn phí

Mỗi tài khoản đều có gói miễn phí định kỳ hàng tháng. Không cần thẻ tín dụng hoặc cam kết để bắt đầu.

5.000 yêu cầu miễn phí mỗi tháng, gia hạn vào ngày 1 hằng tháng. Yêu cầu chưa sử dụng không được chuyển sang tháng sau. Với tài khoản nhóm, gói miễn phí được chia sẻ giữa tất cả người dùng trong tài khoản.

Những gì được miễn phí:

  • Tải bất kỳ trang web nào và trích xuất dưới dạng Markdown
  • Truy cập hơn 60 trình thu thập dữ liệu dựng sẵn cho các miền phổ biến
  • Tìm kiếm web (Bing, Google)
  • Gỡ chặn web (vượt qua phát hiện bot, giải CAPTCHA, xoay vòng proxy)
  • Tự động hóa trình duyệt
  • Nhắm mục tiêu theo vị trí địa lý

Vượt quá gói miễn phí — thanh toán theo mức sử dụng, không cam kết:

Tìm kiếm, thu thập và trích xuấtĐiều hướng trình duyệt
Thanh toán theo mức sử dụng$1.50 / 1K kết quả$8 / GB
  • Khi hết yêu cầu miễn phí, các yêu cầu sẽ dừng. Không phát sinh khoản phí bất ngờ — trừ khi bạn đã nạp tiền
  • Việc thêm thẻ tín dụng chỉ nhằm mục đích xác minh; bạn sẽ không bị tính phí trừ khi đã dùng hết gói miễn phí và đã nạp tiền
  • Đặt giới hạn chi tiêu trong bảng điều khiển để mức sử dụng thanh toán theo mức dùng không bao giờ vượt quá ngân sách

Bảng giá đầy đủ, gói theo sản lượng và gói doanh nghiệp →


Trường hợp sử dụng

Nghiên cứu theo thời gian thực

Trả lời câu hỏi bằng dữ liệu web trực tiếp thay vì dữ liệu huấn luyện. Tìm kiếm, sau đó đọc các nguồn.

Tác vụCông cụ
Tìm kiếm thông tin hiện tại trên websearch_engine, search_engine_batch
Đọc một trang cụ thể dưới dạng Markdown sạchscrape_as_markdown, scrape_batch

Ví dụ lời nhắc: "Giá cổ phiếu Tesla hiện tại là bao nhiêu?", "Lấy dự báo thời tiết hôm nay ở New York", "Tìm các nguồn được trích dẫn nhiều nhất về quy định AI của EU trong 6 tháng qua".

Thông tin chuyên sâu về thương mại điện tử

Đọc dữ liệu sản phẩm dưới dạng JSON có cấu trúc: giá, tình trạng còn hàng, xếp hạng, số lượng đánh giá, người bán, hình ảnh.

Tác vụCông cụ
Sản phẩm, đánh giá và kết quả tìm kiếm từ Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara và các cửa hàng khácsearch_scrapers → get_scraper_details → run_scraper
So sánh giá giữa các nhà bán lẻCùng quy trình với trình thu thập dữ liệu Google Shopping

Ví dụ lời nhắc: "So sánh giá chiếc máy tính xách tay này trên Amazon, Walmart và Best Buy", "Lấy xếp hạng và số lượng đánh giá cho ASIN B0D2Q9397Y", "Sản phẩm này còn hàng không?".

Phân tích thị trường và đối thủ cạnh tranh

Xây dựng hồ sơ đối thủ cạnh tranh từ dữ liệu trực tiếp: nguồn vốn, số lượng nhân viên, tuyển dụng, đánh giá của khách hàng, trang giá.

Tác vụCông cụ
Nguồn vốn, quy mô, nhân viên và tin tuyển dụng của công ty (Crunchbase, ZoomInfo, LinkedIn)search_scrapers → run_scraper
Cảm nhận của khách hàng (Google Maps, Facebook, đánh giá trên cửa hàng ứng dụng)search_scrapers → run_scraper
Trang giá của đối thủ cạnh tranhscrape_as_markdown, scrape_batch
Khám phá thị trườngsearch_engine_batch

Ví dụ lời nhắc: "Phân tích Notion với tư cách đối thủ cạnh tranh: giá, nguồn vốn, trọng tâm tuyển dụng và những điều khách hàng phàn nàn".

Tác nhân AI có khả năng truy cập web đáng tin cậy

Thay thế các công cụ tìm kiếm/tải dữ liệu tích hợp thường bị chặn trên các trang được bảo vệ. Mọi yêu cầu đều đi qua hạ tầng gỡ chặn, giúp tác nhân không gặp lỗi do phát hiện bot, CAPTCHA hoặc hạn chế theo vị trí địa lý.

Tác vụCông cụ
Thay thế trực tiếp cho công cụ tìm kiếm web tích hợpsearch_engine
Thay thế trực tiếp cho công cụ tải URL tích hợpscrape_as_markdown
Thu thập dữ liệu song song (mỗi lần 5 mục)search_engine_batch, scrape_batch
Trang web tương tác (yêu cầu đăng nhập, cuộn vô hạn, nội dung động)scraping_browser_* (14 công cụ)

Tác nhân lập trình

Lấy dữ liệu từ kho gói theo yêu cầu — không cần thu thập dữ liệu web, không dùng bộ nhớ đệm lỗi thời.

Tác vụCông cụ
Phiên bản gói npm và PyPI, README, siêu dữ liệurun_scraper với trình thu thập dữ liệu npmjs hoặc pypi (tìm bằng search_scrapers)
Đọc tệp từ kho lưu trữ GitHubrun_scraper với trình thu thập dữ liệu kho lưu trữ GitHub

Ví dụ lời nhắc: "Phiên bản express mới nhất trên npm là gì?", "Lấy README của gói PyPI langchain-brightdata".

GEO và mức độ hiển thị thương hiệu

Gửi lời nhắc đến các LLM lớn và nhận câu trả lời dưới dạng dữ liệu có cấu trúc. Đo lường cách trợ lý AI mô tả thương hiệu của bạn, nguồn nào được trích dẫn và nội dung nào được đề xuất — tạo vòng phản hồi cho Tối ưu hóa Công cụ Tạo sinh.

Tác vụCông cụ
Câu trả lời của ChatGPT kèm trích dẫn và đề xuấtchatgpt_ai_insights
Câu trả lời của Perplexity kèm nguồnperplexity_ai_insights

Ví dụ lời nhắc: "Hỏi ChatGPT và Perplexity 'nhà cung cấp proxy tốt nhất là gì' rồi so sánh cách mỗi bên xếp hạng chúng tôi".

Theo dõi mạng xã hội

Dữ liệu có cấu trúc từ mọi nền tảng lớn: hồ sơ, bài đăng, bình luận, chỉ số tương tác. Mỗi nền tảng có các trình thu thập dữ liệu theo từng loại dữ liệu (hồ sơ LinkedIn, reels Instagram, bình luận TikTok, ...); tìm bằng search_scrapers và chạy bằng run_scraper.

Nền tảngVí dụ về trình thu thập dữ liệu
LinkedInhồ sơ cá nhân, hồ sơ công ty, tin tuyển dụng, bài đăng, tìm kiếm người
Instagramhồ sơ, bài đăng, reels, bình luận
TikTokhồ sơ, bài đăng, cửa hàng, bình luận
Facebookhồ sơ, bài đăng, tin đăng trên marketplace, đánh giá công ty, sự kiện
YouTubevideo, kênh, bình luận
X (Twitter)bài đăng, bài đăng theo hồ sơ
Redditbài đăng, bình luận

Ví dụ lời nhắc: "Lấy 10 bài đăng gần nhất từ hồ sơ TikTok này và tóm tắt mức độ tương tác".

Tạo nội dung và nghiên cứu học thuật

Thu thập tài liệu nguồn từ nhiều trang cùng lúc, lọc theo độ mới và mức độ liên quan.

Tác vụCông cụ
Thu thập nhiều nguồn trong một lần gọiscrape_batch (tối đa 5 URL)
Dữ liệu tin tức và tài chínhsearch_engine với truy vấn tin tức, run_scraper với trình thu thập dữ liệu Yahoo Finance

So sánh

Khả năngBright Data MCPCác máy chủ MCP web thông thường
Tổng số công cụ302–10
Bộ trích xuất JSON có cấu trúc dành riêng cho từng nền tảngHơn 1.200 trình thu thập dữ liệu dựng sẵn cho thương mại điện tử, mạng xã hội, kinh doanh, tài chính, du lịch, cửa hàng ứng dụng, thông qua 6 công cụHiếm; chỉ thu thập dữ liệu web chung
Gỡ chặn (vượt qua phát hiện bot, giải CAPTCHA, xoay vòng proxy)Tích hợp trong mọi yêu cầuThường không có; bị chặn trên các trang được bảo vệ
Công cụ tìm kiếmBing, GoogleThường chỉ có một
Tự động hóa trình duyệt14 công cụ, trình duyệt từ xa, không cần thiết lập cục bộHạn chế hoặc không có
Thu thập phản hồi LLM (ChatGPT, Perplexity)CóKhông cung cấp
Dữ liệu kho gói (npm, PyPI)CóKhông cung cấp
Thao tác hàng loạt10 lượt tìm kiếm hoặc 10 lượt thu thập dữ liệu mỗi lần gọiThường chỉ hỗ trợ một yêu cầu
Nhắm mục tiêu theo vị trí địa lýCóHạn chế hoặc không có
Gói miễn phí5.000 yêu cầu/tháng, bao gồm tự động hóa trình duyệt, không cần thẻ tín dụngTùy dịch vụ; thường giới hạn tốc độ khi truy cập không cần khóa

Chọn công cụ: Nhóm

Các công cụ được sắp xếp thành nhóm để bạn chỉ tải những gì cần dùng. Ít công cụ hơn đồng nghĩa với việc tác nhân cần xử lý ít ngữ cảnh hơn.

  • Nếu không có GROUPS hoặc TOOLS, cả 30 công cụ đều được bật. Đặt một trong hai tham số này sẽ giới hạn máy chủ chỉ còn các công cụ được chỉ định
  • GROUPS bật các gói công cụ. Phân tách bằng dấu phẩy: GROUPS="scrapers,browser" (cục bộ) hoặc &groups=scrapers,browser (URL máy chủ được lưu trữ)
  • TOOLS thêm từng công cụ riêng lẻ: TOOLS="scrape_batch,session_stats". Khi dùng riêng, tham số này chỉ bật các công cụ bạn liệt kê
  • Mỗi nhóm cũng bao gồm search_engine, scrape_as_markdown và ask_brightdata_assistant
  • ID nhóm custom được dành riêng; hãy dùng TOOLS để chọn từng công cụ | Group ID | Nội dung | Số lượng công cụ | |----------|----------|-----------| | scrapers | Tìm kiếm và chạy mọi trình thu thập dữ liệu Web Scraper API dựng sẵn (Amazon, LinkedIn, TikTok, npm, ...) | 6 | | browser | Tự động hóa trình duyệt từ xa | 14 | | geo | Thu thập câu trả lời từ ChatGPT và Perplexity | 2 | | advanced_scraping | Công cụ xử lý hàng loạt, thống kê phiên | 3 |

Các group ID cũ (ecommerce, social, business, finance, research, app_stores, travel, code) vẫn hoạt động và bật các công cụ scrapers; social và business cũng bổ sung search_dataset và list_dataset_fields. Các tên web_data_* cũ trong TOOLS cũng bật các công cụ scrapers.

Ví dụ cấu hình

Máy chủ cục bộ có tính năng tự động hóa trình duyệt và công cụ xử lý hàng loạt:

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

Thiết lập tác nhân lập trình (Claude Code / Cursor / Windsurf) — dữ liệu npm, PyPI và GitHub thông qua các trình thu thập dựng sẵn:

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

Tham chiếu công cụ (30 công cụ)

Chọn công cụ nào

  • Đã biết URL, cần nội dung: scrape_as_markdown. Nhiều URL (tối đa 5): scrape_batch
  • Cần tìm thông tin: search_engine. Nhiều truy vấn (tối đa 5): search_engine_batch
  • Dữ liệu có cấu trúc từ một nền tảng đã biết (Amazon, LinkedIn, TikTok, npm, PyPI, v.v.): search_scrapers → get_scraper_details → run_scraper — trả về JSON gọn gàng, nhanh và đáng tin cậy hơn so với việc thu thập dữ liệu từ cùng trang đó
  • HTML thô: scrape_as_markdown với format: 'html'
  • Trang cần tương tác (nhấp, nhập, cuộn, đăng nhập): các công cụ scraping_browser_*
  • Cách ChatGPT/Perplexity trả lời một câu lệnh: chatgpt_ai_insights / perplexity_ai_insights
  • Câu hỏi về chính Bright Data (sản phẩm, zone, lỗi, thiết lập): ask_brightdata_assistant

Lưu ý về các lần chạy trình thu thập:

  • Trả về JSON có cấu trúc, tính phí theo từng bản ghi được trả về
  • Các bản ghi có trường error giải thích những đầu vào không thành công, chẳng hạn URL không đúng loại
  • Kết quả có thể rất lớn. Giữ limit_per_input ở mức thấp đối với các phương thức discover_by_* và chạy việc thu thập hàng loạt trong một subagent nếu framework của bạn hỗ trợ, để các bản ghi không tràn ngập cửa sổ ngữ cảnh chính
  • Nếu một lần chạy thất bại, scrape_as_markdown có thể dùng làm phương án dự phòng với cùng URL
Tìm kiếm và thu thập dữ liệu — 5 công cụ
Công cụMô tảNhóm
search_engineTìm kiếm trên Bing (mặc định) hoặc Google. Trả về JSON (liên kết, tiêu đề, mô tả), 10 kết quả mỗi trang. Tham số: country, page (bắt đầu từ 0), time_range (hour, day, week, month, year, any; Bing chỉ hỗ trợ day, week, year)mặc định / mọi nhóm
search_engine_batchTối đa 5 truy vấn tìm kiếm trong một lần gọimặc định / advanced_scraping
scrape_as_markdownBất kỳ URL nào. Trả về nội dung dưới dạng markdown (mặc định), text, html hoặc ld_jsonmặc định / mọi nhóm
scrape_batchTối đa 5 URL trong một lần gọi. Trả về nội dung dưới dạng markdown (mặc định), text, html hoặc ld_jsonmặc định / advanced_scraping
session_statsSố lượt sử dụng công cụ trong phiên hiện tạimặc định / advanced_scraping
Web Scraper API — 6 công cụ

Tìm kiếm và chạy bất kỳ trình thu thập nào trong số hơn 1.200 trình thu thập dựng sẵn của Bright Data. Danh sách trình thu thập được tải từ docs.brightdata.com/scrapers.json và làm mới hằng ngày. Có trên cả máy chủ được lưu trữ và máy chủ cục bộ. Được bật theo mặc định khi không chọn công cụ hoặc nhóm nào; nếu không, hãy thêm nhóm scrapers (&groups=scrapers trên URL được lưu trữ, GROUPS=scrapers trên máy cục bộ).

Quy trình thường dùng: search_scrapers → get_scraper_details → run_scraper. Tính phí theo từng bản ghi; các phương thức discover_by_* thu thập tối đa limit_per_input bản ghi cho mỗi đầu vào (mặc định là 10).

Công cụMô tảNhóm
search_scrapersTìm trình thu thập theo trang web hoặc loại dữ liệu (ví dụ: "amazon reviews", "linkedin.com"). Trả về ID tập dữ liệu, tên, miền và các phương thức thu thậpmặc định / scrapers
get_scraper_detailsMô tả, các trường đầu vào, đầu vào mẫu và các trường đầu ra chính của một phương thức trình thu thậpmặc định / scrapers
run_scraperChạy một phương thức trình thu thập. Chờ tối đa 45 giây; nếu vẫn đang chạy, trả về snapshot_id để kiểm tra saumặc định / scrapers
get_scraper_progressTrạng thái của một lần chạy: starting, running, ready, failed hoặc canceledmặc định / scrapers
get_scraper_resultsCác bản ghi của một lần chạy đã hoàn tấtmặc định / scrapers
refresh_scrapersTải lại danh sách trình thu thập ngay thay vì chờ lần làm mới hằng ngàymặc định / scrapers
Tự động hóa trình duyệt — 14 công cụ

Phiên trình duyệt từ xa. Trình tự thường dùng: điều hướng → ảnh chụp trạng thái → tương tác bằng ref → trích xuất hoặc chụp ảnh màn hình.

Công cụMô tả
scraping_browser_navigateMở hoặc dùng lại một phiên trình duyệt và điều hướng đến URL
scraping_browser_go_backQuay lại
scraping_browser_go_forwardTiến tới
scraping_browser_snapshotẢnh chụp ARIA của trang, liệt kê các phần tử tương tác cùng ref. Bắt buộc trước các thao tác dựa trên ref
scraping_browser_click_refNhấp vào một phần tử bằng ref từ ảnh chụp trạng thái mới nhất
scraping_browser_type_refNhập vào một phần tử bằng ref; có thể nhấn Enter để gửi
scraping_browser_fill_formĐiền nhiều trường biểu mẫu bằng ref trong một lần gọi
scraping_browser_screenshotẢnh chụp màn hình trang hiện tại; full_page là tùy chọn
scraping_browser_get_textNội dung văn bản của phần thân trang
scraping_browser_get_htmlHTML của trang hiện tại
scraping_browser_scrollCuộn xuống cuối trang
scraping_browser_scroll_to_refCuộn một phần tử vào vùng hiển thị
scraping_browser_wait_for_refChờ một phần tử hiển thị, có thể đặt thời gian chờ tùy chọn
scraping_browser_network_requestsCác yêu cầu mạng kể từ khi tải trang: phương thức, URL, trạng thái

Ref được lấy từ ảnh chụp trạng thái mới nhất. Nếu trang thay đổi sau khi nhấp hoặc điều hướng, hãy chụp trạng thái mới trước thao tác tiếp theo dựa trên ref. Với các trang tĩnh, scrape_as_markdown nhanh hơn và ít tốn kém hơn phiên trình duyệt.

GEO và khả năng hiển thị của LLM — 2 công cụ
Công cụĐầu vàoKết quả trả về
chatgpt_ai_insightsCâu lệnhCâu trả lời của ChatGPT dưới dạng Markdown
perplexity_ai_insightsCâu lệnhCâu trả lời của Perplexity dưới dạng Markdown

Dùng cho Tối ưu hóa Công cụ Tạo sinh (theo dõi cách LLM mô tả thương hiệu của bạn) và quy trình LLM-as-a-judge.

Tìm kiếm tập dữ liệu — 2 công cụ

Tìm kiếm có bộ lọc trên các tập dữ liệu LinkedIn đã lưu trữ; trả về ngay các bản ghi phù hợp mà không cần chạy trình thu thập.

Công cụMô tảNhóm
list_dataset_fieldsCác trường có thể lọc của một tập dữ liệu (tên, loại, mô tả). Gọi trước search_datasetmặc định / social, business
search_datasetCác bản ghi khớp với bộ lọc, tối đa 10 bản ghi mỗi lần gọi, kèm con trỏ để lấy thêmmặc định / social, business
Trợ lý Bright Data — 1 công cụ
Công cụMô tảNhóm
ask_brightdata_assistantHỏi Sophie, trợ lý hỗ trợ của Bright Data, về sản phẩm, API, zone, lỗi hoặc thiết lập tài khoản. Truyền dialog_id được trả về để hỏi tiếp trong cùng một chuỗi hội thoạimặc định / mọi nhóm

Tham chiếu công cụ đầy đủ trong tài liệu →


Kỹ năng dành cho tác nhân

Các kỹ năng sẵn sàng sử dụng, hướng dẫn tác nhân của bạn cách dùng máy chủ MCP này đúng cách. Bộ sưu tập đầy đủ có tại github.com/brightdata/skills — 21 kỹ năng bao gồm điều phối MCP, thông tin tình báo cạnh tranh, so sánh giá, theo dõi thương hiệu, kiểm tra SEO, xây dựng trình thu thập, quy trình RAG và nhiều nội dung khác.

Ba kỹ năng có tác động lớn nhất:

Kỹ năngChức năng
bright-data-mcpĐặt Bright Data MCP làm công cụ mặc định cho mọi thao tác dữ liệu web, thay thế WebFetch, WebSearch và các công cụ web tích hợp khác vốn thất bại khi gặp cơ chế phát hiện bot
competitive-intelẢnh chụp đối thủ cạnh tranh, so sánh giá, khai thác đánh giá, tín hiệu tuyển dụng, phân tích nội dung/SEO và bản đồ toàn cảnh thị trường từ dữ liệu web trực tiếp
price-comparisonĐối chiếu một sản phẩm trên Amazon, Walmart, eBay, Best Buy và Google Shopping, rồi nêu lựa chọn còn hàng có giá thấp nhất

Xem tất cả 21 kỹ năng →


Cấu hình

Thiết lập cơ bản (cục bộ)

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

Cấu hình nâng cao

{
  "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"
      }
    }
  }
}

Biến môi trường

BiếnMô tảMặc địnhVí dụ
API_TOKENToken API Bright Data của bạn (bắt buộc)-your-token-here
RATE_LIMITGiới hạn tốc độ tùy chỉnhkhông giới hạn100/1h, 50/30m
SERP_ZONETên zone SERP API tùy chỉnh, được các công cụ tìm kiếm sử dụngmcp_serpmy_serp_zone
BROWSER_ZONETên Browser zone tùy chỉnhmcp_browsermy_browser_zone
CONTENT_GATEKhi nội dung trang do công cụ dữ liệu trả về trông giống chỉ dẫn thay đổi cấu hình MCP, máy chủ sẽ hỏi người dùng (thông qua MCP elicitation) trước khi trả về nội dung đó. Đặt thành off để tắtonoff
CONTENT_GATE_TIMEOUTSố giây chờ câu trả lời của người dùng trước khi giữ lại nội dung12060, 300
BROWSER_FILTERED_SNAPSHOTscraping_browser_snapshot luôn chỉ liệt kê nút, liên kết và trường. Giúp tiết kiệm token và ngăn văn bản trên trang giả dạng phần tử có thể nhấp (đối với tác vụ nhạy cảm). Nếu cần, có thể đọc văn bản trang bằng scraping_browser_get_textoffon
BASE_TIMEOUTThời gian chờ yêu cầu tính bằng giây cho các công cụ cơ bản (tìm kiếm và thu thập dữ liệu)Không giới hạn60, 120
BASE_MAX_RETRIESSố lần thử lại tối đa cho các công cụ cơ bản khi gặp lỗi tạm thời (0-3)01, 3
GROUPSID nhóm công cụ, phân tách bằng dấu phẩy. Giới hạn máy chủ ở các nhóm nàyTất cả công cụscrapers,browser
TOOLSTên công cụ riêng lẻ, phân tách bằng dấu phẩy. Giới hạn máy chủ ở các công cụ nàyTất cả công cụscrape_batch,session_stats

Cổng kiểm soát nội dung

scrape_as_markdown, search_engine và các biến thể xử lý hàng loạt của chúng trả về bất kỳ nội dung nào trên trang web. Nếu nội dung đó có văn bản giống như chỉ dẫn thay đổi cấu hình MCP — đăng ký máy chủ, chạy một gói npx -y, chỉnh sửa tệp cấu hình MCP — máy chủ sẽ tạm dừng và hỏi bạn thông qua ứng dụng khách MCP trước khi trả về nội dung. Chấp thuận thì nội dung được trả về nguyên trạng; từ chối thì nội dung bị giữ lại và trợ lý nhận được lời giải thích ngắn. Các trang không chứa văn bản như vậy vẫn được trả về như trước, không có lời nhắc. Với lệnh gọi hàng loạt, chỉ những mục khớp mới bị giữ lại.

Các trang nói về cấu hình MCP (tài liệu, README) đương nhiên sẽ kích hoạt lời nhắc. Nội dung khớp sẽ bị giữ lại đối với các ứng dụng khách không hỗ trợ MCP elicitation; đặt CONTENT_GATE=off nếu bạn chấp nhận rủi ro. Trong khi máy chủ chờ câu trả lời, máy chủ sẽ báo tiến độ; các ứng dụng khách không kéo dài thời gian chờ công cụ khi có cập nhật tiến độ sẽ giới hạn thời gian chờ theo mức của chính chúng — CONTENT_GATE_TIMEOUT là tùy chọn điều chỉnh ở phía máy chủ. Các công cụ trình duyệt không thuộc phạm vi áp dụng.


Tài liệu

Tài nguyênLiên kết
Tài liệu APIdocs.brightdata.com/ai/mcp-server/overview
Tài liệu tham khảo đầy đủ về công cụdocs.brightdata.com/ai/mcp-server/tools
Kỹ năng của tác nhângithub.com/brightdata/skills
Ví dụ sử dụngexamples
Nhật ký thay đổiCHANGELOG.md

Khắc phục sự cố

Các sự cố thường gặp và cách khắc phục

Lỗi "spawn npx ENOENT"

Cài đặt Node.js hoặc sử dụng đường dẫn đầy đủ đến node:

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

Hết thời gian chờ trên các trang web phức tạp

Tăng thời gian chờ trong cài đặt ứng dụng khách lên 180s.

Sự cố xác thực

Xác minh token API của bạn hợp lệ và có các quyền cần thiết. Token được quản lý trong cài đặt tài khoản.

run_scraper trả về lỗi hoặc không có dữ liệu

Các bản ghi có trường error giải thích những đầu vào không thành công. So sánh đầu vào của bạn với sample_input từ get_scraper_details (ví dụ: URL sản phẩm Amazon chứa /dp/, còn URL Walmart chứa /ip/) và kiểm tra xem trang có thể truy cập công khai hay không. scrape_as_markdown hoạt động trên cùng URL như một phương án dự phòng.

Không thể kết nối với máy chủ từ xa

Kiểm tra kết nối internet và cài đặt tường lửa.


Đóng góp

Vui lòng tuân thủ tiêu chuẩn lập trình của Bright Data.


Hỗ trợ

KênhLiên kết
Vấn đề trên GitHubgithub.com/brightdata-com/brightdata-mcp/issues
Tài liệudocs.brightdata.com/ai/mcp-server/overview
Emailsupport@brightdata.com

Giấy phép

MIT © Bright Data Ltd.