Lokaal model, live web

Geef een LM Studio-model twee manieren om het web te bereiken.

WebBrain Web Tools voegt lezen van openbare URL's toe aan elke LM Studio-chat met toolondersteuning. Met de WebBrain-extensie gekoppeld kan dezelfde plugin ook een doel doorgeven aan het Chromium-profiel waarin u al aangemeld bent.

Dit is een plugin, niet de MCP-installatie

Installeer webbrain/web-tools vanaf de LM Studio Hub. Registreer voor dit pad niet @webbrain/mcp-server en gebruik niet de MCP-poort 17374; browserdelegatie vanuit de LM Studio-plugin gebruikt poort 17375.

Eén plugin, twee routes

Wat het model kan bereiken

RouteGeschikt voorWat het niet kan
fetch_url / research_urlOpenbare artikelen, documentatie, API's, JSON, tekst en statische HTML.Geen browsercookies, JavaScript-rendereing, klikken, typen of geverifieerde sessie.
browser_taskAangemelde dashboards, webmail, client-gerenderde apps en werk dat zichtbare browserinteractie vereist.Vereist WebBrain op Chromium en de pluginbrugverbinding.

Vóór de installatie

VereisteWat te controleren
LM StudioOpen de huidige desktopapp. De meegeleverde runtime kan geïnstalleerde plugins draaien; voor normaal gebruik is een aparte Node.js-installatie niet nodig.
Tool-ondersteunend modelGebruik een model en chatconfiguratie die tools kan aanroepen. Een alleen-tekstmodel zonder toolgebruik roept de plugin niet aan.
NettoegangDe twee HTTP-tools contacteren de door u gevraagde URL vanuit het lokale pluginproces.
Optionele browserverbindingInstalleer voor browser_task WebBrain in Chrome, Edge, Brave, Opera of Vivaldi en houd poort 17375 vrij.
Actieve WebBrain-providerBrowsertaken lopen nog steeds via de provider die in de WebBrain-extensie is geconfigureerd.
Begin bij de Hub

WebBrain Web Tools installeren en inschakelen

  1. Houd LM Studio open. Open de webbrain/web-tools Hub-vermelding en kies Run in LM Studio. U kunt de diepkoppeling hieronder ook op dezelfde machine openen.
  2. Schakel de plugin in de chat in. Open de integratie- of toolbediening naast de chatinvoer en zet webbrain/web-tools aan.
  3. Kies een tool-ondersteunend model. De plugin biedt zijn tools aan die chat aan; het model beslist vanuit uw verzoek wanneer het ze aanroept.
  4. Probeer eerst de openbarewebroute. Vraag: "Lees https://news.ycombinator.com en vat de hoofdthema's van de huidige koppen samen." Het model zou research_url moeten gebruiken.
lmstudio://plugin?owner=webbrain&name=web-tools

Installatie via CLI

lms clone kopieert een Hub-artefact naar de huidige map; die kopie wordt niet automatisch geïnstalleerd. Ga de gekloonde map in en voer de installvorm van lms dev uit:

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

Zie voor het CLI-gedrag de lms clone-referentie en lms dev --install-referentie van LM Studio.

Zes tools, twee vertrouwensvlakken

Wat de plugin het model geeft

ToolGebruik het voorBrowserextensie nodig?
fetch_urlHaalt een bekende HTTP(S)-URL op. Verwerkt JSON, HTML, platte tekst, requestheaders en -bodies, en vat binaire responsen samen in plaats van ze inline te geven.Nee
research_urlExtraat leesbare artikel- of documentatietext en laat veelvoorkomende navigatie-elementen weg.Nee
browser_taskGeeft een Ask- of Act-doel in natuurlijke taal door aan WebBrain in de aangemelde browser.Ja
browser_statusControleert de extensieverbinding of pollt een bestaande run via runId.Ja
browser_respondGeeft het antwoord van de gebruiker door aan een run die gepauzeerd is bij needs_user_input.Ja
browser_abortStopt een lopende run. Voltooide acties worden niet ongedaan gemaakt.Ja
Lange pagina's worden verdicht, niet simpelweg afgekapt

Wanneer een resultaat het retourbudget overschrijdt, behouden de HTTP-tools het begin, geselecteerde high-signal middensecties en het einde. Een verdicht resultaat meldt compacted: true en bevat verdichtingsmetadata. Vraag bij belangrijke weggelaten inhoud een smallere pagina op of verhoog maxChars.

Openbare HTTP-tools zonder browser gebruiken

Een bekend artikel lezen

Lees met research_url https://example.com/article en geef het hoofdargument van de auteur, de ondersteunende bewijzen en de genoemde beperkingen.

Een API-respons controleren

Lees met fetch_url https://api.example.com/status. Geef de HTTP-status terug en de velden die de gezondheid van de dienst aangeven.

research_url is meestal de betere keuze voor prosa. Gebruik fetch_url als het exacte responsstype, de JSON-structuur, headers, methode of body ertoe doet.

Een URL-ophaling is geen browsertabblad

Deze verzoeken zijn anoniem en voeren de JavaScript van de pagina niet uit. Als een resultaat spaSuspected: true meldt of de pagina een login vereist, stop dan met het opnieuw proberen van de HTTP-route en gebruik browser_task nadat u de extensie hebt verbonden.

Optionele aangemelde route

Verbind de browser die u al gebruikt

  1. Installeer WebBrain in een Chromium-browser. De brug werkt in Chrome, Edge, Brave, Opera en Vivaldi. Firefox kan deze verbinding niet huisvesten.
  2. Schakel webbrain/web-tools in in LM Studio. De plugin opent bij initialisatie zijn lokale loopback-listener.
  3. Open de WebBrain-instellingen. Ga naar Instellingen → Bridge.
  4. Stel de plugin-URL en koppelingscode in. Voer ws://127.0.0.1:17375/extension in, plak de sleutel uit ~/.webbrain/bridge-key (angemaakt bij het starten van de plugin; gedeeld met de MCP-server) in het veld Koppelingscode en schakel daarna de cloudbrug in.
  5. Verifieer het volledige pad. Vraag het LM Studio-model browser_status aan te roepen. Een verbonden resultaat bewijst dat de plugin-listener en de extensie-handshake aanwezig zijn.
Tegelijk maar één brugbestemming

De extensie heeft één uitgaande bridge-socket. Poort 17375 verbindt die met deze plugin, poort 17374 met de MCP-server en poort 17373 met WebBrain Cloud. De URL wijzigen schakelt de bestemming; het voegt ze niet samen.

Er mogelijk twee modellen betrokken

Het LM Studio-chatmodel beslist browser_task aan te roepen en ontvangt het resultaat. De WebBrain-extensie voert de doorgegeven browserrun uit met de actieve provider die in WebBrain is geconfigureerd. Als pagina-inhoud op het apparaat moet blijven, configureer die WebBrain-provider dan ook voor een lokaal model.

Lezen zonder de pagina te wijzigen

Lees met browser_task in Ask-mode het accountdashboard dat in mijn browser openstaat en noem de vijf meest recente waarschuwingen. Wijzig niets.

Interactie via toestemmingpoortjes

Open met browser_task in Act-mode het concept dat in mijn browser zichtbaar is en werk de bedrijfsnaam bij naar Acme Europe. Stop vóór elke definitieve verzending of bevestiging.

Lopende browserruns laten doorgaan

browser_task wacht op een resultaat, maar zijn time-out annuleert het werk dat in de extensie al loopt niet. Bewaar de teruggegeven runId en gebruik het herstelhulpmiddel dat bij de status past.

runningPoll met browser_status
needs_user_inputVraag, dan browser_respond
completedResultaat klaar
failedBekijk de fout en het bewijs
abortedGestopt; eerdere acties blijven gelden
  • Start na een time-out geen dubbele browser_task; poll de bestaande run.
  • Verzin nooit een antwoord op een verduidelijkingsvraag van WebBrain. Vraag de gebruiker en geef hun antwoord woord voor woord door.
  • browser_abort stopt volgende stappen. Het kan een ingediend formulier, verzonden bericht of andere voltooide actie niet ongedaan maken.

Houd de twee vertrouwensvlakken helder

  • Openbare HTTP draait in het lokale pluginproces. fetch_url kan methoden, headers en bodies zenden, dus vraag alleen een mutatie aan als u die bedoelt.
  • Prive-netwerkdoelen worden standaard geblokkeerd. Loopback, RFC1918, link-local, cloudmetadata en veelvoorkomende intranethostnamen worden geweigerd. Zet voor localhost of uw lan Allow private network access alleen in een chat die het nodig heeft, in de plugininstellingen in LM Studio. Het model kan dit zelf niet aanzetten, en cloudmetadata-eindpunten blijven geblokkeerd zelfs als het aanstaat.
  • Redirects worden hercontroleerd. De plugin verifieert elk doel en verwijdert credential-achtige headers wanneer een redirect over origins gaat.
  • De browser-listener blijft op loopback. Forward of proxy poort 17375 nooit. De extensie-handshake identificeert de client maar is geen shared-secret-authenticatie; beschouw lokale software als vertrouwd.
  • Ask-modus is de standaard. Gebruik Act alleen wanneer het gewenste resultaat zichtbare browserinteractie vereist, en houd de browser zodanig dat u onverwacht gedrag kunt stoppen.
  • Het LM Studio-model ziet toolresultaten. Een browserrun stuurt ook taakcontext via de actieve provider die in WebBrain is geconfigureerd. Kies de grenzen van beide modellen doordacht.

Lees voor implementatiedetails, inclusief hoe elke verbinding op het gecontroleerde adres wordt vastgezet, de Veiligheidsnotities van de plugin.

Problemen oplossen per symptoom

SymptoomWat het meestal betekentOplossing
Tools verschijnen nietDe plugin is voor deze chat niet ingeschakeld, of het gekozen model kan geen tools aanroepen.Schakel webbrain/web-tools naast de chatinvoer in en kies een tool-ondersteunend model.
browser_status meldt verbrokenDe plugin is beschikbaar, maar de WebBrain-extensie is nog niet verbonden.Gebruik Chromium, schakel de cloudbrug in en voer exact ws://127.0.0.1:17375/extension in.
De listener kan niet starten of meldt een adresconflictEen andere plugin-instantie of -proces houdt poort 17375 al bezet.Sluit het dubbele instantie en herlaad de plugin. Inspecteer eerst met lsof -nP -iTCP:17375 -sTCP:LISTEN.
Een openbare pagina is leegDe pagina rendert met JavaScript of verbergt inhoud achter een login.Als spaSuspected true is, verbind dan de extensie en gebruik browser_task.
De taak had een time-out maar de browser is nog bezigHet wachtbudget is op maar de WebBrain-run is niet geannuleerd.Roep browser_status aan met de teruggegeven runId, of browser_abort als u wilt stoppen.
Firefox maakt nooit verbindingFirefox heeft geen offscreen-document-brugruntime.Gebruik een Chromium-browser voor browsertools. De twee openbare HTTP-tools zijn zonder extensie bruikbaar.
MCP of WebBrain Cloud verbrokenDe LM Studio-URL verving de ene brugbestemming van de extensie.Zet de instellingen na afloop terug op poort 17374 (MCP) of 17373 (WebBrain Cloud).

Omgevingsconfiguratie van de brug

VariabeleStandaardwaardeBetekenis
WEBBRAIN_BRIDGE_PORT17375De loopback-poort waarnaar de extensie verbindt.
WEBBRAIN_BRIDGE_PATH/extensionHet WebSocket-pad; het moet overeenkomen met de URL in de WebBrain-instellingen.
WEBBRAIN_COMMAND_TIMEOUT_MS30000Time-outbudget voor één bridge-opdracht en antwoord.

Als u de poort of het pad wijzigt voor een lokaal ontwikkelde plugin, werk de cloudbrug-URL in de WebBrain-instellingen overeenkomstig bij. De meeste gebruikers laten de standaardwaarden staan.