Bright Data
resmiTemukan, 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 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.
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:
| Parameter | Deskripsi | Contoh |
|---|---|---|
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
- Buka: Settings → Connectors → Add custom connector
- Nama:
Bright Data - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - 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 & Ekstraksi | Navigasi 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.
| Tugas | Alat |
|---|---|
| Cari informasi terkini di web | search_engine, search_engine_batch |
| Baca halaman tertentu sebagai Markdown yang bersih | scrape_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.
| Tugas | Alat |
|---|---|
| Produk, ulasan, dan hasil pencarian dari Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara, dan toko lainnya | search_scrapers → get_scraper_details → run_scraper |
| Perbandingan harga lintas peritel | Alur 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.
| Tugas | Alat |
|---|---|
| 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 pesaing | scrape_as_markdown, scrape_batch |
| Penemuan pasar | search_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.
| Tugas | Alat |
|---|---|
| Pengganti langsung untuk pencarian web bawaan | search_engine |
| Pengganti langsung untuk pengambilan URL bawaan | scrape_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.
| Tugas | Alat |
|---|---|
| Versi paket npm dan PyPI, README, metadata | run_scraper dengan scraper npmjs atau pypi (temukan dengan search_scrapers) |
| Membaca file dari repositori GitHub | run_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.
| Tugas | Alat |
|---|---|
| Jawaban ChatGPT dengan kutipan dan rekomendasi | chatgpt_ai_insights |
| Jawaban Perplexity dengan sumber | perplexity_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.
| Platform | Contoh scraper |
|---|---|
| profil orang, profil perusahaan, daftar lowongan kerja, postingan, pencarian orang | |
| profil, postingan, reels, komentar | |
| TikTok | profil, postingan, toko, komentar |
| profil, postingan, daftar marketplace, ulasan perusahaan, acara | |
| YouTube | video, channel, komentar |
| X (Twitter) | postingan, postingan berdasarkan profil |
| postingan, 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.
| Tugas | Alat |
|---|---|
| Kumpulkan beberapa sumber dalam satu panggilan | scrape_batch (hingga 5 URL) |
| Data berita dan keuangan | search_engine dengan kueri berita, run_scraper dengan scraper Yahoo Finance |
Perbandingan
| Kemampuan | Bright Data MCP | Server MCP web pada umumnya |
|---|---|---|
| Jumlah alat | 30 | 2–10 |
| Ekstraktor JSON terstruktur khusus platform | Lebih dari 1.200 scraper siap pakai untuk e-commerce, sosial, bisnis, keuangan, perjalanan, toko aplikasi, melalui 6 alat | Jarang; hanya scraping generik |
| Pembukaan blokir (melewati deteksi bot, memecahkan CAPTCHA, rotasi proxy) | Terintegrasi dalam setiap permintaan | Biasanya tidak tersedia; diblokir di situs terlindungi |
| Mesin pencari | Bing, Google | Biasanya satu |
| Otomatisasi browser | 14 alat, browser jarak jauh, tanpa penyiapan lokal | Terbatas atau tidak tersedia |
| Pengumpulan respons LLM (ChatGPT, Perplexity) | Ya | Tidak tersedia |
| Data registri paket (npm, PyPI) | Ya | Tidak tersedia |
| Operasi batch | 10 pencarian atau 10 scraping per panggilan | Biasanya hanya satu permintaan |
| Penargetan geografis | Ya | Terbatas atau tidak tersedia |
| Paket gratis | 5.000 permintaan/bulan, termasuk otomatisasi browser, tanpa kartu kredit | Bervariasi; 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
GROUPSatauTOOLS, semua 30 alat diaktifkan. Menetapkan salah satunya akan membatasi server hanya pada alat tersebut GROUPSmengaktifkan bundel alat. Pisahkan dengan koma:GROUPS="scrapers,browser"(lokal) atau&groups=scrapers,browser(URL yang di-host)TOOLSmenambahkan 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, danask_brightdata_assistant - ID grup
customdicadangkan; gunakanTOOLSuntuk pilihan individual
| ID Grup | Isi | Jumlah alat |
|---|---|---|
scrapers | Cari dan jalankan scraper API Web Scraper siap pakai apa pun (Amazon, LinkedIn, TikTok, npm, ...) | 6 |
browser | Otomatisasi browser jarak jauh | 14 |
geo | Pengumpulan respons ChatGPT dan Perplexity | 2 |
advanced_scraping | Alat batch, statistik sesi | 3 |
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_markdowndenganformat: '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
errormenjelaskan input yang gagal, misalnya URL dengan jenis yang salah - Hasilnya bisa berukuran besar. Jaga
limit_per_inputtetap rendah untuk metodediscover_by_*dan jalankan pengumpulan massal di subagen jika kerangka kerja Anda mendukungnya, agar rekaman tidak membanjiri jendela konteks utama - Jika proses gagal,
scrape_as_markdowndapat digunakan pada URL yang sama sebagai alternatif
Pencarian dan Pengikisan — 5 alat
| Alat | Deskripsi | Grup |
|---|---|---|
search_engine | Cari 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_batch | Hingga 5 kueri pencarian dalam satu panggilan | default / advanced_scraping |
scrape_as_markdown | URL apa pun. Menghasilkan konten dalam format markdown (default), text, html, atau ld_json | default / setiap grup |
scrape_batch | Hingga 5 URL dalam satu panggilan. Menghasilkan konten dalam format markdown (default), text, html, atau ld_json | default / advanced_scraping |
session_stats | Jumlah penggunaan alat untuk sesi saat ini | default / 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).
| Alat | Deskripsi | Grup |
|---|---|---|
search_scrapers | Temukan scraper berdasarkan situs atau jenis data (misalnya, "ulasan amazon", "linkedin.com"). Menghasilkan ID dataset, nama, domain, dan metode pengumpulan | default / scrapers |
get_scraper_details | Deskripsi, kolom input, contoh input, dan kolom output utama untuk satu metode scraper | default / scrapers |
run_scraper | Jalankan metode scraper. Menunggu hingga 45 detik; jika masih berjalan, menghasilkan snapshot_id untuk diperiksa nanti | default / scrapers |
get_scraper_progress | Status proses: starting, running, ready, failed, atau canceled | default / scrapers |
get_scraper_results | Rekaman dari proses yang telah selesai | default / scrapers |
refresh_scrapers | Muat ulang daftar scraper sekarang, alih-alih menunggu pembaruan harian | default / scrapers |
Otomatisasi Browser — 14 alat
Sesi browser jarak jauh. Urutan umum: navigasi → snapshot → berinteraksi menggunakan ref → ekstrak atau ambil tangkapan layar.
| Alat | Deskripsi |
|---|---|
scraping_browser_navigate | Buka atau gunakan kembali sesi browser dan navigasikan ke URL |
scraping_browser_go_back | Kembali |
scraping_browser_go_forward | Maju |
scraping_browser_snapshot | Snapshot ARIA halaman yang mencantumkan elemen interaktif dengan ref. Wajib dilakukan sebelum tindakan berbasis ref |
scraping_browser_click_ref | Klik elemen berdasarkan ref dari snapshot terbaru |
scraping_browser_type_ref | Ketik pada elemen berdasarkan ref; opsional tekan Enter untuk mengirim |
scraping_browser_fill_form | Isi beberapa kolom formulir berdasarkan ref dalam satu panggilan |
scraping_browser_screenshot | Tangkapan layar halaman saat ini; opsional full_page |
scraping_browser_get_text | Konten teks isi halaman |
scraping_browser_get_html | HTML halaman saat ini |
scraping_browser_scroll | Gulir ke bagian bawah halaman |
scraping_browser_scroll_to_ref | Gulir hingga elemen terlihat |
scraping_browser_wait_for_ref | Tunggu hingga elemen terlihat, dengan batas waktu opsional |
scraping_browser_network_requests | Permintaan 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
| Alat | Input | Menghasilkan |
|---|---|---|
chatgpt_ai_insights | Prompt | Jawaban ChatGPT dalam format Markdown |
perplexity_ai_insights | Prompt | Jawaban 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.
| Alat | Deskripsi | Grup |
|---|---|---|
list_dataset_fields | Kolom dataset yang dapat difilter (nama, jenis, deskripsi). Panggil sebelum search_dataset | default / social, business |
search_dataset | Rekaman yang cocok dengan filter, hingga 10 per panggilan, dengan kursor untuk mengambil lebih banyak | default / social, business |
Asisten Bright Data — 1 alat
| Alat | Deskripsi | Grup |
|---|---|---|
ask_brightdata_assistant | Tanyakan 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 sama | default / 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:
| Keterampilan | Fungsinya |
|---|---|
| bright-data-mcp | Menjadikan Bright Data MCP sebagai pilihan default untuk semua operasi data web, menggantikan WebFetch, WebSearch, dan alat web bawaan lainnya yang gagal mendeteksi bot |
| competitive-intel | Snapshot pesaing, perbandingan harga, penelusuran ulasan, sinyal perekrutan, analisis konten/SEO, dan peta lanskap pasar dari data web langsung |
| price-comparison | Mencocokkan 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
| Variabel | Deskripsi | Default | Contoh |
|---|---|---|---|
API_TOKEN | Token API Bright Data Anda (wajib) | - | your-token-here |
RATE_LIMIT | Pembatasan laju khusus | tanpa batas | 100/1h, 50/30m |
SERP_ZONE | Nama zona SERP API khusus, digunakan oleh alat pencarian | mcp_serp | my_serp_zone |
BROWSER_ZONE | Nama zona Browser khusus | mcp_browser | my_browser_zone |
CONTENT_GATE | Jika 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 menonaktifkan | on | off |
CONTENT_GATE_TIMEOUT | Jumlah detik untuk menunggu jawaban pengguna sebelum menahan konten | 120 | 60, 300 |
BROWSER_FILTERED_SNAPSHOT | scraping_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_text | off | on |
BASE_TIMEOUT | Batas waktu permintaan untuk alat dasar dalam detik (pencarian dan pengikisan) | Tanpa batas | 60, 120 |
BASE_MAX_RETRIES | Percobaan ulang maksimum untuk alat dasar saat terjadi kesalahan sementara (0-3) | 0 | 1, 3 |
GROUPS | ID grup alat yang dipisahkan koma. Membatasi server ke grup ini | Semua alat | scrapers,browser |
TOOLS | Nama alat individual yang dipisahkan koma. Membatasi server ke alat ini | Semua alat | scrape_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 daya | Tautan |
|---|---|
| Dokumentasi API | docs.brightdata.com/ai/mcp-server/overview |
| Referensi lengkap tools | docs.brightdata.com/ai/mcp-server/tools |
| Skill agen | github.com/brightdata/skills |
| Contoh penggunaan | examples |
| Catatan perubahan | CHANGELOG.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
| Kanal | Tautan |
|---|---|
| Isu GitHub | github.com/brightdata-com/brightdata-mcp/issues |
| Dokumentasi | docs.brightdata.com/ai/mcp-server/overview |
| support@brightdata.com |
Lisensi
MIT © Bright Data Ltd.