Bright Data

resmi

Temukan, ekstrak, dan berinteraksi dengan web - satu antarmuka yang mendukung akses otomatis di seluruh internet publik.

Apa yang bisa Anda lakukan dengan Bright Data MCP?

  • Pencarian web — Minta asisten Anda melakukan pencarian Bing atau Google dan mengembalikan hasil terstruktur dengan tautan, judul, dan deskripsi.
  • Pengambilan konten halaman — Ambil URL apa pun sebagai Markdown, teks, HTML, atau ld_json yang bersih, dengan deteksi bot dan penanganan CAPTCHA bawaan.
  • Data platform terstruktur — Temukan dan jalankan scraper siap pakai untuk situs seperti Amazon, LinkedIn, TikTok, dan npm guna mendapatkan JSON bersih alih-alih mengurai HTML.
  • Otomatisasi browser — Buka halaman, klik, ketik, gulir, dan ambil tangkapan layar dalam sesi browser jarak jauh untuk situs interaktif atau yang dibatasi login.
  • Pengumpulan jawaban LLM — Kirim prompt ke ChatGPT atau Perplexity dan dapatkan jawaban mereka untuk membandingkan cara masing-masing mendeskripsikan sebuah merek.
  • Pengumpulan batch — Jalankan hingga 5 pencarian atau ambil hingga 5 URL dalam satu panggilan untuk mengumpulkan data secara paralel.

Dokumentasi

Bright Data Logo

Bright Data MCP

Pencarian web, scraping halaman, ekstraksi data terstruktur, dan otomatisasi browser untuk agen AI dan LLM melalui Model Context Protocol.

Berfungsi dengan agen AI, agen coding, asisten chat, dan klien apa pun yang kompatibel dengan MCP.

npm version npm downloads License

Mulai Cepat • Harga • Kasus Penggunaan • Alat • Keahlian Agen • Dokumentasi • Dukungan

Paket gratis: 5.000 permintaan per bulan. Tidak perlu kartu kredit. Diperbarui setiap bulan.


Ringkasan

Server MCP Bright Data memberi agen AI akses real-time ke data web publik. Server ini menyediakan 30 alat yang mencakup:

  • Pencarian web — hasil Bing dan Google sebagai data terstruktur
  • Scraping halaman — URL apa pun sebagai Markdown atau HTML, dengan deteksi bot, pemecahan CAPTCHA, dan rotasi proxy yang ditangani secara otomatis pada setiap permintaan
  • Data terstruktur (Web Scraper API) — JSON bersih dari lebih dari 1.200 scraper siap pakai: Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI, dan lainnya, tanpa perlu mengurai HTML. Enam alat dapat menemukan dan menjalankan scraper mana pun
  • Otomatisasi browser — menavigasi, mengeklik, mengetik, mengambil tangkapan layar, dan membaca halaman dalam sesi browser jarak jauh
  • Pengumpulan respons LLM — mengirim prompt ke ChatGPT dan Perplexity, lalu menerima jawabannya sebagai data terstruktur

Setiap permintaan dirutekan melalui infrastruktur pembuka blokir Bright Data, sehingga halaman yang memblokir klien HTTP biasa (deteksi bot, CAPTCHA, batas laju, pembatasan geografis) dapat diakses seperti biasa. Tidak perlu menyiapkan proxy, memelihara browser headless, atau menulis logika percobaan ulang.

Dua opsi penerapan: server jarak jauh yang di-host (satu URL, tanpa instalasi) atau instans lokal melalui npx @brightdata/mcp.


Mulai Cepat

Server yang di-host — tanpa instalasi. Tambahkan URL ini ke klien MCP Anda:

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

Dapatkan token API dari pengaturan akun Bright Data. Akun baru mendapatkan 5.000 permintaan gratis per bulan.

Parameter URL opsional:

ParameterDeskripsiContoh
groups=<ids>Batasi ke grup alat tertentu (default: semua alat)...&groups=scrapers,browser
tools=<names>Batasi ke alat tertentu...&tools=search_engine,scrape_as_markdown
Claude Desktop
  1. Buka: Settings → Connectors → Add custom connector
  2. Nama: Bright Data
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. Klik "Add"

Atau jalankan secara lokal:

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

Tambahkan ke ~/.cursor/mcp.json:

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

Tambahkan ke .vscode/mcp.json:

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

Tambahkan ke ~/.codeium/windsurf/mcp_config.json:

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

Tambahkan ke ~/.gemini/settings.json:

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

Tambahkan ke pengaturan Zed Anda:

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

Buka Settings > MCP Servers > Add MCP Server, lalu tambahkan:

{
  "brightdata": {
    "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  }
}
Klien lain (npx lokal)

Untuk klien apa pun yang mendukung server MCP lokal:

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

Harga dan Paket Gratis

Setiap akun mencakup paket gratis bulanan yang diperbarui secara berkala. Tidak perlu kartu kredit atau komitmen untuk memulai.

5.000 permintaan gratis per bulan, diperbarui pada tanggal 1 setiap bulan. Permintaan yang tidak digunakan tidak akan diakumulasikan. Untuk akun tim, paket gratis digunakan bersama oleh semua pengguna dalam akun tersebut.

Yang termasuk dalam paket gratis:

  • Mengambil halaman web apa pun dan mengekstraknya sebagai Markdown
  • Akses ke lebih dari 60 scraper siap pakai untuk domain populer
  • Pencarian web (Bing, Google)
  • Pembukaan blokir web (melewati deteksi bot, memecahkan CAPTCHA, rotasi proxy)
  • Otomatisasi browser
  • Penargetan geografis

Di luar paket gratis — bayar sesuai pemakaian, tanpa komitmen:

Pencarian, Scraping & EkstraksiNavigasi Browser
Bayar sesuai pemakaian$1.50 / 1K hasil$8 / GB
  • Saat permintaan gratis habis, permintaan akan berhenti. Tidak ada biaya tak terduga — kecuali jika Anda telah menyetor dana
  • Menambahkan kartu kredit hanya merupakan langkah verifikasi; Anda tidak akan dikenai biaya kecuali paket gratis Anda habis dan Anda telah menyetor dana
  • Tetapkan batas pengeluaran di panel kontrol agar penggunaan bayar sesuai pemakaian tidak pernah melebihi anggaran Anda

Harga lengkap, paket volume, dan perusahaan →


Kasus Penggunaan

Riset real-time

Jawab pertanyaan menggunakan data web terkini, bukan data pelatihan. Lakukan pencarian, lalu baca sumbernya.

TugasAlat
Cari informasi terkini di websearch_engine, search_engine_batch
Baca halaman tertentu sebagai Markdown yang bersihscrape_as_markdown, scrape_batch

Contoh prompt: "Berapa harga saham Tesla saat ini?", "Dapatkan prakiraan cuaca hari ini untuk New York", "Temukan sumber yang paling banyak dikutip tentang regulasi AI Uni Eropa dalam 6 bulan terakhir".

Intelijen e-commerce

Baca data produk sebagai JSON terstruktur: harga, ketersediaan, rating, jumlah ulasan, penjual, gambar.

TugasAlat
Produk, ulasan, dan hasil pencarian dari Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara, dan toko lainnyasearch_scrapers → get_scraper_details → run_scraper
Perbandingan harga lintas peritelAlur yang sama dengan scraper Google Shopping

Contoh prompt: "Bandingkan harga laptop ini di Amazon, Walmart, dan Best Buy", "Dapatkan rating dan jumlah ulasan untuk ASIN B0D2Q9397Y", "Apakah produk ini tersedia?".

Analisis pasar dan pesaing

Buat profil pesaing dari data terkini: pendanaan, jumlah karyawan, perekrutan, ulasan pelanggan, halaman harga.

TugasAlat
Pendanaan perusahaan, ukuran, karyawan, lowongan kerja (Crunchbase, ZoomInfo, LinkedIn)search_scrapers → run_scraper
Sentimen pelanggan (Google Maps, Facebook, ulasan toko aplikasi)search_scrapers → run_scraper
Halaman harga pesaingscrape_as_markdown, scrape_batch
Penemuan pasarsearch_engine_batch

Contoh prompt: "Analisis Notion sebagai pesaing: harga, pendanaan, fokus perekrutan, dan keluhan pelanggan".

Agen AI dengan akses web yang andal

Ganti alat fetch/search bawaan yang diblokir di situs terlindungi. Setiap permintaan melewati infrastruktur pembuka blokir, sehingga agen tidak gagal karena deteksi bot, CAPTCHA, atau pembatasan geografis.

TugasAlat
Pengganti langsung untuk pencarian web bawaansearch_engine
Pengganti langsung untuk pengambilan URL bawaanscrape_as_markdown
Pengumpulan data paralel (5 sekaligus)search_engine_batch, scrape_batch
Situs interaktif (dinding login, gulir tanpa batas, konten dinamis)scraping_browser_* (14 alat)

Agen coding

Data registri paket sesuai kebutuhan — tanpa scraping atau cache usang.

TugasAlat
Versi paket npm dan PyPI, README, metadatarun_scraper dengan scraper npmjs atau pypi (temukan dengan search_scrapers)
Membaca file dari repositori GitHubrun_scraper dengan scraper repositori GitHub

Contoh prompt: "Apa versi terbaru express di npm?", "Dapatkan README untuk paket PyPI langchain-brightdata".

GEO dan visibilitas merek

Kirim prompt ke LLM utama dan terima jawabannya sebagai data terstruktur. Ukur bagaimana asisten AI mendeskripsikan merek Anda, sumber yang mereka kutip, dan rekomendasi mereka — siklus umpan balik untuk Generative Engine Optimization.

TugasAlat
Jawaban ChatGPT dengan kutipan dan rekomendasichatgpt_ai_insights
Jawaban Perplexity dengan sumberperplexity_ai_insights

Contoh prompt: "Tanyakan kepada ChatGPT dan Perplexity 'apa penyedia proxy terbaik' lalu bandingkan peringkat yang mereka berikan kepada kami".

Pemantauan media sosial

Data terstruktur dari semua platform utama: profil, postingan, komentar, metrik interaksi. Setiap platform memiliki scraper untuk tiap jenis data (profil LinkedIn, reels Instagram, komentar TikTok, ...); temukan dengan search_scrapers dan jalankan dengan run_scraper.

PlatformContoh scraper
LinkedInprofil orang, profil perusahaan, daftar lowongan kerja, postingan, pencarian orang
Instagramprofil, postingan, reels, komentar
TikTokprofil, postingan, toko, komentar
Facebookprofil, postingan, daftar marketplace, ulasan perusahaan, acara
YouTubevideo, channel, komentar
X (Twitter)postingan, postingan berdasarkan profil
Redditpostingan, komentar

Contoh prompt: "Dapatkan 10 postingan terakhir dari profil TikTok ini dan rangkum interaksinya".

Pembuatan konten dan riset akademis

Kumpulkan materi sumber dari banyak halaman sekaligus, dengan filter berdasarkan kebaruan dan relevansi.

TugasAlat
Kumpulkan beberapa sumber dalam satu panggilanscrape_batch (hingga 5 URL)
Data berita dan keuangansearch_engine dengan kueri berita, run_scraper dengan scraper Yahoo Finance

Perbandingan

KemampuanBright Data MCPServer MCP web pada umumnya
Jumlah alat302–10
Ekstraktor JSON terstruktur khusus platformLebih dari 1.200 scraper siap pakai untuk e-commerce, sosial, bisnis, keuangan, perjalanan, toko aplikasi, melalui 6 alatJarang; hanya scraping generik
Pembukaan blokir (melewati deteksi bot, memecahkan CAPTCHA, rotasi proxy)Terintegrasi dalam setiap permintaanBiasanya tidak tersedia; diblokir di situs terlindungi
Mesin pencariBing, GoogleBiasanya satu
Otomatisasi browser14 alat, browser jarak jauh, tanpa penyiapan lokalTerbatas atau tidak tersedia
Pengumpulan respons LLM (ChatGPT, Perplexity)YaTidak tersedia
Data registri paket (npm, PyPI)YaTidak tersedia
Operasi batch10 pencarian atau 10 scraping per panggilanBiasanya hanya satu permintaan
Penargetan geografisYaTerbatas atau tidak tersedia
Paket gratis5.000 permintaan/bulan, termasuk otomatisasi browser, tanpa kartu kreditBervariasi; sering kali akses tanpa kunci dengan batas laju

Pemilihan Alat: Grup

Alat diatur ke dalam grup agar Anda hanya memuat yang diperlukan. Semakin sedikit alat, semakin sedikit konteks yang perlu diproses agen Anda.

  • Tanpa GROUPS atau TOOLS, semua 30 alat diaktifkan. Menetapkan salah satunya akan membatasi server hanya pada alat tersebut
  • GROUPS mengaktifkan bundel alat. Pisahkan dengan koma: GROUPS="scrapers,browser" (lokal) atau &groups=scrapers,browser (URL yang di-host)
  • TOOLS menambahkan alat individual: TOOLS="scrape_batch,session_stats". Jika digunakan sendiri, hanya alat yang Anda cantumkan yang diaktifkan
  • Setiap grup juga menyertakan search_engine, scrape_as_markdown, dan ask_brightdata_assistant
  • ID grup custom dicadangkan; gunakan TOOLS untuk pilihan individual
ID GrupIsiJumlah alat
scrapersCari dan jalankan scraper API Web Scraper siap pakai apa pun (Amazon, LinkedIn, TikTok, npm, ...)6
browserOtomatisasi browser jarak jauh14
geoPengumpulan respons ChatGPT dan Perplexity2
advanced_scrapingAlat batch, statistik sesi3

ID grup lama (ecommerce, social, business, finance, research, app_stores, travel, code) masih berfungsi dan mengaktifkan alat scrapers; social dan business juga menambahkan search_dataset dan list_dataset_fields. Nama web_data_* lama di TOOLS juga mengaktifkan alat scrapers.

Contoh konfigurasi

Server lokal dengan otomatisasi browser dan alat batch:

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

Penyiapan agen coding (Claude Code / Cursor / Windsurf) — data npm, PyPI, dan GitHub melalui scraper siap pakai:

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

Referensi Alat (30 Alat)

Alat yang sebaiknya digunakan

  • URL diketahui, perlu kontennya: scrape_as_markdown. Beberapa URL (hingga 5): scrape_batch
  • Perlu mencari informasi: search_engine. Beberapa kueri (hingga 5): search_engine_batch
  • Data terstruktur dari platform yang diketahui (Amazon, LinkedIn, TikTok, npm, PyPI, dll.): search_scrapers → get_scraper_details → run_scraper — menghasilkan JSON bersih, lebih cepat dan andal daripada mengikis halaman yang sama
  • HTML mentah: scrape_as_markdown dengan format: 'html'
  • Halaman memerlukan interaksi (klik, ketik, gulir, login): alat scraping_browser_*
  • Cara ChatGPT/Perplexity menjawab prompt: chatgpt_ai_insights / perplexity_ai_insights
  • Pertanyaan tentang Bright Data sendiri (produk, zona, kesalahan, penyiapan): ask_brightdata_assistant

Catatan tentang proses scraper:

  • Menghasilkan JSON terstruktur, ditagih per rekaman yang dikembalikan
  • Rekaman dengan kolom error menjelaskan input yang gagal, misalnya URL dengan jenis yang salah
  • Hasilnya bisa berukuran besar. Jaga limit_per_input tetap rendah untuk metode discover_by_* dan jalankan pengumpulan massal di subagen jika kerangka kerja Anda mendukungnya, agar rekaman tidak membanjiri jendela konteks utama
  • Jika proses gagal, scrape_as_markdown dapat digunakan pada URL yang sama sebagai alternatif
Pencarian dan Pengikisan — 5 alat
AlatDeskripsiGrup
search_engineCari di Bing (default) atau Google. Menghasilkan JSON (tautan, judul, deskripsi), 10 hasil per halaman. Parameter: country, page (mulai dari 0), time_range (hour, day, week, month, year, any; Bing hanya mendukung day, week, year)default / setiap grup
search_engine_batchHingga 5 kueri pencarian dalam satu panggilandefault / advanced_scraping
scrape_as_markdownURL apa pun. Menghasilkan konten dalam format markdown (default), text, html, atau ld_jsondefault / setiap grup
scrape_batchHingga 5 URL dalam satu panggilan. Menghasilkan konten dalam format markdown (default), text, html, atau ld_jsondefault / advanced_scraping
session_statsJumlah penggunaan alat untuk sesi saat inidefault / advanced_scraping
Web Scraper API — 6 alat

Cari dan jalankan scraper siap pakai Bright Data yang jumlahnya lebih dari 1.200. Daftar scraper dimuat dari docs.brightdata.com/scrapers.json dan diperbarui setiap hari. Tersedia di server ter-host maupun lokal. Diaktifkan secara default jika tidak ada alat atau grup yang dipilih; jika tidak, tambahkan grup scrapers (&groups=scrapers pada URL ter-host, GROUPS=scrapers secara lokal).

Alur umum: search_scrapers → get_scraper_details → run_scraper. Proses ditagih per rekaman; metode discover_by_* mengumpulkan hingga limit_per_input rekaman per input (default 10).

AlatDeskripsiGrup
search_scrapersTemukan scraper berdasarkan situs atau jenis data (misalnya, "ulasan amazon", "linkedin.com"). Menghasilkan ID dataset, nama, domain, dan metode pengumpulandefault / scrapers
get_scraper_detailsDeskripsi, kolom input, contoh input, dan kolom output utama untuk satu metode scraperdefault / scrapers
run_scraperJalankan metode scraper. Menunggu hingga 45 detik; jika masih berjalan, menghasilkan snapshot_id untuk diperiksa nantidefault / scrapers
get_scraper_progressStatus proses: starting, running, ready, failed, atau canceleddefault / scrapers
get_scraper_resultsRekaman dari proses yang telah selesaidefault / scrapers
refresh_scrapersMuat ulang daftar scraper sekarang, alih-alih menunggu pembaruan hariandefault / scrapers
Otomatisasi Browser — 14 alat

Sesi browser jarak jauh. Urutan umum: navigasi → snapshot → berinteraksi menggunakan ref → ekstrak atau ambil tangkapan layar.

AlatDeskripsi
scraping_browser_navigateBuka atau gunakan kembali sesi browser dan navigasikan ke URL
scraping_browser_go_backKembali
scraping_browser_go_forwardMaju
scraping_browser_snapshotSnapshot ARIA halaman yang mencantumkan elemen interaktif dengan ref. Wajib dilakukan sebelum tindakan berbasis ref
scraping_browser_click_refKlik elemen berdasarkan ref dari snapshot terbaru
scraping_browser_type_refKetik pada elemen berdasarkan ref; opsional tekan Enter untuk mengirim
scraping_browser_fill_formIsi beberapa kolom formulir berdasarkan ref dalam satu panggilan
scraping_browser_screenshotTangkapan layar halaman saat ini; opsional full_page
scraping_browser_get_textKonten teks isi halaman
scraping_browser_get_htmlHTML halaman saat ini
scraping_browser_scrollGulir ke bagian bawah halaman
scraping_browser_scroll_to_refGulir hingga elemen terlihat
scraping_browser_wait_for_refTunggu hingga elemen terlihat, dengan batas waktu opsional
scraping_browser_network_requestsPermintaan jaringan sejak halaman dimuat: metode, URL, status

Ref berasal dari snapshot terbaru. Jika halaman berubah setelah klik atau navigasi, ambil snapshot baru sebelum tindakan berbasis ref berikutnya. Untuk halaman statis, scrape_as_markdown lebih cepat dan murah daripada sesi browser.

GEO dan Visibilitas LLM — 2 alat
AlatInputMenghasilkan
chatgpt_ai_insightsPromptJawaban ChatGPT dalam format Markdown
perplexity_ai_insightsPromptJawaban Perplexity dalam format Markdown

Gunakan untuk Generative Engine Optimization (melacak cara LLM mendeskripsikan merek Anda) dan alur kerja LLM-as-a-judge.

Pencarian Dataset — 2 alat

Pencarian dengan filter pada dataset LinkedIn tersimpan; langsung menghasilkan rekaman yang cocok, tanpa menjalankan scraper.

AlatDeskripsiGrup
list_dataset_fieldsKolom dataset yang dapat difilter (nama, jenis, deskripsi). Panggil sebelum search_datasetdefault / social, business
search_datasetRekaman yang cocok dengan filter, hingga 10 per panggilan, dengan kursor untuk mengambil lebih banyakdefault / social, business
Asisten Bright Data — 1 alat
AlatDeskripsiGrup
ask_brightdata_assistantTanyakan kepada Sophie, asisten dukungan Bright Data, tentang produk, API, zona, kesalahan, atau penyiapan akun. Berikan dialog_id yang dikembalikan untuk mengajukan pertanyaan lanjutan dalam utas yang samadefault / setiap grup

Referensi alat lengkap di dokumentasi →


Keterampilan Agen

Keterampilan siap pakai yang mengajarkan agen Anda cara menggunakan server MCP ini dengan benar. Koleksi lengkapnya tersedia di github.com/brightdata/skills — 21 keterampilan yang mencakup orkestrasi MCP, intelijen kompetitif, perbandingan harga, pemantauan merek, audit SEO, pembuatan scraper, pipeline RAG, dan lainnya.

Tiga keterampilan dengan dampak tertinggi:

KeterampilanFungsinya
bright-data-mcpMenjadikan Bright Data MCP sebagai pilihan default untuk semua operasi data web, menggantikan WebFetch, WebSearch, dan alat web bawaan lainnya yang gagal mendeteksi bot
competitive-intelSnapshot pesaing, perbandingan harga, penelusuran ulasan, sinyal perekrutan, analisis konten/SEO, dan peta lanskap pasar dari data web langsung
price-comparisonMencocokkan produk di Amazon, Walmart, eBay, Best Buy, dan Google Shopping, lalu menyebutkan opsi termurah yang tersedia

Jelajahi semua 21 keterampilan →


Konfigurasi

Penyiapan dasar (lokal)

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

Konfigurasi lanjutan

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

Variabel lingkungan

VariabelDeskripsiDefaultContoh
API_TOKENToken API Bright Data Anda (wajib)-your-token-here
RATE_LIMITPembatasan laju khusustanpa batas100/1h, 50/30m
SERP_ZONENama zona SERP API khusus, digunakan oleh alat pencarianmcp_serpmy_serp_zone
BROWSER_ZONENama zona Browser khususmcp_browsermy_browser_zone
CONTENT_GATEJika konten halaman yang dikembalikan oleh alat data tampak seperti instruksi untuk mengubah konfigurasi MCP, server akan meminta persetujuan pengguna (melalui MCP elicitation) sebelum mengembalikannya. Atur ke off untuk menonaktifkanonoff
CONTENT_GATE_TIMEOUTJumlah detik untuk menunggu jawaban pengguna sebelum menahan konten12060, 300
BROWSER_FILTERED_SNAPSHOTscraping_browser_snapshot selalu hanya mencantumkan tombol, tautan, dan kolom. Menghemat token dan mencegah teks halaman menyamar sebagai elemen yang dapat diklik (untuk tugas sensitif). Jika perlu, teks halaman dapat dibaca dengan scraping_browser_get_textoffon
BASE_TIMEOUTBatas waktu permintaan untuk alat dasar dalam detik (pencarian dan pengikisan)Tanpa batas60, 120
BASE_MAX_RETRIESPercobaan ulang maksimum untuk alat dasar saat terjadi kesalahan sementara (0-3)01, 3
GROUPSID grup alat yang dipisahkan koma. Membatasi server ke grup iniSemua alatscrapers,browser
TOOLSNama alat individual yang dipisahkan koma. Membatasi server ke alat iniSemua alatscrape_batch,session_stats

Gerbang konten

scrape_as_markdown, search_engine dan varian batch-nya mengembalikan apa pun yang tertulis di halaman web. Jika konten tersebut memuat teks yang tampak seperti instruksi untuk mengubah konfigurasi MCP Anda — mendaftarkan server, menjalankan paket npx -y, mengedit file konfigurasi MCP — server akan berhenti sejenak dan meminta persetujuan Anda melalui klien MCP sebelum mengembalikannya. Setujui, dan konten akan dikembalikan tanpa perubahan; tolak, dan konten akan ditahan disertai penjelasan singkat untuk asisten. Halaman yang tidak memuat teks semacam itu akan dikembalikan seperti biasa, tanpa permintaan persetujuan. Untuk panggilan batch, hanya item yang cocok yang ditahan.

Halaman yang membahas konfigurasi MCP (dokumentasi, README) secara alami akan memicu permintaan persetujuan. Klien yang tidak mendukung MCP elicitation akan menahan konten yang cocok; atur CONTENT_GATE=off jika Anda menerima risikonya. Saat server menunggu jawaban Anda, server akan melaporkan progres; klien yang tidak memperpanjang batas waktu alat saat ada progres akan membatasi waktu tunggu sesuai batasnya sendiri — CONTENT_GATE_TIMEOUT adalah pengaturan di sisi server. Alat browser tidak tercakup.


Dokumentasi

Sumber dayaTautan
Dokumentasi APIdocs.brightdata.com/ai/mcp-server/overview
Referensi lengkap toolsdocs.brightdata.com/ai/mcp-server/tools
Skill agengithub.com/brightdata/skills
Contoh penggunaanexamples
Catatan perubahanCHANGELOG.md

Pemecahan masalah

Masalah umum dan solusinya

Kesalahan "spawn npx ENOENT"

Instal Node.js, atau gunakan path lengkap ke node:

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

Waktu habis pada situs yang kompleks

Tingkatkan batas waktu di pengaturan klien Anda menjadi 180s.

Masalah autentikasi

Pastikan token API Anda valid dan memiliki izin yang diperlukan. Token dikelola di pengaturan akun.

run_scraper mengembalikan kesalahan atau tidak ada data

Record dengan field error menjelaskan input yang gagal. Bandingkan input Anda dengan sample_input dari get_scraper_details (misalnya, URL produk Amazon berisi /dp/, sedangkan URL Walmart berisi /ip/) dan periksa apakah halaman dapat diakses secara publik. scrape_as_markdown berfungsi pada URL yang sama sebagai fallback.

Koneksi ke server jarak jauh gagal

Periksa koneksi internet dan pengaturan firewall Anda.


Berkontribusi

Harap ikuti standar pengodean Bright Data.


Dukungan

KanalTautan
Isu GitHubgithub.com/brightdata-com/brightdata-mcp/issues
Dokumentasidocs.brightdata.com/ai/mcp-server/overview
Emailsupport@brightdata.com

Lisensi

MIT © Bright Data Ltd.