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.

Schnellstart (Remote MCP)

Keine Installation erforderlich. Konfigurieren Sie Ihren MCP-Client mit der Remote-URL. Verwenden Sie OAuth, wenn der Client es 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 ohne Schlüssel mit https://mcp.search1api.com/mcp und folgen Sie dem Client-Anmeldevorgang
Authorization Header	Authorization: Bearer YOUR_SEARCH1API_KEY
URL Query Parameter (legacy)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Bevorzugen Sie OAuth oder den Authorization-Header. Anmeldedaten im Abfrageparameter können in URLs, Protokollen und Shell-Verlauf sichtbar sein.

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. Reichen Sie es ein oder installieren Sie es von cursor.directory / dem Cursor Marketplace und melden Sie sich dann an, wenn Sie dazu aufgefordert werden.

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 konfigurieren Sie manuell:

{
  "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ügen Sie für selbst gehostete HTTP-Bereitstellungen hinter einem Proxy alle internen Hostnamen, die den Node.js-Prozess erreichen, zur durch Kommas getrennten Umgebungsvariablen MCP_ALLOWED_HOSTS hinzu. mcp.search1api.com- und localhost-Adressen sind standardmäßig erlaubt. Browserbasierte Clients, die einen Origin-Header senden, müssen auch ihre vertrauenswürdigen Ursprungshostnamen zur durch Kommas getrennten Variablen MCP_ALLOWED_ORIGINS hinzufügen. Anforderungen von serverseitigen MCP-Clients lassen Origin normalerweise aus und benötigen keinen Eintrag.

Werkzeuge

search

Durchsuchen Sie das Web mit Search1API. Die Ergebnisse enthalten eine zitierbare 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 sollen; jeder erfolgreiche Crawl fügt der Basis-Suchanfrage mit 1 Credit 1 Credit hinzu
include_sites	Nein	[]	Einzubeziehende Websites
exclude_sites	Nein	[]	Auszuschließende Websites
time_range	Nein	-	Tag, Monat, Jahr

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 sollen; jeder erfolgreiche Crawl fügt der Basis-Nachrichtenanfrage mit 1 Credit 1 Credit hinzu
include_sites	Nein	[]	Einzubeziehende Websites
exclude_sites	Nein	[]	Auszuschließende Websites
time_range	Nein	-	Tag, Monat, Jahr

crawl

Inhalt aus einer URL extrahieren.

Parameter	Erforderlich	Beschreibung
url	Ja	Zu crawlende URL

sitemap

Alle zugehörigen Links von einer URL abrufen.

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

trending

Trendthemen von beliebten Plattformen abrufen.

Parameter	Erforderlich	Standard	Beschreibung
search_service	Ja	-	github, hackernews
max_results	Nein	10	Anzahl der Einträge

Versionsverlauf

• 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 Anfrageanalyse 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 Ära 2025; Authentifizierung auf Anfrageebene
• v0.4.0: Strukturierte Ausgabeschemata, OAuth-Sicherheitsschemata, Sicherheitsanmerkungen 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