Was ist wigolo?

Wenn Sie Claude Code, Cursor, Codex oder andere KI-Programmier-Agents zum Schreiben von Code verwenden, werden Sie eine gravierende Einschränkung bemerken: Sie können standardmäßig nicht ins Internet zugreifen. Wenn Ihr Agent die neueste Dokumentation suchen, die Nutzung einer bestimmten API herausfinden oder einen technischen Blogartikel lesen muss, ist er auf sein veraltetes Trainingswissen angewiesen – völlig unzureichend für Ökosysteme mit schneller Iteration.

wigolo wurde entwickelt, um dieses Problem zu lösen. Es ist ein lokaler MCP-Server mit lokalem Fokus, der jedem KI-Agenten Such-, Scraping-, Crawling-, Extraktions- und Recherchefunktionen bietet – ohne API-Key und vollständig kostenlos.

Projekt Information
GitHub KnockOutEZ/wigolo
Sterne 1.750+ (auf GitHub Trending gelistet)
Sprache TypeScript (Node.js ≥ 20)
Lizenz MIT Open Source
Unterstützte Plattformen macOS / Linux / Windows

Was kann wigolo?

wigolo bietet 10 zentrale MCP-Funktionen, die sämtliche Netzwerkfähigkeiten abdecken, die ein KI-Agent benötigt:

  • search – Suchmaschinenabfragen (ohne API-Key, lokal ausgeführt)
  • fetch – Abrufen von Webseiteninhalten und Extrahieren des Haupttextes
  • crawl – Vollständiges Crawlen einer Website, Durchlaufen mehrerer Seiten
  • extract – Strukturiertes Extrahieren von Daten aus Webseiten
  • cache – Lokaler dauerhafter Cache zur Vermeidung redundanter Anfragen
  • find-similar – Finden von Seiten, die dem gegebenen Inhalt ähnlich sind
  • research – Autonome Rechercheschleife zur Zusammenfassung von Informationen aus mehreren Quellen (benötigt LLM)
  • gather – Automatisierte Sammelschleife zum Sammeln von Materialien nach Thema
  • doctor – Gesundheitscheck zur Diagnose von Konfigurationsproblemen
  • status – Anzeigen des Ausführungsstatus und von Statistiken

Alle Kernfunktionen laufen vollständig offline im Verzeichnis ~/.wigolo/ – Ihre Daten verlassen niemals Ihren Computer.

Installation und erste Schritte

Voraussetzungen

  • Node.js ≥ 20
  • Ca. 1,5 GB Festplattenspeicher

Ein-Klick-Installation

Die Installation von wigolo ist extrem einfach – nur ein einziger Befehl:

BASH 
npx wigolo init --agents=claude-code

Dieser Befehl führt automatisch folgende Schritte aus: 1. Herunterladen der Browser-Engine und lokaler Modelle 2. Durchführen eines Gesundheitschecks 3. Generieren der MCP-Konfigurationsdatei

Der Parameter --agents unterstützt die automatische Konfiguration folgender 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

Nach der Installation können Sie den Status jederzeit mit folgendem Befehl überprüfen:

BASH 
npx wigolo doctor

Bei erfolgreicher Installation sehen Sie grüne Statusmeldungen für alle Komponenten.

Integration mit anderen Agents

Falls Sie einen MCP-Client verwenden, der nicht in der Liste der automatischen Konfiguration enthalten ist (z. B. LangChain, CrewAI oder n8n), können Sie manuell registrieren:

BASH 
# Ohne Angabe von --agents, manuelle Konfiguration
npx wigolo init

Fügen Sie dann in Ihrer MCP-Konfigurationsdatei hinzu:

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

Vollständige Deinstallation

Falls Sie wigolo nicht mehr benötigen, können Sie es mit einem einzigen Befehl vollständig entfernen:

BASH 
npx wigolo config --uninstall --yes

Fortgeschrittene Anwendung

Aktivierung der LLM-gesteuerten Recherchefunktion

Die Kernfunktionen von wigolo wie Suche und Abrufen benötigen keinen API-Key. Für leistungsfähigere Funktionen wie research und gather (die ein LLM benötigen, um Informationen aus mehreren Quellen zu kombinieren), benötigen Sie jedoch einen kostenlosen Gemini-API-Key:

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

Einen kostenlosen Key können Sie unter Google AI Studio beantragen. Das kostenlose Kontingent reicht vollkommen aus.

Unterstützt werden auch andere LLM-Anbieter: - anthropic – Claude-API - openai – OpenAI-API - groq – Groq-API - ollama – Lokales Ollama (vollständig offline)

Betrieb als REST-API-Service

Falls Sie wigolo auch für entfernte Agents nutzen möchten (z. B. ein auf einem VPS bereitgestelltes n8n-Automatisierungssystem), können Sie den „serve“-Modus starten:

BASH 
npx wigolo serve --port 3000

Dann können Sie per curl aufrufen:

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"}}}'

Praxisbeispiel mit Claude Code

wigolo funktioniert am besten in Kombination mit Claude Code. Hier ist ein realistischer Workflow:

Szenario: Suche nach der neuesten Verwendung einer neuen Bibliothek

Sie geben Claude Code folgenden Befehl:

Verwende wigolo, um nach "Rust tokio 2026 best practices" zu suchen, und fasse mir die aktuellsten Schreibweisen zusammen.

Claude Code ruft automatisch das „search“-Tool von wigolo auf, um die Suchergebnisse zu erhalten, und fasst dann die Informationen aus mehreren Seiten präzise und aktuell zusammen.

Vergleich mit ähnlichen Tools

Funktion wigolo Browser-Such-Plugins Traditionelle MCP-Suchtools
API-Key erforderlich? ❌ Nein ❌ Nein ✅ Meistens ja
Kosten? ✅ Kostenlos Möglicherweise kostenpflichtig Pro Aufruf kostenpflichtig
Datenschutz? ✅ Vollständig lokal gespeichert Daten an Drittanbieter gesendet Daten an Drittanbieter gesendet
Agent-Unterstützung? ✅ Native MCP-Unterstützung Nur Browser-Plugin Teilweise unterstützt
Lokaler Cache? ✅ Integriert ❌ Nicht vorhanden Meistens nicht vorhanden
Autonome Rechercheschleife? ✅ research-Tool ❌ Nicht vorhanden ❌ Nicht vorhanden

Der größte Vorteil von wigolo ist der lokale Fokus – Ihr gesamter Suchverlauf, Cache und Rechercheergebnisse werden im Verzeichnis ~/.wigolo/ gespeichert und niemals an externe Cloud-Dienste übermittelt.

Selbst-Hosting-Lösung

Für Teamanwendungen können Sie wigolo auf einem VPS bereitstellen, sodass mehrere Entwickler ihre Agents mit einer gemeinsamen Suchinstanz teilen können.

Docker-Bereitstellung

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

Nginx Reverse-Proxy

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

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

Häufig gestellte Fragen

Ist wigolo sicher? Werden meine Daten weitergegeben?

Nein. wigolo ist ein lokal fokussiertes Tool, bei dem alle Daten im Verzeichnis ~/.wigolo/ gespeichert werden. Es sendet weder Ihren Suchverlauf noch Ihre Cache-Daten an externe Server. Die detaillierte Datenschutzerklärung finden Sie in der privacy & security-Dokumentation.

Mein Agent ruft wigolo zu langsam auf. Was kann ich tun?

Verwenden Sie npx wigolo doctor, um Probleme zu diagnostizieren. Falls lokale Modelle noch nicht vollständig heruntergeladen sind, dauert die erste Suche länger. Nach einer ersten Suche wird das Ergebnis zwischengespeichert, sodass nachfolgende Abfragen deutlich schneller sind.

Welche Suchmaschinen unterstützt wigolo?

wigolo enthält eingebaute Suchmaschinen und Scraping-Funktionen ohne externe APIs. Sie können auch über das Plugin-System benutzerdefinierte Suchmaschinen und Inhalts-Extraktoren hinzufügen.

Zusammenfassung

wigolo ist derzeit der ausgereifteste Open-Source-MCP-Server mit lokalem Fokus und schließt die entscheidende Lücke, dass KI-Programmier-Agents „nicht ins Internet können“. Sein Kernwert liegt in:

  1. Kostenlos – Kernfunktionen vollständig kostenlos, kein API-Key erforderlich
  2. Datenschutz vorrangig – Alle Daten lokal gespeichert
  3. Direkt einsatzbereit – Eine Zeile zum Installieren und integrieren
  4. Umfassend – Suche, Scraping, Crawling, Recherche, Caching komplett abgedeckt
  5. Hochgradig erweiterbar – Unterstützt Plugins, SDKs, REST-APIs und Docker-Bereitstellung

Falls Ihrem KI-Programmier-Workflow die „Internet-Suche“ fehlt, ist wigolo derzeit die beste Wahl.

📌 Weitere Links - wigolo GitHub - wigolo Dokumentation - wigolo MCP-Marktplatzseite