Qu'est-ce que wigolo ?

Si vous utilisez des Agents de programmation IA comme Claude Code, Cursor ou Codex pour écrire du code, vous avez sûrement remarqué un défaut majeur : ils ne peuvent pas se connecter à Internet par défaut. Quand votre Agent a besoin de chercher la dernière documentation, de trouver comment utiliser une API, ou de lire un article technique, il doit se fier à des connaissances datant de son entraînement — ce qui est loin d'être suffisant dans un écosystème technique qui évolue si vite.

wigolo a été créé précisément pour résoudre ce problème. C'est un serveur MCP intelligent pour le web, local-first et open-source, qui donne à tout Agent IA la capacité de rechercher, crawler, extraire et étudier Internet — sans clé API, totalement gratuit.

Projet Information
GitHub KnockOutEZ/wigolo
Stars 1 750+ (présent dans GitHub Trending)
Langage TypeScript (Node.js ≥ 20)
Licence MIT open source
Plateformes macOS / Linux / Windows

Que peut faire wigolo ?

wigolo propose 10 fonctions MCP essentielles, couvrant toutes les capacités réseau dont un Agent IA a besoin :

  • search — Requête via moteur de recherche (sans clé API, exécution locale)
  • fetch — Récupérer le contenu d'une page web et en extraire le texte
  • crawl — Crawl de site entier, navigation sur plusieurs pages
  • extract — Extraction structurée de données depuis des pages web
  • cache — Cache local persistant, évite les requêtes répétées
  • find-similar — Trouver des pages similaires à un contenu donné
  • research — Cycle de recherche autonome, synthèse d'informations multi-sources (nécessite un LLM)
  • gather — Collecte automatique par thème
  • doctor — Vérification de santé, diagnostic de configuration
  • status — Afficher l'état et les statistiques

Toutes les fonctionnalités principales tournent entièrement en local dans le répertoire ~/.wigolo/, vos données ne quittent jamais votre machine.

Installation et prise en main

Prérequis

  • Node.js ≥ 20
  • Environ 1,5 Go d'espace disque

Installation en une commande

Installer wigolo est d'une simplicité déconcertante :

BASH 
npx wigolo init --agents=claude-code

Cette commande automatise tout : 1. Téléchargement du moteur de navigateur et du modèle local 2. Exécution d'un diagnostic de santé 3. Écriture du fichier de configuration MCP

Le paramètre --agents supporte la configuration automatique de ces Agents : - claude-code — Claude Code - cursor — Cursor IDE - codex — ChatGPT Codex - gemini-cli — Gemini CLI - vscode — VS Code - windsurf — Windsurf IDE - zed — Zed IDE - antigravity — Antigravity

Après l'installation, vérifiez que tout fonctionne avec :

BASH 
npx wigolo doctor

Si tout est en ordre, vous verrez un rapport vert pour chaque composant.

Intégration avec d'autres Agents

Si vous utilisez un client MCP qui n'est pas dans la liste de configuration automatique (comme LangChain, CrewAI ou n8n), configurez manuellement :

BASH 
# Sans --agents, configuration manuelle
npx wigolo init

Puis ajoutez dans votre fichier de configuration MCP :

JSON 
{
  "mcpServers": {
    "wigolo": {
      "command": "npx",
      "args": ["-y", "wigolo", "stdio"]
    }
  }
}

Désinstallation complète

Besoin de faire le ménage ? Une seule commande :

BASH 
npx wigolo config --uninstall --yes

Utilisations avancées

Activer les fonctionnalités de recherche pilotées par LLM

Les fonctions de recherche et de crawl de wigolo ne nécessitent aucune clé API. Mais si vous voulez débloquer research et gather — qui utilisent un LLM pour synthétiser des informations provenant de multiples sources — il vous suffit d'une clé API Gemini gratuite :

BASH 
export WIGOLO_LLM_PROVIDER=gemini
export GEMINI_API_KEY="your-free-key"

Demandez votre clé sur Google AI Studio. Le quota gratuit est largement suffisant.

wigolo supporte aussi d'autres fournisseurs LLM : - anthropic — Claude API - openai — OpenAI API - groq — Groq API - ollama — Ollama local (totalement hors ligne)

Exécuter comme service REST API

Pour qu'un Agent distant (par exemple n8n déployé sur un VPS) puisse aussi utiliser wigolo, lancez-le en mode serveur :

BASH 
npx wigolo serve --port 3000

Puis appelez avec curl :

BASH 
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"latest Rust async best practices"}}}'

Cas pratique avec Claude Code

wigolo donne son plein potentiel lorsqu'il est combiné avec Claude Code. Voici un exemple concret :

Scénario : trouver comment utiliser une nouvelle bibliothèque

Dites à Claude Code :

Utilise wigolo pour chercher "Rust tokio 2026 best practices" et fais-moi un résumé des dernières pratiques

Claude Code appellera automatiquement l'outil search de wigolo, consultera plusieurs pages, et vous renverra un résumé précis et à jour.

Comparaison avec les outils similaires

Fonctionnalité wigolo Extension de recherche navigateur Outils MCP de recherche traditionnels
Clé API requise ❌ Non ❌ Non ✅ Généralement oui
Coût ✅ Gratuit Peut être payant Payant par requête
Confidentialité ✅ Tout stocké localement Données envoyées à des tiers Données envoyées à des tiers
Support Agent ✅ Support MCP natif Extension navigateur uniquement Support partiel
Cache local ✅ Intégré ❌ Non Généralement non
Cycle de recherche autonome ✅ Outil research ❌ Non ❌ Non

Le grand avantage de wigolo, c'est le local-first — tout votre historique de recherche, vos données en cache et vos résultats de recherche restent dans ~/.wigolo/, sans jamais être envoyés vers un service cloud.

Déploiement sur son propre serveur

Pour un usage en équipe, vous pouvez déployer wigolo sur un VPS et partager une seule instance de recherche entre plusieurs développeurs.

Déploiement Docker

DOCKERFILE 
FROM node:20-slim
RUN npm install -g wigolo
EXPOSE 3000
CMD ["npx", "wigolo", "serve", "--port", "3000"]

Reverse proxy Nginx

NGINX 
server {
    listen 443 ssl;
    server_name wigolo.votredomaine.com;

    location /mcp {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
    }
}

Questions fréquentes

wigolo est-il sûr ? Mes données sont-elles protégées ?

Oui. wigolo est un outil local-first : toutes les données sont stockées dans ~/.wigolo/. Aucun historique de recherche ni donnée de cache n'est envoyé à un serveur externe. Pour plus de détails, consultez la documentation privacy & security.

Mon Agent est trop lent avec wigolo, que faire ?

Lancez npx wigolo doctor pour diagnostiquer. Si le modèle local n'a pas encore été téléchargé, la première recherche sera lente. Une fois effectuée, les résultats sont mis en cache et les recherches suivantes seront beaucoup plus rapides.

wigolo supporte-t-il les moteurs de recherche ?

wigolo intègre nativement plusieurs moteurs de recherche et capacités de crawl, sans API externe. Vous pouvez aussi ajouter des moteurs de recherche personnalisés via le système de plugins.

Conclusion

wigolo est actuellement le serveur MCP réseau open-source le plus mature, comblant le fossé majeur des Agents IA de programmation qui « ne peuvent pas se connecter à Internet ». Ses atouts principaux :

  1. Coût zéro — Fonctionnalités de base gratuites, sans clé API
  2. Confidentialité — Toutes les données restent en local
  3. Prêt à l'emploi — Installation et intégration Agent en une ligne de commande
  4. Complet — Recherche, crawl, extraction, recherche en profondeur, cache
  5. Hautement extensible — Plugins, SDK, API REST, déploiement Docker

Si votre workflow IA de programmation manque encore du chaînon « recherche en ligne », wigolo est sans doute la meilleure option disponible.

📌 Liens utiles - wigolo sur GitHub - Documentation wigolo - wigolo sur MCP Market