Bright Data

resmi

Web'i keşfedin, veri çıkarın ve etkileşime geçin - genel internette otomatik erişimi sağlayan tek bir arayüz.

Bright Data MCP ile neler yapabilirsiniz?

  • Web araması — Asistanınızdan Bing veya Google aramaları yapmasını ve bağlantılar, başlıklar ve açıklamalar içeren yapılandırılmış sonuçlar döndürmesini isteyin.
  • Sayfa kazıma — Bot algılama ve CAPTCHA işleme özellikleri yerleşik olarak sunulan bir araçla herhangi bir URL’yi temiz Markdown, metin, HTML veya ld_json biçiminde alın.
  • Yapılandırılmış platform verileri — HTML ayrıştırmak yerine temiz JSON almak için Amazon, LinkedIn, TikTok ve npm gibi sitelere yönelik önceden hazırlanmış kazıyıcıları bulun ve çalıştırın.
  • Tarayıcı otomasyonu — Etkileşim gerektiren veya giriş yapılmasını isteyen siteler için uzak bir tarayıcı oturumunda sayfalarda gezinin, tıklayın, yazın, kaydırın ve ekran görüntüsü alın.
  • LLM yanıtlarını toplama — ChatGPT veya Perplexity’ye istemler gönderin ve her birinin bir markayı nasıl tanımladığını karşılaştırmak için yanıtlarını alın.
  • Toplu veri toplama — Paralel veri toplamak için tek bir çağrıda en fazla 5 arama yapın veya en fazla 5 URL’yi kazıyın.

Dokümantasyon

Bright Data Logo

Bright Data MCP

Model Context Protocol üzerinden AI ajanları ve LLM’ler için web araması, sayfa kazıma, yapılandırılmış veri çıkarma ve tarayıcı otomasyonu.

AI ajanları, kodlama ajanları, sohbet asistanları ve MCP uyumlu tüm istemcilerle çalışır.

npm version npm downloads License

Hızlı Başlangıç • Fiyatlandırma • Kullanım Alanları • Araçlar • Ajan Becerileri • Belgeler • Destek

Ücretsiz plan: ayda 5.000 istek. Kredi kartı gerekmez. Her ay yenilenir.


Genel Bakış

Bright Data MCP sunucusu, AI ajanlarına herkese açık web verilerine gerçek zamanlı erişim sağlar. Şunları kapsayan 30 araç sunar:

  • Web araması — Bing ve Google sonuçlarını yapılandırılmış veri olarak sunar
  • Sayfa kazıma — bot algılama, CAPTCHA çözme ve proxy rotasyonu her istekte otomatik olarak yönetilerek herhangi bir URL’yi Markdown veya HTML olarak sunar
  • Yapılandırılmış veri (Web Scraper API) — HTML ayrıştırmaya gerek kalmadan Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI ve daha fazlası için önceden oluşturulmuş 1.200’den fazla kazıyıcıdan temiz JSON sağlar. Bunlardan herhangi birini bulup çalıştırmak için altı araç sunar
  • Tarayıcı otomasyonu — uzak bir tarayıcı oturumunda sayfalarda gezinme, tıklama, yazma, ekran görüntüsü alma ve sayfaları okuma
  • LLM yanıtlarını toplama — ChatGPT ve Perplexity’ye istem gönderip yanıtlarını yapılandırılmış veri olarak alma

Her istek Bright Data’nın engel kaldırma altyapısı üzerinden yönlendirilir; böylece sıradan HTTP istemcilerini engelleyen sayfalar (bot algılama, CAPTCHA’lar, hız sınırları, coğrafi kısıtlamalar) normal şekilde yanıt verir. Proxy kurulumu, başsız tarayıcı bakımı veya yazılacak yeniden deneme mantığı gerekmez.

İki dağıtım seçeneği: barındırılan uzak sunucu (tek URL, kurulum gerekmez) veya npx @brightdata/mcp aracılığıyla yerel örnek.


Hızlı Başlangıç

Barındırılan sunucu — kurulum gerekmez. Bu URL’yi MCP istemcinize ekleyin:

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

API token’ınızı Bright Data hesap ayarlarınızdan alın. Yeni hesaplara ayda 5.000 ücretsiz istek verilir.

İsteğe bağlı URL parametreleri:

ParametreAçıklamaÖrnek
groups=<ids>Belirli araç gruplarıyla sınırlandırır (varsayılan: tüm araçlar)...&groups=scrapers,browser
tools=<names>Belirli araçlarla sınırlandırır...&tools=search_engine,scrape_as_markdown
Claude Desktop
  1. Şuraya gidin: Settings → Connectors → Add custom connector
  2. Ad: Bright Data
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. "Add" düğmesine tıklayın

Ya da yerel olarak çalıştırın:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}
Claude Code
claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
Cursor

~/.cursor/mcp.json dosyasına ekleyin:

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

.vscode/mcp.json dosyasına ekleyin:

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

~/.codeium/windsurf/mcp_config.json dosyasına ekleyin:

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

~/.gemini/settings.json dosyasına ekleyin:

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

Zed ayarlarınıza ekleyin:

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

Settings > MCP Servers > Add MCP Server bölümüne gidip şunu ekleyin:

{
  "brightdata": {
    "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  }
}
Diğer istemciler (yerel npx)

Yerel MCP sunucularını destekleyen tüm istemciler için:

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

Fiyatlandırma ve Ücretsiz Plan

Her hesapta yinelenen aylık ücretsiz kullanım hakkı bulunur. Başlamak için kredi kartı veya taahhüt gerekmez.

Her ayın 1’inde yenilenen ayda 5.000 ücretsiz istek. Kullanılmayan istekler sonraki aya devretmez. Ekip hesaplarında ücretsiz kullanım hakkı, hesaptaki tüm kullanıcılar arasında paylaşılır.

Ücretsiz olarak sunulanlar:

  • Herhangi bir web sayfasını alıp Markdown olarak çıkarma
  • Popüler alan adları için önceden oluşturulmuş 60’tan fazla kazıyıcıya erişim
  • Web araması (Bing, Google)
  • Web engellerini kaldırma (bot algılamasını aşma, CAPTCHA çözme, proxy rotasyonu)
  • Tarayıcı otomasyonu
  • Coğrafi hedefleme

Ücretsiz kullanım hakkı aşıldığında — taahhütsüz, kullandıkça öde:

Arama, Kazıma ve ÇıkarmaTarayıcıda Gezinme
Kullandıkça öde1.000 sonuç başına $1.50GB başına $8
  • Ücretsiz istekler tükendiğinde istekler durur. Para yatırmadığınız sürece beklenmedik ücret alınmaz
  • Kredi kartı eklemek yalnızca doğrulama içindir; ücretsiz kullanım hakkınız tükenmedikçe ve hesabınıza para yatırmadıkça ücret alınmaz
  • Kullandıkça öde kullanımının bütçenizi aşmaması için kontrol panelinde bir harcama sınırı belirleyin

Tam fiyatlandırma, hacim planları ve kurumsal çözümler →


Kullanım Alanları

Gerçek zamanlı araştırma

Eğitim verileri yerine canlı web verilerini kullanarak soruları yanıtlayın. Önce arayın, ardından kaynakları okuyun.

GörevAraçlar
Güncel bilgiler için web’de arama yapmasearch_engine, search_engine_batch
Belirli bir sayfayı temiz Markdown olarak okumascrape_as_markdown, scrape_batch

Örnek istemler: "Tesla’nın güncel hisse fiyatı nedir?", "New York için bugünün hava tahminini al", "Son 6 ayda AB yapay zekâ düzenlemesi hakkında en çok atıf alan kaynakları bul".

E-ticaret istihbaratı

Ürün verilerini yapılandırılmış JSON olarak okuyun: fiyat, bulunabilirlik, puan, yorum sayısı, satıcı, görseller.

GörevAraçlar
Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara ve diğer mağazalardan ürünler, yorumlar ve arama sonuçlarısearch_scrapers → get_scraper_details → run_scraper
Perakendeciler arası fiyat görünümüGoogle Shopping kazıyıcısıyla aynı akış

Örnek istemler: "Bu dizüstü bilgisayarın Amazon, Walmart ve Best Buy’daki fiyatlarını karşılaştır", "ASIN B0D2Q9397Y için puanı ve yorum sayısını al", "Bu ürün stokta mı?".

Pazar ve rakip analizi

Canlı verilerden rakip profilleri oluşturun: finansman, çalışan sayısı, işe alım, müşteri yorumları ve fiyatlandırma sayfaları.

GörevAraçlar
Şirket finansmanı, büyüklüğü, çalışanları ve iş ilanları (Crunchbase, ZoomInfo, LinkedIn)search_scrapers → run_scraper
Müşteri görüşleri (Google Maps, Facebook, uygulama mağazası yorumları)search_scrapers → run_scraper
Rakiplerin fiyatlandırma sayfalarıscrape_as_markdown, scrape_batch
Pazar keşfisearch_engine_batch

Örnek istem: "Notion’ı rakip olarak analiz et: fiyatlandırma, finansman, işe alım odağı ve müşterilerin şikâyetleri".

Güvenilir web erişimine sahip AI ajanları

Korunan sitelerde engellenen yerleşik getirme/arama araçlarını değiştirin. Her istek engel kaldırma altyapısından geçer; böylece ajanlar bot algılama, CAPTCHA veya coğrafi kısıtlamalar nedeniyle başarısız olmaz.

GörevAraçlar
Yerleşik web aramasının doğrudan alternatifisearch_engine
Yerleşik URL getirme aracının doğrudan alternatifiscrape_as_markdown
Paralel veri toplama (aynı anda 5 öğe)search_engine_batch, scrape_batch
Etkileşimli siteler (giriş duvarları, sonsuz kaydırma, dinamik içerik)scraping_browser_* (14 araç)

Kodlama ajanları

Paket kayıt defteri verilerini ihtiyaç anında alın — kazıma veya güncelliğini yitirmiş önbellek gerekmez.

GörevAraçlar
npm ve PyPI paket sürümü, README ve meta verilerinpmjs veya pypi kazıyıcısıyla run_scraper (kazıyıcıları search_scrapers ile bulun)
GitHub depolarındaki dosyaları okumaGitHub repository kazıyıcısıyla run_scraper

Örnek istemler: "npm’de express’in en son sürümü nedir?", "langchain-brightdata PyPI paketinin README dosyasını al".

GEO ve marka görünürlüğü

Büyük LLM’lere istem gönderip yanıtlarını yapılandırılmış veri olarak alın. AI asistanlarının markanızı nasıl tanımladığını, hangi kaynaklara atıfta bulunduğunu ve neleri önerdiğini ölçün — Üretken Motor Optimizasyonu için geri bildirim döngüsü.

GörevAraçlar
Atıflar ve öneriler içeren ChatGPT yanıtlarıchatgpt_ai_insights
Kaynaklarıyla birlikte Perplexity yanıtlarıperplexity_ai_insights

Örnek istem: "ChatGPT ve Perplexity’ye 'en iyi proxy sağlayıcısı hangisi' diye sor ve her birinin bizi nasıl sıraladığını karşılaştır".

Sosyal medya takibi

Tüm büyük platformlardan yapılandırılmış veriler: profiller, gönderiler, yorumlar ve etkileşim ölçümleri. Her platformda veri türüne göre kazıyıcılar bulunur (LinkedIn profilleri, Instagram Reels videoları, TikTok yorumları, ...); bunları search_scrapers ile bulup run_scraper ile çalıştırın.

PlatformKazıyıcı örnekleri
LinkedInkişi profilleri, şirket profilleri, iş ilanları, gönderiler, kişi arama
Instagramprofiller, gönderiler, Reels videoları, yorumlar
TikTokprofiller, gönderiler, mağaza, yorumlar
Facebookprofiller, gönderiler, pazaryeri ilanları, şirket yorumları, etkinlikler
YouTubevideolar, kanallar, yorumlar
X (Twitter)gönderiler, profile göre gönderiler
Redditgönderiler, yorumlar

Örnek istem: "Bu TikTok profilindeki son 10 gönderiyi al ve etkileşimi özetle".

İçerik oluşturma ve akademik araştırma

Güncellik ve alaka düzeyine göre filtrelenmiş, aynı anda birçok sayfadan kaynak materyal toplayın.

GörevAraçlar
Tek çağrıda birden fazla kaynak toplamascrape_batch (en fazla 5 URL)
Haber ve finans verileriHaber sorgularıyla search_engine, Yahoo Finance kazıyıcısıyla run_scraper

Karşılaştırma

ÖzellikBright Data MCPTipik web MCP sunucuları
Toplam araç sayısı302–10
Platforma özel yapılandırılmış JSON çıkarıcılarıE-ticaret, sosyal medya, iş dünyası, finans, seyahat ve uygulama mağazaları genelinde 1.200’den fazla önceden oluşturulmuş kazıyıcı; 6 araçla kullanılabilirNadir; yalnızca genel amaçlı kazıma
Engel kaldırma (bot algılamasını aşma, CAPTCHA çözme, proxy rotasyonu)Her isteğe yerleşikGenellikle yok; korunan sitelerde engellenir
Arama motorlarıBing, GoogleGenellikle bir tane
Tarayıcı otomasyonu14 araç, uzak tarayıcı, yerel kurulum gerekmezSınırlı veya yok
LLM yanıtlarını toplama (ChatGPT, Perplexity)EvetSunulmaz
Paket kayıt defteri verileri (npm, PyPI)EvetSunulmaz
Toplu işlemlerÇağrı başına 10 arama veya 10 kazımaGenellikle yalnızca tek istek
Coğrafi hedeflemeEvetSınırlı veya yok
Ücretsiz planAyda 5.000 istek, tarayıcı otomasyonu dahil, kredi kartı gerekmezDeğişken; çoğu zaman hız sınırına tabi, anahtarsız erişim

Araç Seçimi: Gruplar

Araçlar, yalnızca ihtiyacınız olanları yükleyebilmeniz için gruplar halinde düzenlenmiştir. Daha az araç, ajanınızın işlemesi gereken daha az bağlam demektir.

  • GROUPS veya TOOLS belirtilmezse 30 aracın tümü etkinleştirilir. Bunlardan herhangi birini ayarlamak sunucuyu yalnızca belirtilen araçlarla sınırlar
  • GROUPS araç paketlerini etkinleştirir. Virgülle ayrılmış değerler: GROUPS="scrapers,browser" (yerel) veya &groups=scrapers,browser (barındırılan URL)
  • TOOLS tek tek araçları ekler: TOOLS="scrape_batch,session_stats". Tek başına kullanıldığında yalnızca listelediğiniz araçları etkinleştirir
  • Her gruba ayrıca search_engine, scrape_as_markdown ve ask_brightdata_assistant dahildir
  • custom grup kimliği ayrılmıştır; tek tek araç seçmek için TOOLS kullanın | Grup Kimliği | İçerik | Araç sayısı | |----------|----------|-----------| | scrapers | Önceden oluşturulmuş herhangi bir Web Scraper API kazıyıcısını arayın ve çalıştırın (Amazon, LinkedIn, TikTok, npm, ...) | 6 | | browser | Uzak tarayıcı otomasyonu | 14 | | geo | ChatGPT ve Perplexity yanıtlarını toplama | 2 | | advanced_scraping | Toplu araçlar, oturum istatistikleri | 3 |

Eski grup kimlikleri (ecommerce, social, business, finance, research, app_stores, travel, code) hâlâ çalışır ve scrapers araçlarını etkinleştirir; social ve business ayrıca search_dataset ve list_dataset_fields araçlarını da ekler. TOOLS içindeki eski web_data_* adları da scrapers araçlarını etkinleştirir.

Yapılandırma örnekleri

Tarayıcı otomasyonu ve toplu araçlar içeren yerel sunucu:

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

Kodlama aracısı kurulumu (Claude Code / Cursor / Windsurf) — önceden oluşturulmuş kazıyıcılar aracılığıyla npm, PyPI ve GitHub verileri:

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

Araç Referansı (30 Araç)

Hangi araç kullanılmalı

  • Bilinen URL, içeriğe ihtiyaç var: scrape_as_markdown. Birden fazla URL (en fazla 5): scrape_batch
  • Bilgi bulmanız gerekiyor: search_engine. Birden fazla sorgu (en fazla 5): search_engine_batch
  • Bilinen bir platformdan yapılandırılmış veri (Amazon, LinkedIn, TikTok, npm, PyPI vb.): search_scrapers → get_scraper_details → run_scraper — temiz JSON döndürür; aynı sayfayı kazımaktan daha hızlı ve güvenilirdir
  • Ham HTML: format: 'html' ile scrape_as_markdown
  • Sayfayla etkileşim gerekiyor (tıklama, yazma, kaydırma, oturum açma): scraping_browser_* araçları
  • ChatGPT/Perplexity bir istemi nasıl yanıtlıyor: chatgpt_ai_insights / perplexity_ai_insights
  • Bright Data hakkında soru (ürünler, bölgeler, hatalar, kurulum): ask_brightdata_assistant

Kazıyıcı çalıştırmalarıyla ilgili notlar:

  • Yapılandırılmış JSON döndürür; ücret, döndürülen kayıt başına alınır
  • error alanı içeren kayıtlar, örneğin yanlış türde bir URL gibi başarısız olan girdileri açıklar
  • Sonuçlar büyük olabilir. discover_by_* yöntemleri için limit_per_input değerini düşük tutun ve toplu veri toplamayı, çerçeveniz destekliyorsa bir alt aracıda çalıştırın; böylece kayıtlar ana bağlam penceresini doldurmaz
  • Bir çalıştırma başarısız olursa, scrape_as_markdown aynı URL üzerinde yedek olarak çalışır
Arama ve Kazıma — 5 araç
AraçAçıklamaGrup
search_engineBing'de (varsayılan) veya Google'da arama yapar. JSON (bağlantı, başlık, açıklama) döndürür; sayfa başına 10 sonuç. Parametreler: country, page (0'dan başlar), time_range (hour, day, week, month, year, any; Bing yalnızca day, week, year değerlerini destekler)varsayılan / her grup
search_engine_batchTek çağrıda en fazla 5 arama sorgusuvarsayılan / advanced_scraping
scrape_as_markdownHerhangi bir URL. İçeriği markdown (varsayılan), text, html veya ld_json olarak döndürürvarsayılan / her grup
scrape_batchTek çağrıda en fazla 5 URL. İçeriği markdown (varsayılan), text, html veya ld_json olarak döndürürvarsayılan / advanced_scraping
session_statsGeçerli oturumdaki araç kullanım sayılarıvarsayılan / advanced_scraping
Web Scraper API — 6 araç

Bright Data'nın önceden oluşturulmuş 1.200'den fazla kazıyıcısını arayın ve çalıştırın. Kazıyıcı listesi docs.brightdata.com/scrapers.json konumundan yüklenir ve her gün yenilenir. Hem barındırılan hem de yerel sunucuda kullanılabilir. Hiçbir araç veya grup seçilmediğinde varsayılan olarak etkindir; aksi durumda scrapers grubunu ekleyin (barındırılan URL'de &groups=scrapers, yerel olarak GROUPS=scrapers).

Tipik akış: search_scrapers → get_scraper_details → run_scraper. Ücret, kayıt başına alınır; discover_by_* yöntemleri her girdi için en fazla limit_per_input kayıt toplar (varsayılan 10).

AraçAçıklamaGrup
search_scrapersKazıyıcıları siteye veya veri türüne göre bulun (ör. "amazon reviews", "linkedin.com"). Veri kümesi kimliğini, adını, etki alanını ve toplama yöntemlerini döndürürvarsayılan / scrapers
get_scraper_detailsBir kazıyıcı yönteminin açıklaması, girdi alanları, örnek girdi ve temel çıktı alanlarıvarsayılan / scrapers
run_scraperBir kazıyıcı yöntemini çalıştırır. 45 saniyeye kadar bekler; hâlâ çalışıyorsa daha sonra kontrol etmek için bir snapshot_id döndürürvarsayılan / scrapers
get_scraper_progressBir çalıştırmanın durumu: starting, running, ready, failed veya canceledvarsayılan / scrapers
get_scraper_resultsTamamlanmış bir çalıştırmanın kayıtlarıvarsayılan / scrapers
refresh_scrapersGünlük yenilemeyi beklemek yerine kazıyıcı listesini hemen yeniden yüklervarsayılan / scrapers
Tarayıcı Otomasyonu — 14 araç

Uzak tarayıcı oturumu. Tipik sıra: gezin → anlık görüntü al → ref ile etkileşim kur → çıkar veya ekran görüntüsü al.

AraçAçıklama
scraping_browser_navigateBir tarayıcı oturumu açar veya yeniden kullanır ve bir URL'ye gider
scraping_browser_go_backGeri gider
scraping_browser_go_forwardİleri gider
scraping_browser_snapshotSayfadaki etkileşimli öğeleri ref'leriyle listeleyen ARIA anlık görüntüsü. Ref tabanlı işlemlerden önce gereklidir
scraping_browser_click_refEn son anlık görüntüdeki ref ile bir öğeye tıklar
scraping_browser_type_refBir öğeye ref ile yazar; isteğe bağlı olarak göndermek için Enter tuşuna basar
scraping_browser_fill_formTek çağrıda ref ile birkaç form alanını doldurur
scraping_browser_screenshotGeçerli sayfanın ekran görüntüsü; isteğe bağlı full_page
scraping_browser_get_textSayfa gövdesinin metin içeriği
scraping_browser_get_htmlGeçerli sayfanın HTML'i
scraping_browser_scrollSayfanın en altına kaydırır
scraping_browser_scroll_to_refBir öğeyi görünür alana kaydırır
scraping_browser_wait_for_refİsteğe bağlı zaman aşımıyla bir öğenin görünür olmasını bekler
scraping_browser_network_requestsSayfa yüklendiğinden beri yapılan ağ istekleri: yöntem, URL, durum

Ref'ler en son anlık görüntüden alınır. Tıklama veya gezinme sonrasında sayfa değişirse, sonraki ref tabanlı işlemden önce yeni bir anlık görüntü alın. Statik sayfalarda scrape_as_markdown, tarayıcı oturumundan daha hızlı ve daha ucuzdur.

GEO ve LLM Görünürlüğü — 2 araç
AraçGirdiDöndürülen
chatgpt_ai_insightsİstemChatGPT'nin yanıtı, Markdown olarak
perplexity_ai_insightsİstemPerplexity'nin yanıtı, Markdown olarak

Üretken Motor Optimizasyonu (LLM'lerin markanızı nasıl tanımladığını izleme) ve LLM'yi değerlendirici olarak kullanma iş akışları için kullanın.

Veri Kümesi Arama — 2 araç

Depolanan LinkedIn veri kümelerinde filtreli arama yapar; kazıyıcı çalıştırması olmadan eşleşen kayıtları tek seferde döndürür.

AraçAçıklamaGrup
list_dataset_fieldsBir veri kümesinin filtrelenebilir alanları (ad, tür, açıklama). search_dataset öncesinde çağırınvarsayılan / social, business
search_datasetFiltreyle eşleşen kayıtlar; çağrı başına en fazla 10 kayıt ve devamı için imleçvarsayılan / social, business
Bright Data Asistanı — 1 araç
AraçAçıklamaGrup
ask_brightdata_assistantBright Data'nın destek asistanı Sophie'ye ürünler, API'ler, bölgeler, hatalar veya hesap kurulumu hakkında soru sorun. Aynı ileti dizisinde takip sorusu sormak için döndürülen dialog_id değerini iletinvarsayılan / her grup

Belgelerdeki araç referansının tamamı →


Aracı Becerileri

Aracınıza bu MCP sunucusunu doğru kullanmayı öğreten, kullanıma hazır beceriler. Koleksiyonun tamamı github.com/brightdata/skills adresinde bulunur — MCP düzenleme, rekabet istihbaratı, fiyat karşılaştırması, marka takibi, SEO denetimleri, kazıyıcı oluşturma, RAG işlem hatları ve daha fazlasını kapsayan 21 beceri.

En etkili üç beceri:

BeceriNe işe yarar
bright-data-mcpBright Data MCP'yi tüm web verisi işlemleri için varsayılan yapar; bot algılama nedeniyle başarısız olan WebFetch, WebSearch ve diğer yerleşik web araçlarının yerini alır
competitive-intelCanlı web verilerinden rakip anlık görüntüleri, fiyat karşılaştırması, yorum madenciliği, işe alım sinyalleri, içerik/SEO analizi ve pazar görünümü haritaları sağlar
price-comparisonBir ürünü Amazon, Walmart, eBay, Best Buy ve Google Shopping'de bulur ve stoktaki en ucuz seçeneği belirtir

Tüm 21 beceriye göz atın →


Yapılandırma

Temel kurulum (yerel)

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

Gelişmiş yapılandırma

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

Ortam değişkenleri

DeğişkenAçıklamaVarsayılanÖrnek
API_TOKENBright Data API belirteciniz (gerekli)-your-token-here
RATE_LIMITÖzel hız sınırlamasısınırsız100/1h, 50/30m
SERP_ZONEArama araçlarının kullandığı özel SERP API bölge adımcp_serpmy_serp_zone
BROWSER_ZONEÖzel Browser bölge adımcp_browsermy_browser_zone
CONTENT_GATEBir veri aracının döndürdüğü sayfa içeriği MCP yapılandırmasını değiştirme talimatlarına benziyorsa, sunucu içeriği döndürmeden önce kullanıcıya (MCP elicitation aracılığıyla) sorar. Devre dışı bırakmak için off olarak ayarlayınonoff
CONTENT_GATE_TIMEOUTİçeriği sunmadan önce kullanıcının yanıtını bekleme süresi (saniye)12060, 300
BROWSER_FILTERED_SNAPSHOTscraping_browser_snapshot her zaman yalnızca düğmeleri, bağlantıları ve alanları listeler. Belirteç tasarrufu sağlar ve sayfa metninin tıklanabilir öğe gibi görünmesini engeller (hassas görevler için). Gerekirse sayfa metni daha sonra scraping_browser_get_text ile okunabiliroffon
BASE_TIMEOUTTemel araçlar için istek zaman aşımı (saniye; arama ve kazıma)Sınır yok60, 120
BASE_MAX_RETRIESGeçici hatalarda temel araçlar için en fazla yeniden deneme sayısı (0-3)01, 3
GROUPSVirgülle ayrılmış araç grubu kimlikleri. Sunucuyu bu gruplarla sınırlarTüm araçlarscrapers,browser
TOOLSVirgülle ayrılmış tekil araç adları. Sunucuyu bu araçlarla sınırlarTüm araçlarscrape_batch,session_stats

İçerik denetimi

scrape_as_markdown, search_engine ve bunların toplu sürümleri, bir web sayfasında yazan her şeyi döndürür. İçerik MCP yapılandırmanızı değiştirmeye yönelik talimatlar gibi görünen metinler içeriyorsa — bir sunucu kaydetmek, bir npx -y paketi çalıştırmak, MCP yapılandırma dosyasını düzenlemek — sunucu duraklar ve içeriği döndürmeden önce MCP istemciniz aracılığıyla size sorar. Onaylarsanız içerik değiştirilmeden döndürülür; reddederseniz kısa bir açıklamayla asistana sunulmaz. Bu tür metinleri içermeyen sayfalar, herhangi bir istem gösterilmeden önceki gibi döndürülür. Toplu çağrıda yalnızca eşleşen öğeler sunulmaz.

MCP yapılandırması hakkında olan sayfalar (belgeler, README'ler) doğal olarak istemi tetikler. MCP elicitation'ı desteklemeyen istemciler eşleşen içeriği sunmaz; riski kabul ediyorsanız CONTENT_GATE=off değerini ayarlayın. Sunucu yanıtınızı beklerken ilerleme durumu bildirir; ilerleme sırasında araç zaman aşımını uzatmayan istemciler bekleme süresini kendi sınırlarında keser — sunucu tarafındaki ayar CONTENT_GATE_TIMEOUT değeridir. Tarayıcı araçları bu kapsama girmez.


Belgeler

KaynakBağlantı
API belgeleridocs.brightdata.com/ai/mcp-server/overview
Tüm araçların referansıdocs.brightdata.com/ai/mcp-server/tools
Agent becerilerigithub.com/brightdata/skills
Kullanım örnekleriörnekler
Değişiklik günlüğüCHANGELOG.md

Sorun giderme

Yaygın sorunlar ve çözümleri

"spawn npx ENOENT" hatası

Node.js'i yükleyin veya node için tam yolu kullanın:

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

Karmaşık sitelerde zaman aşımı

İstemci ayarlarınızda zaman aşımını 180s olarak artırın.

Kimlik doğrulama sorunları

API token'ınızın geçerli olduğunu ve gerekli izinlere sahip olduğunu doğrulayın. Token'lar hesap ayarlarında yönetilir.

run_scraper hata döndürüyor veya veri döndürmüyor

error alanını içeren kayıtlar, başarısız olan girdileri açıklar. Girdinizi get_scraper_details kaynağındaki sample_input ile karşılaştırın (ör. Amazon ürün URL'leri /dp/ içerirken Walmart URL'leri /ip/ içerir) ve sayfanın herkese açık olduğunu kontrol edin. scrape_as_markdown, yedek olarak aynı URL'de çalışır.

Uzak sunucu bağlantısı başarısız

İnternet bağlantınızı ve güvenlik duvarı ayarlarınızı kontrol edin.


Katkıda bulunma

Lütfen Bright Data'nın kodlama standartlarına uyun.


Destek

KanalBağlantı
GitHub sorunlarıgithub.com/brightdata-com/brightdata-mcp/issues
Belgelerdocs.brightdata.com/ai/mcp-server/overview
E-postasupport@brightdata.com

Lisans

MIT © Bright Data Ltd.