Yerel model, canlı web

LM Studio modeline web'e ulaşmanın iki yolunu verin.

WebBrain Web Tools, araç destekleyen herhangi bir LM Studio sohbetine herkese açık URL okuma ekler. WebBrain uzantısını eklediğinizde aynı eklenti, hedefi zaten oturum açtığınız Chromium profilinize de devredebilir.

Bu bir eklentidir, MCP kurulumu değil

webbrain/web-tools'u LM Studio Hub'dan kurun. Bu yol için @webbrain/mcp-server kaydetmeyin veya MCP portu 17374'ü kullanmayın; LM Studio eklentisinin tarayıcı devri 17375 portunu kullanır.

Tek eklenti, iki yol

Modelin erişebildikleri

LM Studio sohbet modeliistediğinizden bir araç seçer

webbrain/web-toolsyerel Node eklentisi · altı araç

Herkese açık URL veya oturum açılmış tarayıcıanonim HTTP · isteğe bağlı uzantı köprüsü

Yol	Ne için uygun	Yapamadıkları
`fetch_url` / `research_url`	Herkese açık makaleler, belgeler, API'ler, JSON, metin ve statik HTML.	Tarayıcı çerezleri, JavaScript işleme, tıklama, yazma veya kimliği doğrulanmış oturum yok.
`browser_task`	Oturum açılmış panolar, web postası, istemci tarafında işlenen uygulamalar ve görünür tarayıcı etkileşimi gerektiren işler.	Chromium'da WebBrain ve eklenti köprüsü bağlantısı gerektirir.

Kurulumdan önce

Gereksinim	Ne kontrol edilmeli
LM Studio	Güncel masaüstü uygulamasını açın. Gömülü çalışma zamanı yüklü eklentileri çalıştırabilir; olağan kullanım için ayrı bir Node.js kurulumu gerekmez.
Araç destekleyen model	Araç çağırabilen bir model ve sohbet yapılandırması kullanın. Araç kullanımı olmayan metin tabanlı bir model eklentiyi çağırmaz.
Ağ erişimi	İki HTTP aracı, istediğiniz URL ile yerel eklenti sürecinden iletişim kurar.
İsteğe bağlı tarayıcı bağlantısı	`browser_task` için WebBrain'i Chrome, Edge, Brave, Opera veya Vivaldi'ye kurun ve `17375` portunu boş tutun.
Etkin WebBrain sağlayıcısı	Tarayıcı görevleri yine de WebBrain uzantısı içinde yapılandırılan sağlayıcı üzerinden çalışır.

Hub'dan başlayın

WebBrain Web Tools'ı kurma ve etkinleştirme

LM Studio'yu açık tutun. webbrain/web-tools Hub listesi'ni açın ve Run in LM Studio öğesini seçin. Aşağıdaki derin bağlantıyı aynı makinede de açabilirsiniz.
Eklentiyi sohbette etkinleştirin. Sohbet girişinin yanındaki entegrasyon veya araç denetimini açın ve webbrain/web-tools öğesini açın.
Araç destekleyen bir model seçin. Eklenti araçlarını bu sohbete sunar; model hangi anda çağıracağına isteğinize bakarak karar verir.
Önce herkese açık web yolunu deneyin. Şunu sorun: "https://news.ycombinator.com adresini oku ve mevcut manşetlerin ana temalarını özetle." Model research_url kullanmalıdır.

lmstudio://plugin?owner=webbrain&name=web-tools

CLI ile kurulum

lms clone, Hub artefaktını geçerli dizine kopyalar; bu kopyayı kendiliğinden kurmaz. Klonlanan dizine girin ve lms dev komutunun kurulum biçimini çalıştırın:

lms clone webbrain/web-tools
cd web-tools
lms dev --install

CLI davranışı için LM Studio'nun lms clone referansına ve lms dev --install referansına bakın.

Altı araç, iki güven yüzeyi

Eklentinin modele verdiği yetenekler

Araç	Ne için kullanılır	Tarayıcı uzantısı gerekir mi?
`fetch_url`	Bilinen bir HTTP(S) URL'sini getirir. JSON, HTML, düz metin, istek başlıkları ve gövdelerini işler; ikili yanıtları satır içi vermek yerine özetler.	Hayır
`research_url`	Yaygın gezinme öğelerini atarak okunabilir makale veya belge metnini çıkarır.	Hayır
`browser_task`	Doğal dilde bir Ask veya Act hedefini oturum açılmış tarayıcıdaki WebBrain'e devreder.	Evet
`browser_status`	Uzantı bağlantısını denetler veya `runId` ile mevcut bir çalışmayı yoklar.	Evet
`browser_respond`	Kullanıcının yanıtını `needs_user_input` durumunda durmuş bir çalışmaya iletir.	Evet
`browser_abort`	Devam eden bir çalışmayı durdurur. Tamamlanmış işlemler geri alınmaz.	Evet

Uzun sayfalar kesilmez, sıkıştırılır

Bir sonuç iade bütçesini aştığında HTTP araçları başı, seçilen yüksek sinyalli orta pasajları ve sonu tutar. Sıkıştırılmış bir sonuç compacted: true bildirir ve sıkıştırma üst verisi içerir. Atlanan içerik önemliyse daha dar bir sayfa isteyin veya maxChars değerini artırın.

Tarayıcı olmadan herkese açık HTTP araçlarını kullanma

Bilinen bir makaleyi okuma

research_url ile https://example.com/article makalesini oku ve yazarın ana iddiasını, destekleyici kanıtlarını ve belirttiği sınırlılıkları ver.

Bir API yanıtını inceleme

fetch_url ile https://api.example.com/status adresini oku. HTTP durumunu ve servisin sağlığını gösteren alanları döndür.

research_url genellikle düz yazı için daha iyi bir seçimdir. Yanıt türü, JSON yapısı, başlıklar, yöntem veya gövde önemliyse fetch_url kullanın.

URL getirme bir tarayıcı sekmesi değildir

Bu istekler anonimdir ve sayfanın JavaScript'ini çalıştırmaz. Bir sonuç spaSuspected: true bildirirse veya sayfa giriş gerektiriyorsa HTTP yolunu yeniden denemeyi bırakın ve uzantıyı bağladıktan sonra browser_task kullanın.

İsteğe bağlı oturum açılmış yol

Kullandığınız tarayıcıyı bağlayın

WebBrain'i bir Chromium tarayıcısına kurun. Köprü Chrome, Edge, Brave, Opera ve Vivaldi'de çalışır. Firefox bu bağlantıyı barındıramaz.
webbrain/web-tools'u LM Studio'da etkinleştirin. Eklenti başlatılırken yerel loopback dinleyicisini açar.
WebBrain Ayarlarını açın. Ayarlar → Bridge yoluna gidin.
Eklenti URL'sini ve eşleştirme anahtarını ayarlayın. ws://127.0.0.1:17375/extension adresini girin, ~/.webbrain/bridge-key dosyasındaki anahtarı (eklenti başlatıldığında oluşturulur; MCP sunucusuyla paylaşıılır) Eşleştirme anahtarı alanına yapıştırın, ardından bulut köprüsünü etkinleştirin.
Tam yolu doğrulayın. LM Studio modelinden browser_status çağırmasını isteyin. Bağlandı sonucu, eklenti dinleyicisinin ve uzantı sıkışmasının hazır olduğunu kanıtlar.

Aynı anda yalnızca bir köprü hedefi

Uzantının tek bir giden köprü soketi vardır. 17375 portu onu bu eklentiye, 17374 portu MCP sunucusuna ve 17373 portu WebBrain Cloud'a bağlar. URL'yi değiştirmek hedefi geçirir; onları birleştirmez.

İki model ilgili olabilir

LM Studio sohbet modeli browser_task çağırmaya karar verir ve sonucu alır. WebBrain uzantısı, devredilen tarayıcı çalışmasını WebBrain içinde yapılandırılan etkin sağlayıcıyla yürütür. Sayfa içeriği cihazda kalmalıysa o WebBrain sağlayıcısını da yerel bir model kullanacak şekilde yapılandırın.

Sayfayı değiştirmeden okuma

Ask modunda browser_task ile tarayıcımda açık olan hesap panosunu oku ve en son beş uyarıyı listele. Hiçbir şeyi değiştirme.

İzin kapılarıyla etkileşim

Act modunda browser_task ile tarayıcımda görünen taslağı aç ve şirket adını Acme Europe olarak güncelle. Herhangi bir nihai gönderim veya onaydan önce dur.

Devam eden tarayıcı çalışmalarına devam edin

browser_task bir sonuç bekler, ancak zaman aşımı uzantıda zaten çalışan işi iptal etmez. Dönen runId'yi saklayın ve durumla eşleşen kurtarma aracını kullanın.

runningbrowser_status ile yoklayın

needs_user_inputSorun, sonra browser_respond kullanın

completedSonuç hazır

failedHatayı ve kanıtları görüntüleyin

abortedDurduruldu; önceki işlemler geçerli

Zaman aşımından sonra yinelenen bir browser_task başlatmayın; mevcut çalışmayı yoklayın.
WebBrain'in netleştirme sorularına asla uydurma yanıt vermeyin. Kullanıcıya sorun ve yanıtını kelimesi kelimesine iletin.
browser_abort sonraki adımları durdurur. Gönderilmiş bir formu, iletilmiş bir mesajı veya diğer tamamlanmış işlemleri geri alamaz.

İki güven yüzeyini net tutun

Herkese açık HTTP, yerel eklenti sürecinde çalışır. fetch_url yöntem, başlık ve gövde gönderebilir; bu nedenle yalnızca kasdettiğinizde bir değişiklik isteğinde bulunun.
Özel ağ hedefleri varsayılan olarak engellenir. Loopback, RFC1918, link-local, bulut meta verisi ve yaygın intranet ana bilgisayar adları reddedilir. localhost veya yerel ağa erişmek için yalnızca gereken sohbette, LM Studio'daki eklenti ayarlarında Allow private network access seçeneğini açın. Model bu ayarı kendisi açamaz ve açılsa bile bulut meta verisi uç noktaları engelli kalır.
Yönlendirmeler yeniden denetlenir. Eklenti her hedefi doğrular ve yönlendirme origin'ler arası olduğunda kimlik bilgisi benzeri başlıkları kaldırır.
Tarayıcı dinleyicisi loopback'te kalır. 17375 portunu asla iletmeyin veya proxy'lemeyin. Uzantı sıkışması istemciyi tanır ancak paylaşılan gizli anahtar kimlik doğrulaması değildir; yerel yazılımı güvenilir sayın.
Ask modu varsayılandır. Act'i yalnızca istenen sonuç görünür tarayıcı etkileşimi gerektirdiğinde kullanın ve tarayıcıyı beklenmedik davranışı durdurabileceğiniz şekilde tutun.
LM Studio modeli araç sonuçlarını görür. Bir tarayıcı çalışması ayrıca görev bağlamını WebBrain içinde yapılandırılan etkin sağlayıcı üzerinden gönderir. Her iki modelin sınırlarını dikkatle seçin.

Uygulama düzeyindeki ayrıntılar (her bağlantının denetlenen adrese nasıl sabitlendiği dahil) için eklentinin Güvenlik notları bölümünü okuyun.

Belirtiye göre sorun giderme

Belirti	Genellikle ne anlama gelir	Çözüm
Araçlar görünmüyor	Eklenti bu sohbet için etkin değil veya seçilen model araç çağıramıyor.	Sohbet girişinin yanında webbrain/web-tools'u etkinleştirin ve araç destekleyen bir model seçin.
`browser_status` bağlantısız bildiriyor	Eklenti kullanılabilir ancak WebBrain uzantısı henüz bağlanmadı.	Chromium kullanın, bulut köprüsünü etkinleştirin ve `ws://127.0.0.1:17375/extension` adresini birebir girin.
Dinleyici başlayamıyor veya adres çakışması bildiriyor	Başka bir eklenti örneği veya süreç `17375` portunu zaten tutuyor.	Yinelenen örneği kapatın, ardından eklentiyi yeniden yükleyin. Önce `lsof -nP -iTCP:17375 -sTCP:LISTEN` ile denetleyin.
Herkese açık sayfa boş	Sayfa JavaScript ile işleniyor veya içeriği giriş arkasına gizliyor.	`spaSuspected` true ise uzantıyı bağlayın ve `browser_task` kullanın.
Görev zaman aşımına uğradı ama tarayıcı hâlâ işlem yapıyor	Bekleme bütçesi tükendi ancak WebBrain çalışması iptal edilmedi.	Dönen `runId` ile `browser_status` çağırın veya durdurmak istediğinizde `browser_abort` kullanın.
Firefox hiç bağlanmıyor	Firefox'un ekran dışı belge köprüsü çalışma zamanı yok.	Tarayıcı araçları için bir Chromium tarayıcısı kullanın. İki herkese açık HTTP aracı uzantı olmadan kullanılabilir.
MCP veya WebBrain Cloud bağlantısı koptu	LM Studio URL'si uzantının tek köprü hedefinin yerini aldı.	İşiniz bitince ayarları `17374` portuna (MCP) veya `17373` portuna (WebBrain Cloud) geri değiştirin.

Köprü ortam yapılandırması

Değişken	Varsayılan	Anlamı
`WEBBRAIN_BRIDGE_PORT`	`17375`	Uzantının bağlandığı loopback portu.
`WEBBRAIN_BRIDGE_PATH`	`/extension`	WebSocket yolu; WebBrain ayarlarındaki URL ile eşleşmelidir.
`WEBBRAIN_COMMAND_TIMEOUT_MS`	`30000`	Bir köprü komutu ve yanıtı için zaman aşımı bütçesi.

Yerel olarak geliştirilen bir eklenti için portu veya yolu değiştirirseniz WebBrain ayarlarındaki bulut köprüsü URL'sini eşitleyin. Çoğu kullanıcı varsayılanları bırakmalıdır.