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.
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.
Wat het model kan bereiken
| Route | Geschikt voor | Wat het niet kan |
|---|---|---|
fetch_url / research_url | Openbare artikelen, documentatie, API's, JSON, tekst en statische HTML. | Geen browsercookies, JavaScript-rendereing, klikken, typen of geverifieerde sessie. |
browser_task | Aangemelde dashboards, webmail, client-gerenderde apps en werk dat zichtbare browserinteractie vereist. | Vereist WebBrain op Chromium en de pluginbrugverbinding. |
Vóór de installatie
| Vereiste | Wat te controleren |
|---|---|
| LM Studio | Open de huidige desktopapp. De meegeleverde runtime kan geïnstalleerde plugins draaien; voor normaal gebruik is een aparte Node.js-installatie niet nodig. |
| Tool-ondersteunend model | Gebruik een model en chatconfiguratie die tools kan aanroepen. Een alleen-tekstmodel zonder toolgebruik roept de plugin niet aan. |
| Nettoegang | De twee HTTP-tools contacteren de door u gevraagde URL vanuit het lokale pluginproces. |
| Optionele browserverbinding | Installeer voor browser_task WebBrain in Chrome, Edge, Brave, Opera of Vivaldi en houd poort 17375 vrij. |
| Actieve WebBrain-provider | Browsertaken lopen nog steeds via de provider die in de WebBrain-extensie is geconfigureerd. |
WebBrain Web Tools installeren en inschakelen
- 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.
- Schakel de plugin in de chat in. Open de integratie- of toolbediening naast de chatinvoer en zet webbrain/web-tools aan.
- Kies een tool-ondersteunend model. De plugin biedt zijn tools aan die chat aan; het model beslist vanuit uw verzoek wanneer het ze aanroept.
- Probeer eerst de openbarewebroute. Vraag: "Lees https://news.ycombinator.com en vat de hoofdthema's van de huidige koppen samen." Het model zou
research_urlmoeten gebruiken.
lmstudio://plugin?owner=webbrain&name=web-toolsInstallatie 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 --installZie voor het CLI-gedrag de lms clone-referentie en lms dev --install-referentie van LM Studio.
Wat de plugin het model geeft
| Tool | Gebruik het voor | Browserextensie nodig? |
|---|---|---|
fetch_url | Haalt 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_url | Extraat leesbare artikel- of documentatietext en laat veelvoorkomende navigatie-elementen weg. | Nee |
browser_task | Geeft een Ask- of Act-doel in natuurlijke taal door aan WebBrain in de aangemelde browser. | Ja |
browser_status | Controleert de extensieverbinding of pollt een bestaande run via runId. | Ja |
browser_respond | Geeft het antwoord van de gebruiker door aan een run die gepauzeerd is bij needs_user_input. | Ja |
browser_abort | Stopt een lopende run. Voltooide acties worden niet ongedaan gemaakt. | Ja |
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.
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.
Verbind de browser die u al gebruikt
- Installeer WebBrain in een Chromium-browser. De brug werkt in Chrome, Edge, Brave, Opera en Vivaldi. Firefox kan deze verbinding niet huisvesten.
- Schakel webbrain/web-tools in in LM Studio. De plugin opent bij initialisatie zijn lokale loopback-listener.
- Open de WebBrain-instellingen. Ga naar Instellingen → Bridge.
- Stel de plugin-URL en koppelingscode in. Voer
ws://127.0.0.1:17375/extensionin, 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. - Verifieer het volledige pad. Vraag het LM Studio-model
browser_statusaan te roepen. Een verbonden resultaat bewijst dat de plugin-listener en de extensie-handshake aanwezig zijn.
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.
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_statusneeds_user_inputVraag, dan browser_respondcompletedResultaat klaarfailedBekijk de fout en het bewijsabortedGestopt; 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_abortstopt 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_urlkan 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
17375nooit. 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
| Symptoom | Wat het meestal betekent | Oplossing |
|---|---|---|
| Tools verschijnen niet | De 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 verbroken | De 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 adresconflict | Een 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 leeg | De 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 bezig | Het 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 verbinding | Firefox heeft geen offscreen-document-brugruntime. | Gebruik een Chromium-browser voor browsertools. De twee openbare HTTP-tools zijn zonder extensie bruikbaar. |
| MCP of WebBrain Cloud verbroken | De 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
| Variabele | Standaardwaarde | Betekenis |
|---|---|---|
WEBBRAIN_BRIDGE_PORT | 17375 | De loopback-poort waarnaar de extensie verbindt. |
WEBBRAIN_BRIDGE_PATH | /extension | Het WebSocket-pad; het moet overeenkomen met de URL in de WebBrain-instellingen. |
WEBBRAIN_COMMAND_TIMEOUT_MS | 30000 | Time-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.
