Bulut tarayıcı etkileşimlerini otomatikleştirin (örneğin web gezintisi, veri çıkarma, form doldurma ve daha fazlası)
Neler yapabilirsiniz?
- Bir bulut tarayıcı oturumu başlatın — Asistanınızdan start ile bir Browserbase oturumu oluşturmasını veya yeniden kullanmasını isteyin.
- Herhangi bir URL'ye gidin — Tarayıcıyı navigate kullanarak belirli bir web sayfasına yönlendirin.
- Bir sayfada işlemler gerçekleştirin — Asistanınıza act ile öğelere tıklaması, yazması veya etkileşimde bulunması talimatını verin.
- Etkileşimli öğeleri gözlemleyin — Bir talimatla eşleşen, işlem yapılabilir sayfa öğelerinin listesini observe ile isteyin.
- Yapılandırılmış veri çıkarın — Geçerli sayfadan extract kullanarak bilgi alın, isteğe bağlı olarak doğal dil talimatıyla yönlendirilir.
- Tarayıcı oturumunu sonlandırın — Etkin Browserbase oturumunu end ile düzgün bir şekilde kapatın.
Browserbase MCP Sunucusu
Arşivlendi
Bu depo arşivlenmiştir ve artık bakımı yapılmamaktadır.
Başlangıçta bir referans uygulama olarak yayınlanmıştır ve tarihsel amaçlarla saklanmaktadır. Browserbase'in mevcut üretim hizmetlerini veya uygulamasını temsil ettiği şeklinde yorumlanmamalıdır.
Model Bağlam Protokolü (MCP), LLM uygulamaları ile harici veri kaynakları ve araçlar arasında sorunsuz entegrasyon sağlayan açık bir protokoldür. İster yapay zeka destekli bir IDE geliştiriyor olun, ister bir sohbet arayüzünü geliştiriyor olun, isterse özel yapay zeka iş akışları oluşturuyor olun, MCP, LLM'leri ihtiyaç duydukları bağlamla bağlamak için standartlaştırılmış bir yol sunar.
Bu sunucu, Browserbase ve Stagehand kullanarak bulut tarayıcı otomasyon yetenekleri sağlar. LLM'lerin web sayfalarıyla etkileşime girmesini, bilgi çıkarmasını ve otomatik eylemler gerçekleştirmesini sağlar.
Bu, aynı araçlara ve işlevselliğe sahip Browserbase tarafından barındırılan MCP sunucusunun kendi kendine barındırılabilir bir sürümüdür. En kolay kurulum için barındırılan sürümü kullanmanızı öneririz.
Araçlar
Bu sunucu, barındırılan Browserbase MCP sunucusuyla eşleşen 6 araç sunar:
| Araç | Açıklama | Girdi |
|---|---|---|
start |
Bir Browserbase oturumu oluştur veya yeniden kullan | (yok) |
end |
Geçerli Browserbase oturumunu kapat | (yok) |
navigate |
Bir URL'ye git | { url: string } |
act |
Sayfada bir eylem gerçekleştir | { action: string } |
observe |
Sayfadaki eyleme dönüştürülebilir öğeleri gözlemle | { instruction: string } |
extract |
Sayfadan veri çıkar | { instruction?: string } |
Kurulum
Şu anda MCP sunucumuz için STDIO ve SHTTP olmak üzere 2 aktarımı destekliyoruz. Sunucudan tam kapasiteyle yararlanmak için barındırılan MCP sunucumuzla SHTTP kullanmanızı öneririz.
SHTTP (Barındırılan MCP):
https://mcp.browserbase.com/mcp adresindeki Browserbase tarafından barındırılan MCP sunucusunu kullanın. Bu, başlamanın en kolay yoludur — sunucuyu biz barındırırız ve Stagehand'deki en iyi performans gösteren model olan Gemini için LLM maliyetlerini sağlarız.
Tam kurulum talimatları için Browserbase MCP belgelerine bakın.
İstemciniz SHTTP'yi destekliyorsa:
{ "mcpServers": { "browserbase": { "type": "http", "url": "https://mcp.browserbase.com/mcp" } }
}
İstemciniz SHTTP'yi desteklemiyorsa:
{ "mcpServers": { "browserbase": { "command": "npx", "args": ["mcp-remote", "https://mcp.browserbase.com/mcp"] } }
}
STDIO (Kendi Kendine Barındırılan):
NPM'de barındırılan sunucumuzu kullanabilir veya bu depoyu klonlayarak tamamen yerel olarak çalıştırabilirsiniz.
Not: Farklı bir model kullanmak istiyorsanız, argümanlara –modelName eklemeli ve ilgili anahtarı bir argüman olarak sağlamalısınız. Daha fazla bilgi aşağıda.
NPM üzerinden çalıştırmak için (Önerilir)
MCP Yapılandırma JSON'unuza gidin ve Browserbase Sunucusunu ekleyin:
{ "mcpServers": { "browserbase": { "command": "npx", "args": ["@browserbasehq/mcp"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } }
}
Hepsi bu kadar! MCP istemcinizi yeniden yükleyin, kullanıma hazırsınız.
%100 yerel olarak çalıştırmak için:
Seçenek 1: Doğrudan kurulum
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
npm install && npm run build
Seçenek 2: Docker
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
docker build -t mcp-browserbase .
Ardından MCP Yapılandırma JSON'unuzda sunucuyu çalıştırın:
Doğrudan Kurulum Kullanarak
{ "mcpServers": { "browserbase": { "command": "node", "args": ["/path/to/mcp-server-browserbase/cli.js"], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } }
}
Docker Kullanarak
{ "mcpServers": { "browserbase": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "BROWSERBASE_API_KEY", "-e", "BROWSERBASE_PROJECT_ID", "-e", "GEMINI_API_KEY", "mcp-browserbase" ], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "", "GEMINI_API_KEY": "" } } }
}
Yapılandırma
Browserbase MCP sunucusu aşağıdaki komut satırı bayraklarını kabul eder:
| Bayrak | Açıklama |
|---|---|
--proxies |
Oturum için Browserbase proxy'lerini etkinleştir |
--verified |
Browserbase Doğrulanmış Kimliği Etkinleştir (Yalnızca Scale Plan Kullanıcıları İçin) |
--advancedStealth |
--verified için kullanımdan kaldırılmış takma ad |
--keepAlive |
Browserbase Oturumu Canlı Tutmayı Etkinleştir |
--contextId <contextId> |
Kullanılacak bir Browserbase Bağlam Kimliği belirtin |
--persist |
Browserbase bağlamının kalıcı olup olmayacağı (varsayılan: true) |
--port <port> |
HTTP/SHTTP aktarımı için dinlenecek bağlantı noktası |
--host <host> |
Sunucunun bağlanacağı ana bilgisayar (varsayılan: localhost, tüm arayüzler için 0.0.0.0 kullanın) |
--browserWidth <width> |
Tarayıcı görüntü alanı genişliği (varsayılan: 1024) |
--browserHeight <height> |
Tarayıcı görüntü alanı yüksekliği (varsayılan: 768) |
--modelName <model> |
Stagehand için kullanılacak model (varsayılan: google/gemini-2.5-flash-lite) |
--modelApiKey <key> |
Özel model sağlayıcısı için API anahtarı (özel modeller kullanılırken gereklidir) |
--experimental |
Deneysel özellikleri etkinleştir (varsayılan: false) |
Bu bayraklar doğrudan CLI'ye iletilebilir veya MCP yapılandırma dosyanızda yapılandırılabilir.
Not: Bu bayraklar yalnızca kendi kendine barındırılan sunucuyla (npx @browserbasehq/mcp veya Docker) kullanılabilir.
Model Yapılandırması
Stagehand varsayılan olarak Google'ın Gemini 2.5 Flash Lite modelini kullanır, ancak GPT-4o, Claude veya diğer sağlayıcılar gibi diğer modelleri kullanacak şekilde yapılandırabilirsiniz.
Önemli: Herhangi bir özel model (varsayılan olmayan) kullanırken, --modelApiKey bayrağını kullanarak o model sağlayıcısı için kendi API anahtarınızı sağlamanız gerekir.
{ "mcpServers": { "browserbase": { "command": "npx", "args": [ "@browserbasehq/mcp", "--modelName", "anthropic/claude-sonnet-4.5", "--modelApiKey", "your-anthropic-api-key" ], "env": { "BROWSERBASE_API_KEY": "", "BROWSERBASE_PROJECT_ID": "" } } }
}
Not: Model Stagehand'de desteklenmelidir. Belgeleri buradan kontrol edin.
Bağlantılar
Lisans
Apache 2.0 Lisansı altında lisanslanmıştır.
Telif Hakkı 2025 Browserbase, Inc.
Kurulum
https://mcp.browserbase.com/mcpKaynak: mcpservers.org