Search1API

Search1API MCP Server

中文文档

Der offizielle MCP-Server für Search1API – Websuche, Nachrichten, Seitenabruf, Sitemap-Erkennung und Trendthemen in einer API.

Authentifizierung

• OAuth-fähige Clients können sich direkt mit der Remote-MCP-URL verbinden und sich dann im Browser anmelden und den Zugriff genehmigen.
• Bestehende Integrationen können weiterhin einen API-Schlüssel aus dem Search1API-Dashboard verwenden.
• Jede MCP-Anfrage – einschließlich der Tool-Erkennung (initialize, tools/list) – erfordert eine Anmeldeinformation. Nicht authentifizierte Anfragen lösen die OAuth-Herausforderung aus, wodurch Clients die Anmeldung auslösen; die Inspektion vor der Verbindung wird stattdessen über die statische Serverkarte bereitgestellt.

Schnellstart (Remote MCP)

Keine Installation erforderlich. Konfigurieren Sie Ihren MCP-Client mit der Remote-URL. Verwenden Sie OAuth, wenn der Client dies unterstützt, oder geben Sie einen API-Schlüssel an.

Authentifizierung

Drei Methoden werden unterstützt – verwenden Sie die, die Ihr Client unterstützt:

Methode	Format
OAuth 2.1	Verbinden Sie sich mit https://mcp.search1api.com/mcp ohne Schlüssel und folgen Sie dem Client-Anmeldeablauf
Autorisierungs-Header	Authorization: Bearer YOUR_SEARCH1API_KEY
URL-Abfrageparameter (Legacy)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Bevorzugen Sie OAuth oder den Autorisierungs-Header. Anmeldeinformationen über Abfrageparameter können in URLs, Protokollen und Shell-Verläufen offengelegt werden.

Claude Desktop

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude.ai (Web)

Einstellungen > Connectors > Benutzerdefinierten Connector hinzufügen:

https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Cursor

Installieren Sie es als Cursor-Plugin (empfohlen): Dieses Repository enthält Agent-Plugins plugin.json + mcp.json (portabel) und .cursor-plugin/plugin.json (Cursor-Marketplace-Metadaten / Logo) für Remote MCP mit OAuth. Einreichen oder installieren von cursor.directory / dem Cursor-Marketplace, dann bei Aufforderung anmelden.

Für lokale Tests kopieren Sie die Plugin-Dateien in ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). Verwenden Sie keine Symlinks von außerhalb dieses Verzeichnisses – Cursor lehnt externe Symlink-Ziele ab.

Oder manuell konfigurieren:

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "search1api": {
      "type": "http",
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http search1api https://mcp.search1api.com/mcp \
  --header "Authorization: Bearer YOUR_SEARCH1API_KEY"

Windsurf

{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY"
    }
  }
}

Agent-Fähigkeit

Die Agent-Fähigkeit wurde zu search1api-cli verschoben. Installieren Sie sie mit:

npm install -g search1api-cli
npx skills add superagents-lab/search1api-cli

Lokaler Modus (stdio)

Wenn Sie den Server lieber lokal ausführen möchten, verwenden Sie Node.js 20 oder neuer mit npx – kein Klonen erforderlich:

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Für selbst gehostete HTTP-Bereitstellungen hinter einem Proxy fügen Sie alle internen Hostnamen, die den Node.js-Prozess erreichen, zur durch Kommas getrennten Umgebungsvariable MCP_ALLOWED_HOSTS hinzu. mcp.search1api.com und localhost-Adressen sind standardmäßig erlaubt. Browserbasierte Clients, die einen Origin-Header senden, müssen ebenfalls ihre vertrauenswürdigen Ursprungs-Hostnamen zur durch Kommas getrennten MCP_ALLOWED_ORIGINS-Variable hinzufügen. Anfragen von serverseitigen MCP-Clients lassen Origin normalerweise weg und benötigen keinen Eintrag.

Tools

search

Durchsuchen Sie das Web mit Search1API. Die Ergebnisse enthalten eine zitierfähige id/title/url-Struktur. Übergeben Sie eine Ergebnis-URL an crawl, wenn Sie die vollständige Seite benötigen.

Parameter	Erforderlich	Standard	Beschreibung
query	Ja	-	Suchanfrage
max_results	Nein	10	Anzahl der Ergebnisse
search_service	Nein	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	Nein	0	Anzahl der Top-Ergebnisse, die für vollständigen Inhalt gecrawlt werden; jeder erfolgreiche Crawl fügt dem Basis-1-Credit-Suchanfrage 1 Credit hinzu
include_sites	Nein	[]	Einzuschließende Websites
exclude_sites	Nein	[]	Auszuschließende Websites
time_range	Nein	-	day, month, year

news

Suchen Sie nach Nachrichtenartikeln.

Parameter	Erforderlich	Standard	Beschreibung
query	Ja	-	Suchanfrage
max_results	Nein	10	Anzahl der Ergebnisse
search_service	Nein	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	Nein	0	Anzahl der Top-Ergebnisse, die für vollständigen Inhalt gecrawlt werden; jeder erfolgreiche Crawl fügt dem Basis-1-Credit-Nachrichtenanfrage 1 Credit hinzu
include_sites	Nein	[]	Einzuschließende Websites
exclude_sites	Nein	[]	Auszuschließende Websites
time_range	Nein	-	day, month, year

crawl

Extrahieren Sie Inhalte aus einer URL.

Parameter	Erforderlich	Beschreibung
url	Ja	Zu crawelnde URL

sitemap

Rufen Sie alle verwandten Links von einer URL ab.

Parameter	Erforderlich	Beschreibung
url	Ja	URL, von der die Sitemap abgerufen werden soll

trending

Rufen Sie Trendthemen von beliebten Plattformen ab.

Parameter	Erforderlich	Standard	Beschreibung
search_service	Ja	-	github, hackernews
max_results	Nein	10	Anzahl der Elemente

Versionsverlauf

• v0.6.1: Fehlerbehebung – MCP-Erkennung (initialize, tools/list, resources/*, prompts/list, server/discover) erfordert wieder eine Anmeldeinformation. Die anonyme Bereitstellung führte dazu, dass Clients, die „Tools aufgelistet" mit „angemeldet" gleichsetzen, einen verbundenen Zustand ohne Möglichkeit zur Auslösung des OAuth-Ablaufs zeigten; die 401-Herausforderung beantwortet nun jede nicht authentifizierte Anfrage und stellt die OAuth-Anmeldung beim Verbindungsaufbau wieder her. Die Verzeichnissichtbarkeit bleibt über die statische Serverkarte und Registrierungsmetadaten unverändert
• v0.6.0: MCP-Erkennung (initialize, tools/list, resources/*, prompts/list, server/discover) wird ohne Anmeldeinformation bereitgestellt, damit Clients und Verzeichnisse Tools vor der Anmeldung auflisten können; Tool-Aufrufe erfordern weiterhin OAuth oder einen API-Schlüssel. Der Stdio-Modus startet ohne SEARCH1API_KEY und stellt Tool-Metadaten bereit, die erst beim Aufruf abgelehnt werden. Fehlerhafte Anfragen werden als JSON-RPC statt als HTML-Fehlerseite beantwortet
• v0.5.4: OAuth-Aussteller nach clerk.s1.dev verschoben und mit OAUTH_AUTHORIZATION_SERVER konfigurierbar; MCP-Serverkarte unter /.well-known/mcp/server-card.json veröffentlicht; OAuth-Erkennungsdokumente senden jetzt Cache-Header
• v0.5.3: OAuth-Ressourcen- und Tool-Metadaten erfordern keine OIDC-Sitzungsbereiche mehr; Smithery- und Glama-Registrierungsabzeichen hinzugefügt
• v0.5.2: MCP-Origin-Validierung läuft jetzt vor Anfrageparsing und Authentifizierung; selbst gehostete HTTP-Bereitstellungen können vertrauenswürdige Browser-Ursprünge mit MCP_ALLOWED_ORIGINS konfigurieren
• v0.5.1: Dokumentation, LobeHub-Manifest und MCP-Registrierungsmetadaten synchronisiert; robots.txt auf dem Transport-Host bereitgestellt
• v0.5.0: MCP 2026-07-28-Unterstützung mit automatischer Protokollaushandlung; zustandslose Kompatibilität für HTTP-Clients aus der 2025-Ära; Authentifizierung auf Anfrageebene
• v0.4.0: Strukturierte Ausgabeschemata, OAuth-Sicherheitsschemata, Sicherheitsannotationen und offizielle MCP-Registrierungsmetadaten
• v0.3.1: OAuth 2.1-Unterstützung für Remote MCP; ausgemustertes Reasoning-Tool entfernt
• v0.3.0: Remote-MCP-Unterstützung über Streamable HTTP; API-Schlüsselauthentifizierung pro Sitzung
• v0.2.0: Fallback-.env-Unterstützung für LibreChat-Integration
• v0.1.8: X (Twitter)- und Reddit-Suchdienste
• v0.1.7: Trending-Tool für GitHub und Hacker News
• v0.1.6: Wikipedia-Suchdienst
• v0.1.5: Neue Suchparameter und Dienste (arxiv, wechat, bilibili, imdb)
• v0.1.3: Nachrichtensuche
• v0.1.2: Sitemap
• v0.1.1: Web-Crawling
• v0.1.0: Erstveröffentlichung

Lizenz

MIT