Offrez à un modèle LM Studio deux façons d'accéder au web.

Ce que le modèle peut atteindre

Avant l'installation

Installer et activer WebBrain Web Tools

1. Gardez LM Studio ouvert. Ouvrez la fiche Hub de webbrain/web-tools et choisissez Run in LM Studio. Vous pouvez aussi ouvrir le lien profond ci-dessous sur la même machine.
2. Activez le plugin dans la conversation.Ouvrez le contrôle des intégrations ou des outils à côté du champ de saisie et activez webbrain/web-tools.
3. Choisissez un modèle compatible avec les outils.Le plugin met ses outils à disposition de cette conversation ; le modèle décide quand les appeler selon votre demande.
4. Essayez d'abord l'itinéraire du web public.Demandez : "Lisez https://news.ycombinator.com et résumez les grands thèmes des titres du moment." Le modèle devrait utiliser research_url.

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

Installation par CLI

lms clone copie un artefact du Hub dans le répertoire courant ; il n'installe pas cette copie à lui seul. Entrez dans le répertoire cloné et exécutez la forme d'installation de lms dev :

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

Consultez la référence lms clone et la référence lms dev --install de LM Studio pour le comportement de la CLI.

Ce que le plugin offre au modèle

Utiliser les outils HTTP publics sans navigateur

Lire un article connu

Utilise research_url pour lire https://example.com/article et donne-moi la thèse principale de l'auteur, les preuves qui l'étayent et les limites qu'il indique.

Inspecter une réponse d'API

Utilise fetch_url pour lire https://api.example.com/status. Renvoie le statut HTTP et les champs qui indiquent l'état du service.

research_url convient généralement mieux au contenu rédactionnel. Utilisez fetch_url lorsque le type de réponse, la structure JSON, les en-têtes, la méthode ou le corps de la requête comptent.

Connectez le navigateur que vous utilisez déjà

1. Installez WebBrain dans un navigateur Chromium.Le pont fonctionne dans Chrome, Edge, Brave, Opera et Vivaldi. Firefox ne peut pas héberger cette connexion.
2. Activez webbrain/web-tools dans LM Studio.Le plugin ouvre son écouteur loopback local lors de son initialisation.
3. Ouvrez les réglages de WebBrain.Allez dans Paramètres → Bridge.
4. Définissez l'URL du plugin et la clé d'appairage.Saisissez ws://127.0.0.1:17375/extension, collez la clé issue de ~/.webbrain/bridge-key (créée au démarrage du plugin et partagée avec le serveur MCP) dans le champ Clé d'appairage, puis activez le pont cloud.
5. Vérifiez le parcours complet.Demandez au modèle LM Studio d'appeler browser_status. Un résultat connecté prouve que l'écouteur du plugin et la poignée de main de l'extension sont prêts.

Lire sans modifier la page

Utilise browser_task en mode Ask pour lire le tableau de bord du compte déjà ouvert dans mon navigateur et lister les cinq alertes les plus récentes. Ne change rien.

Interagir avec des portiques d'autorisation

Utilise browser_task en mode Act pour ouvrir le brouillon déjà affiché dans mon navigateur et mettre à jour le nom de l'entreprise en Acme Europe. Arrête-toi avant toute soumission ou confirmation finale.

Laissez les exécutions de navigateur en cours se poursuivre

browser_task attend un résultat, mais son délai d'expiration n'annule pas les travaux déjà en cours dans l'extension. Conservez le runId renvoyé et utilisez l'outil de reprise qui correspond à l'état.

• Ne relancez pas un browser_task en double après un délai d'expiration ; interrogez l'exécution existante.
• N'inventez jamais de réponse aux demandes de clarification de WebBrain. Demandez à l'utilisateur et transmettez sa réponse mot pour mot.
• browser_abort arrête les étapes suivantes. Il ne peut pas annuler un formulaire soumis, un message envoyé ou une autre action déjà accomplie.

Gardez distinctes les deux surfaces de confiance

• Le HTTP public s'exécute dans le processus local du plugin.fetch_url peut envoyer des méthodes, des en-têtes et des corps de requête : ne demandez une mutation que si vous l'intentionnez.
• Les cibles du réseau privé sont bloquées par défaut.Loopback, RFC1918, lien local, métadonnées cloud et noms d'hôtes intranet courants sont refusés. Pour atteindre localhost ou votre LAN, activez Allow private network access dans les réglages du plugin dans LM Studio, uniquement dans une conversation qui en a besoin. Le modèle ne peut pas l'activer lui-même, et même activé, les points de terminaison des métadonnées cloud restent bloqués.
• Les redirections sont revérifiées.Le plugin valide chaque destination et retire les en-têtes assimilables à des identifiants lorsqu'une redirection change d'origine.
• L'écouteur du navigateur reste en loopback.Ne transférez ni ne mandatez jamais le port 17375. La poignée de main de l'extension identifie le client mais n'est pas une authentification par secret partagé ; considérez les logiciels locaux comme dignes de confiance.
• Le mode Ask est le choix par défaut.N'utilisez Act que lorsque le résultat demandé exige une interaction visible dans le navigateur, et gardez la main pour arrêter tout comportement inattendu.
• Le modèle LM Studio voit les résultats des outils.Une exécution du navigateur envoie aussi le contexte de la tâche via le fournisseur actif configuré dans WebBrain. Choisissez délibérément les frontières entre les deux modèles.

Pour les détails au niveau de l'implémentation, notamment la façon dont chaque connexion est épinglée à l'adresse vérifiée, lisez les notes de sécurité du plugin.

Dépannage par symptôme

Configuration de l'environnement du pont

Si vous modifiez le port ou le chemin pour un plugin développé en local, mettez à jour l'URL du pont cloud dans les réglages de WebBrain pour qu'elle corresponde. La plupart des utilisateurs devraient garder les valeurs par défaut.