Bright Data
resmiWeb'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 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.
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:
| Parametre | Açı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
- Şuraya gidin: Settings → Connectors → Add custom connector
- Ad:
Bright Data - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - "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 Çıkarma | Tarayıcıda Gezinme | |
|---|---|---|
| Kullandıkça öde | 1.000 sonuç başına $1.50 | GB 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örev | Araçlar |
|---|---|
| Güncel bilgiler için web’de arama yapma | search_engine, search_engine_batch |
| Belirli bir sayfayı temiz Markdown olarak okuma | scrape_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örev | Araç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örev | Araç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şfi | search_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örev | Araçlar |
|---|---|
| Yerleşik web aramasının doğrudan alternatifi | search_engine |
| Yerleşik URL getirme aracının doğrudan alternatifi | scrape_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örev | Araçlar |
|---|---|
| npm ve PyPI paket sürümü, README ve meta verileri | npmjs veya pypi kazıyıcısıyla run_scraper (kazıyıcıları search_scrapers ile bulun) |
| GitHub depolarındaki dosyaları okuma | GitHub 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örev | Araç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.
| Platform | Kazıyıcı örnekleri |
|---|---|
| kişi profilleri, şirket profilleri, iş ilanları, gönderiler, kişi arama | |
| profiller, gönderiler, Reels videoları, yorumlar | |
| TikTok | profiller, gönderiler, mağaza, yorumlar |
| profiller, gönderiler, pazaryeri ilanları, şirket yorumları, etkinlikler | |
| YouTube | videolar, kanallar, yorumlar |
| X (Twitter) | gönderiler, profile göre gönderiler |
| gö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örev | Araçlar |
|---|---|
| Tek çağrıda birden fazla kaynak toplama | scrape_batch (en fazla 5 URL) |
| Haber ve finans verileri | Haber sorgularıyla search_engine, Yahoo Finance kazıyıcısıyla run_scraper |
Karşılaştırma
| Özellik | Bright Data MCP | Tipik web MCP sunucuları |
|---|---|---|
| Toplam araç sayısı | 30 | 2–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ılabilir | Nadir; yalnızca genel amaçlı kazıma |
| Engel kaldırma (bot algılamasını aşma, CAPTCHA çözme, proxy rotasyonu) | Her isteğe yerleşik | Genellikle yok; korunan sitelerde engellenir |
| Arama motorları | Bing, Google | Genellikle bir tane |
| Tarayıcı otomasyonu | 14 araç, uzak tarayıcı, yerel kurulum gerekmez | Sınırlı veya yok |
| LLM yanıtlarını toplama (ChatGPT, Perplexity) | Evet | Sunulmaz |
| Paket kayıt defteri verileri (npm, PyPI) | Evet | Sunulmaz |
| Toplu işlemler | Çağrı başına 10 arama veya 10 kazıma | Genellikle yalnızca tek istek |
| Coğrafi hedefleme | Evet | Sınırlı veya yok |
| Ücretsiz plan | Ayda 5.000 istek, tarayıcı otomasyonu dahil, kredi kartı gerekmez | Değ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.
GROUPSveyaTOOLSbelirtilmezse 30 aracın tümü etkinleştirilir. Bunlardan herhangi birini ayarlamak sunucuyu yalnızca belirtilen araçlarla sınırlarGROUPSaraç paketlerini etkinleştirir. Virgülle ayrılmış değerler:GROUPS="scrapers,browser"(yerel) veya&groups=scrapers,browser(barındırılan URL)TOOLStek 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_markdownveask_brightdata_assistantdahildir customgrup kimliği ayrılmıştır; tek tek araç seçmek içinTOOLSkullanı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'ilescrape_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
erroralanı 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çinlimit_per_inputdeğ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_markdownaynı URL üzerinde yedek olarak çalışır
Arama ve Kazıma — 5 araç
| Araç | Açıklama | Grup |
|---|---|---|
search_engine | Bing'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_batch | Tek çağrıda en fazla 5 arama sorgusu | varsayılan / advanced_scraping |
scrape_as_markdown | Herhangi bir URL. İçeriği markdown (varsayılan), text, html veya ld_json olarak döndürür | varsayılan / her grup |
scrape_batch | Tek çağrıda en fazla 5 URL. İçeriği markdown (varsayılan), text, html veya ld_json olarak döndürür | varsayılan / advanced_scraping |
session_stats | Geç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çıklama | Grup |
|---|---|---|
search_scrapers | Kazı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ür | varsayılan / scrapers |
get_scraper_details | Bir kazıyıcı yönteminin açıklaması, girdi alanları, örnek girdi ve temel çıktı alanları | varsayılan / scrapers |
run_scraper | Bir 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ür | varsayılan / scrapers |
get_scraper_progress | Bir çalıştırmanın durumu: starting, running, ready, failed veya canceled | varsayılan / scrapers |
get_scraper_results | Tamamlanmış bir çalıştırmanın kayıtları | varsayılan / scrapers |
refresh_scrapers | Günlük yenilemeyi beklemek yerine kazıyıcı listesini hemen yeniden yükler | varsayı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_navigate | Bir tarayıcı oturumu açar veya yeniden kullanır ve bir URL'ye gider |
scraping_browser_go_back | Geri gider |
scraping_browser_go_forward | İleri gider |
scraping_browser_snapshot | Sayfadaki etkileşimli öğeleri ref'leriyle listeleyen ARIA anlık görüntüsü. Ref tabanlı işlemlerden önce gereklidir |
scraping_browser_click_ref | En son anlık görüntüdeki ref ile bir öğeye tıklar |
scraping_browser_type_ref | Bir öğeye ref ile yazar; isteğe bağlı olarak göndermek için Enter tuşuna basar |
scraping_browser_fill_form | Tek çağrıda ref ile birkaç form alanını doldurur |
scraping_browser_screenshot | Geçerli sayfanın ekran görüntüsü; isteğe bağlı full_page |
scraping_browser_get_text | Sayfa gövdesinin metin içeriği |
scraping_browser_get_html | Geçerli sayfanın HTML'i |
scraping_browser_scroll | Sayfanın en altına kaydırır |
scraping_browser_scroll_to_ref | Bir öğ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_requests | Sayfa 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ç | Girdi | Döndürülen |
|---|---|---|
chatgpt_ai_insights | İstem | ChatGPT'nin yanıtı, Markdown olarak |
perplexity_ai_insights | İstem | Perplexity'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çıklama | Grup |
|---|---|---|
list_dataset_fields | Bir veri kümesinin filtrelenebilir alanları (ad, tür, açıklama). search_dataset öncesinde çağırın | varsayılan / social, business |
search_dataset | Filtreyle 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çıklama | Grup |
|---|---|---|
ask_brightdata_assistant | Bright 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 iletin | varsayı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:
| Beceri | Ne işe yarar |
|---|---|
| bright-data-mcp | Bright 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-intel | Canlı 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-comparison | Bir ürünü Amazon, Walmart, eBay, Best Buy ve Google Shopping'de bulur ve stoktaki en ucuz seçeneği belirtir |
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şken | Açıklama | Varsayılan | Örnek |
|---|---|---|---|
API_TOKEN | Bright Data API belirteciniz (gerekli) | - | your-token-here |
RATE_LIMIT | Özel hız sınırlaması | sınırsız | 100/1h, 50/30m |
SERP_ZONE | Arama araçlarının kullandığı özel SERP API bölge adı | mcp_serp | my_serp_zone |
BROWSER_ZONE | Özel Browser bölge adı | mcp_browser | my_browser_zone |
CONTENT_GATE | Bir 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ın | on | off |
CONTENT_GATE_TIMEOUT | İçeriği sunmadan önce kullanıcının yanıtını bekleme süresi (saniye) | 120 | 60, 300 |
BROWSER_FILTERED_SNAPSHOT | scraping_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 okunabilir | off | on |
BASE_TIMEOUT | Temel araçlar için istek zaman aşımı (saniye; arama ve kazıma) | Sınır yok | 60, 120 |
BASE_MAX_RETRIES | Geçici hatalarda temel araçlar için en fazla yeniden deneme sayısı (0-3) | 0 | 1, 3 |
GROUPS | Virgülle ayrılmış araç grubu kimlikleri. Sunucuyu bu gruplarla sınırlar | Tüm araçlar | scrapers,browser |
TOOLS | Virgülle ayrılmış tekil araç adları. Sunucuyu bu araçlarla sınırlar | Tüm araçlar | scrape_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
| Kaynak | Bağlantı |
|---|---|
| API belgeleri | docs.brightdata.com/ai/mcp-server/overview |
| Tüm araçların referansı | docs.brightdata.com/ai/mcp-server/tools |
| Agent becerileri | github.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
| Kanal | Bağlantı |
|---|---|
| GitHub sorunları | github.com/brightdata-com/brightdata-mcp/issues |
| Belgeler | docs.brightdata.com/ai/mcp-server/overview |
| E-posta | support@brightdata.com |
Lisans
MIT © Bright Data Ltd.