Bright Data
chính thứcKhá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 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.
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
- Truy cập: Settings → Connectors → Add custom connector
- Tên:
Bright Data - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - 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 web | search_engine, search_engine_batch |
| Đọc một trang cụ thể dưới dạng Markdown sạch | scrape_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ác | search_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 tranh | scrape_as_markdown, scrape_batch |
| Khám phá thị trường | search_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ợp | search_engine |
| Thay thế trực tiếp cho công cụ tải URL tích hợp | scrape_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ệu | run_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ữ GitHub | run_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ất | chatgpt_ai_insights |
| Câu trả lời của Perplexity kèm nguồn | perplexity_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ảng | Ví dụ về trình thu thập dữ liệu |
|---|---|
| hồ sơ cá nhân, hồ sơ công ty, tin tuyển dụng, bài đăng, tìm kiếm người | |
| hồ sơ, bài đăng, reels, bình luận | |
| TikTok | hồ sơ, bài đăng, cửa hàng, bình luận |
| hồ sơ, bài đăng, tin đăng trên marketplace, đánh giá công ty, sự kiện | |
| YouTube | video, kênh, bình luận |
| X (Twitter) | bài đăng, bài đăng theo hồ sơ |
| bà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ọi | scrape_batch (tối đa 5 URL) |
| Dữ liệu tin tức và tài chính | search_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ăng | Bright Data MCP | Các máy chủ MCP web thông thường |
|---|---|---|
| Tổng số công cụ | 30 | 2–10 |
| Bộ trích xuất JSON có cấu trúc dành riêng cho từng nền tảng | Hơ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ầu | Thường không có; bị chặn trên các trang được bảo vệ |
| Công cụ tìm kiếm | Bing, Google | Thường chỉ có một |
| Tự động hóa trình duyệt | 14 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ạt | 10 lượt tìm kiếm hoặc 10 lượt thu thập dữ liệu mỗi lần gọi | Thườ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ụng | Tù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ó
GROUPShoặcTOOLS, 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 GROUPSbậ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ữ)TOOLSthê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_markdownvàask_brightdata_assistant - ID nhóm
customđược dành riêng; hãy dùngTOOLSđể 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_markdownvớiformat: '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
errorgiả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ứcdiscover_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_markdowncó 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_engine | Tì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_batch | Tối đa 5 truy vấn tìm kiếm trong một lần gọi | mặc định / advanced_scraping |
scrape_as_markdown | Bất kỳ URL nào. Trả về nội dung dưới dạng markdown (mặc định), text, html hoặc ld_json | mặc định / mọi nhóm |
scrape_batch | Tố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_json | mặc định / advanced_scraping |
session_stats | Số lượt sử dụng công cụ trong phiên hiện tại | mặ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_scrapers | Tì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ập | mặc định / scrapers |
get_scraper_details | Mô 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ập | mặc định / scrapers |
run_scraper | Chạ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 sau | mặc định / scrapers |
get_scraper_progress | Trạng thái của một lần chạy: starting, running, ready, failed hoặc canceled | mặc định / scrapers |
get_scraper_results | Các bản ghi của một lần chạy đã hoàn tất | mặc định / scrapers |
refresh_scrapers | Tải lại danh sách trình thu thập ngay thay vì chờ lần làm mới hằng ngày | mặ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_navigate | Mở hoặc dùng lại một phiên trình duyệt và điều hướng đến URL |
scraping_browser_go_back | Quay lại |
scraping_browser_go_forward | Tiế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_ref | Nhấ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_ref | Nhậ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_text | Nội dung văn bản của phần thân trang |
scraping_browser_get_html | HTML của trang hiện tại |
scraping_browser_scroll | Cuộn xuống cuối trang |
scraping_browser_scroll_to_ref | Cuộn một phần tử vào vùng hiển thị |
scraping_browser_wait_for_ref | Chờ một phần tử hiển thị, có thể đặt thời gian chờ tùy chọn |
scraping_browser_network_requests | Cá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ào | Kết quả trả về |
|---|---|---|
chatgpt_ai_insights | Câu lệnh | Câu trả lời của ChatGPT dưới dạng Markdown |
perplexity_ai_insights | Câu lệnh | Câ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_fields | Cá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_dataset | mặc định / social, business |
search_dataset | Cá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êm | mặc định / social, business |
Trợ lý Bright Data — 1 công cụ
| Công cụ | Mô tả | Nhóm |
|---|---|---|
ask_brightdata_assistant | Hỏ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ại | mặ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ăng | Chứ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 |
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ến | Mô tả | Mặc định | Ví dụ |
|---|---|---|---|
API_TOKEN | Token API Bright Data của bạn (bắt buộc) | - | your-token-here |
RATE_LIMIT | Giới hạn tốc độ tùy chỉnh | không giới hạn | 100/1h, 50/30m |
SERP_ZONE | Tên zone SERP API tùy chỉnh, được các công cụ tìm kiếm sử dụng | mcp_serp | my_serp_zone |
BROWSER_ZONE | Tên Browser zone tùy chỉnh | mcp_browser | my_browser_zone |
CONTENT_GATE | Khi 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ắt | on | off |
CONTENT_GATE_TIMEOUT | Số giây chờ câu trả lời của người dùng trước khi giữ lại nội dung | 120 | 60, 300 |
BROWSER_FILTERED_SNAPSHOT | scraping_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_text | off | on |
BASE_TIMEOUT | Thờ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ạn | 60, 120 |
BASE_MAX_RETRIES | Số 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) | 0 | 1, 3 |
GROUPS | ID 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ày | Tất cả công cụ | scrapers,browser |
TOOLS | Tê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ày | Tấ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ên | Liên kết |
|---|---|
| Tài liệu API | docs.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ân | github.com/brightdata/skills |
| Ví dụ sử dụng | examples |
| Nhật ký thay đổi | CHANGELOG.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ênh | Liên kết |
|---|---|
| Vấn đề trên GitHub | github.com/brightdata-com/brightdata-mcp/issues |
| Tài liệu | docs.brightdata.com/ai/mcp-server/overview |
| support@brightdata.com |
Giấy phép
MIT © Bright Data Ltd.