🚀 OneSearch MCP-Server: Websuche & Crawl & Scraper & Inhaltsaufbereitung

Eine Implementierung eines Model Context Protocol (MCP)-Servers, die sich für Websuche, lokale Browsersuche und Scraping-Funktionen mit agent-browser in mehrere Suchanbieter integriert.

Funktionen

• Websuche, Scraping, Crawling und Vorverarbeitung von Inhalten von Websites.

• Unterstützung mehrerer Suchmaschinen und Web-Scraper: SearXNG, Tavily, DuckDuckGo, Bing, Google, Zhipu (智谱), Exa, Bocha (博查) usw.

• Lokale Websuche (Browsersuche), Unterstützung mehrerer Suchmaschinen: Bing, Google, Baidu, Sogou usw.

  • Verwendung von agent-browser für Browser-Automatisierung.

  • Kostenlos, keine API-Schlüssel erforderlich.

• Aktivierte Tools: one_search, one_scrape, one_map, one_extract

Related MCP server: Firecrawl MCP Server

Migration von v1.1.0 und früher

Breaking Changes in v1.1.0:

• Firecrawl entfernt: Die Firecrawl-Integration wurde zugunsten von agent-browser entfernt, das ähnliche Funktionen bietet, ohne externe API-Dienste zu erfordern.

• Neue Browser-Anforderung: Sie müssen den Chromium-Browser installieren (siehe Abschnitt Voraussetzungen).

• Umgebungsvariablen: FIRECRAWL_API_URL und FIRECRAWL_API_KEY werden nicht mehr verwendet.

Was hat sich geändert:

• one_scrape und one_map verwenden jetzt agent-browser anstelle von Firecrawl

• one_extract bereitet jetzt Seiteninhalte mit mehreren URLs für die nachgelagerte Analyse vor, anstatt eine integrierte LLM-Extraktion durchzuführen

• Alle browserbasierten Vorgänge werden jetzt lokal abgewickelt, was für besseren Datenschutz sorgt und keine API-Kosten verursacht

Migrationsschritte:

1. Chromium-Browser installieren (siehe Voraussetzungen)

2. FIRECRAWL_API_URL und FIRECRAWL_API_KEY aus Ihren Umgebungsvariablen entfernen

3. Auf die neueste Version aktualisieren: npm install -g one-search-mcp@latest

Voraussetzungen

Browser-Anforderung: Dieser Server verwendet agent-browser für Web-Scraping und lokale Suche, was einen Chromium-basierten Browser erfordert.

Gute Nachrichten: Der Server erkennt und verwendet automatisch Browser, die bereits auf Ihrem System installiert sind:

• ✅ Google Chrome

• ✅ Microsoft Edge

• ✅ Chromium

• ✅ Google Chrome Canary

Wenn Sie keinen dieser Browser installiert haben, können Sie:

# Option 1: Install Google Chrome (Recommended)
# Download from: https://www.google.com/chrome/

# Option 2: Install Microsoft Edge
# Download from: https://www.microsoft.com/edge

# Option 3: Install Chromium via agent-browser
npx agent-browser install

# Option 4: Install Chromium directly
# Download from: https://www.chromium.org/getting-involved/download-chromium/

Installation

Verwendung der Claude Code CLI (Empfohlen)

# Add to Claude Code with default settings (local search)
claude mcp add one-search-mcp -- npx -y one-search-mcp

# Add with custom search provider (e.g., SearXNG)
claude mcp add one-search-mcp -e SEARCH_PROVIDER=searxng -e SEARCH_API_URL=http://127.0.0.1:8080 -- npx -y one-search-mcp

# Add with Tavily API
claude mcp add one-search-mcp -e SEARCH_PROVIDER=tavily -e SEARCH_API_KEY=your_api_key -- npx -y one-search-mcp

Manuelle Installation

# Install globally (Optional)
npm install -g one-search-mcp

# Or run directly with npx
npx -y one-search-mcp

Verwendung von Docker

Das Docker-Image enthält alle Abhängigkeiten (Chromium-Browser) vorinstalliert, keine zusätzliche Einrichtung erforderlich.

Image abrufen:

# From GitHub Container Registry
docker pull ghcr.io/yokingma/one-search-mcp:latest

# Or from Docker Hub
docker pull zacma/one-search-mcp:latest

Konfiguration mit Claude Desktop:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/yokingma/one-search-mcp:latest"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Mit benutzerdefiniertem Suchanbieter:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEARCH_PROVIDER=tavily",
        "-e", "SEARCH_API_KEY=your_api_key",
        "ghcr.io/yokingma/one-search-mcp:latest"
      ]
    }
  }
}

Umgebungsvariablen

Suchmaschine:

• SEARCH_PROVIDER (Optional): Der zu verwendende Suchanbieter, unterstützt searxng, duckduckgo, bing, tavily, google, zhipu, exa, bocha, local, Standard ist local.

• SEARCH_API_URL (Optional): Die URL der SearxNG-API oder die Google Custom Search Engine ID für google.

• SEARCH_API_KEY (Optional): Der API-Schlüssel für den Suchanbieter, erforderlich für tavily, bing, google, zhipu, exa, bocha.

// supported search providers
export type SearchProvider = 'searxng' | 'duckduckgo' | 'bing' | 'tavily' | 'google' | 'zhipu' | 'exa' | 'bocha' | 'local';

Konfiguration des Suchanbieters

Konfiguration für andere MCP-Clients

Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Cursor

Fügen Sie dies zu Ihrer mcp.json-Datei hinzu:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Windsurf

Fügen Sie dies zu Ihrer ./codeium/windsurf/model_config.json-Datei hinzu:

{
  "mcpServers": {
    "one-search-mcp": {
      "command": "npx",
      "args": ["-y", "one-search-mcp"],
      "env": {
        "SEARCH_PROVIDER": "local"
      }
    }
  }
}

Selbsthosting von SearXNG (Optional)

Wenn Sie SearXNG als Suchanbieter verwenden möchten, können Sie es lokal mit Docker bereitstellen:

Voraussetzungen:

• Docker installiert und ausgeführt (Version 20.10.0 oder höher)

• Mindestens 4 GB RAM verfügbar

Schnellstart:

# Clone SearXNG Docker repository
git clone https://github.com/searxng/searxng-docker.git
cd searxng-docker

# Start SearXNG
docker compose up -d

Nach der Bereitstellung ist SearXNG standardmäßig unter http://127.0.0.1:8080 verfügbar.

Konfigurieren Sie OneSearch für die Verwendung von SearXNG:

# Set environment variables
export SEARCH_PROVIDER=searxng
export SEARCH_API_URL=http://127.0.0.1:8080

Weitere Details finden Sie in der offiziellen SearXNG Docker-Dokumentation.

Fehlerbehebung

Fehler: Browser nicht gefunden

Wenn Sie eine Fehlermeldung wie "Browser not found" sehen, konnte der Server keinen installierten Chromium-basierten Browser erkennen. Bitte installieren Sie einen der folgenden:

• Google Chrome: https://www.google.com/chrome/

• Microsoft Edge: https://www.microsoft.com/edge

• Chromium: https://www.chromium.org/getting-involved/download-chromium/

Oder installieren Sie ihn über agent-browser:

npx agent-browser install

Lizenz

MIT-Lizenz - siehe LICENSE-Datei für Details.