Search1API

Search1API MCP-Server

中文文档 | Deutsch

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 anschließend 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 erhalten die OAuth-Challenge, über die Clients die Anmeldung auslösen; die Prüfung vor dem Verbinden wird stattdessen von der statischen Serverkarte bereitgestellt.

Schnellstart (Remote MCP)

Keine Installation erforderlich. Konfiguriere deinen MCP-Client mit der Remote-URL. Verwende OAuth, wenn der Client dies unterstützt, oder gib einen API-Schlüssel an.

Authentifizierung

Drei Methoden werden unterstützt — verwende diejenige, die dein Client unterstützt:

Methode	Format
OAuth 2.1	Verbinde dich ohne Schlüssel mit https://mcp.search1api.com/mcp und folge dem Anmeldeablauf des Clients
Authorization-Header	Authorization: Bearer YOUR_SEARCH1API_KEY
URL-Abfrageparameter (veraltet)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

OAuth oder den Authorization-Header bevorzugen. Zugangsdaten in Abfrageparametern können in URLs, Protokollen und der Shell-Verlaufshistorie offengelegt werden.

Optionale Such- und Nachrichten-UI

Remote MCP stellt render_results am oben genannten Standardendpunkt bereit. Datentools wie search, news und ask liefern Ergebnisse, ohne automatisch Karten anzuzeigen. Wenn eine Quellenliste hilfreich ist, kann das Modell vorhandene Ergebnisse auswählen oder kombinieren und an render_results übergeben. Dieses Tool gibt Quellkarten in MCP-Apps-Clients und andernorts eine vollständige, lesbare Textliste zurück. Das Rendern wiederholt keine Suche und verbraucht keine Such-Credits; ein UI-URL-Parameter ist nicht erforderlich.

Sowohl HTTP als auch stdio geben das quadratische Search1API-Logo über standardmäßige serverInfo.icons-Metadaten bekannt. Das 512×512-PNG wird öffentlich unter https://mcp.search1api.com/assets/icon-square.png bereitgestellt, ohne Authentifizierung oder Weiterleitungen. Die Serverkarte und das Registry-Manifest verwenden dasselbe Symbol. Clients entscheiden selbst, ob sie es anzeigen; es ersetzt kein separat in einem Plugin-Verzeichnis gespeichertes Symbol.

Unter Rendering-Vertrag findest du Argumente, Beschränkungen und das Fallback-Verhalten. Das npm-Paket enthält diesen Renderer ab Version 0.8.0. Aktualisiere bestehende Installationen und starte die MCP-Verbindung neu; npx -y search1api-mcp@latest startet das neueste veröffentlichte Paket.

Nachdem du die URL geändert hast, verbinde den Connector erneut oder aktualisiere seine Tool-Definitionen; Clients können sie zwischenspeichern. Diese URL-Einstellung gilt nur für Remote MCP; das lokale stdio-Verhalten bleibt unverändert. Weitere Informationen und den Veröffentlichungsstatus findest du unter MCP-Apps-UI.

Claude Desktop

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

Claude.ai (Web)

Installiere Search1API aus dem Claude-Verzeichnis, klicke auf Connect und melde dich mit deinem Search1API-Konto an.

Füge https://mcp.search1api.com/mcp nicht über Add custom connector hinzu: Dadurch wird ein separater benutzerdefinierter Connector erstellt, den Claude nach dem Host der URL (mcp.search1api.com) benennt, sofern du keinen Namen eingibst.

Cursor

Als Cursor-Plugin installieren (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. Reiche es über cursor.directory / den Cursor Marketplace ein oder installiere es von dort und melde dich anschließend bei Aufforderung an.

Zum lokalen Testen kopiere die Plugin-Dateien nach ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). Erstelle 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"
      }
    }
  }
}

Antigravity

Als Antigravity-Plugin installieren: antigravity-plugin/ enthält das Manifest, mcp_config.json (Remote MCP mit OAuth), den Search1API-Skill und eine Marketplace-README. Installiere es direkt von GitHub und melde dich an, sobald sich der Browser öffnet:

agy plugin install https://github.com/superagents-lab/search1api-mcp/tree/main/antigravity-plugin

Zum lokalen Testen führe agy plugin validate --strict ./antigravity-plugin und agy plugin install ./antigravity-plugin in einem Checkout aus.

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 Skill

Der Agent Skill ist zu search1api-cli umgezogen. Installiere ihn mit:

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

Lokaler Modus (stdio)

Wenn du den Server lieber lokal ausführen möchtest, verwende Node.js 20 oder neuer mit npx — ein Klonen ist nicht erforderlich:

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

Bei selbst gehosteten HTTP-Bereitstellungen hinter einem Proxy füge alle internen Hostnamen, über die der Node.js-Prozess erreichbar ist, zur durch Kommas getrennten Umgebungsvariable MCP_ALLOWED_HOSTS hinzu. mcp.search1api.com und localhost-Adressen sind standardmäßig zulässig. Browserbasierte Clients, die einen Origin-Header senden, müssen außerdem ihre vertrauenswürdigen Origin-Hostnamen zur durch Kommas getrennten Variable MCP_ALLOWED_ORIGINS hinzufügen. Anfragen von serverseitigen MCP-Clients lassen Origin normalerweise aus und benötigen keinen Eintrag.

Tools

search

Durchsuche das Web mit Search1API. Die Ergebnisse enthalten eine zitierfähige Struktur aus id/title/url. Übergib eine Ergebnis-URL an crawl, wenn du die vollständige Seite benötigst.

Parameter	Erforderlich	Standard	Beschreibung
query	Ja	-	Suchanfrage
max_results	Nein	10	Anzahl der Ergebnisse
search_service	Nein	google	google, bing, bingcn, duckduckgo, yahoo, yandex, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia, grokipedia
page	Nein	1	Ergebnisseite (1–100); nur bing, bingcn, baidu und grokipedia unterstützen die Seitennavigation
crawl_results	Nein	0	Anzahl der Top-Ergebnisse, deren vollständiger Inhalt abgerufen werden soll; jeder erfolgreiche Abruf kostet zusätzlich zum Suchaufruf mit 1 Credit 1 Credit
include_sites	Nein	[]	Einzuschließende Websites
exclude_sites	Nein	[]	Auszuschließende Websites
time_range	Nein	-	day, week, month, year

Ergebnisse enthalten published_date in metadata, sofern die Suchmaschine einen solchen bereitstellt; github-Ergebnisse ergänzen kind, stars, language und num_comments.

news

Suche nach Nachrichtenartikeln. hackernews-Ergebnisse verlinken auf den Diskussionsthread und ergänzen story_url, points und num_comments in metadata.

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, deren vollständiger Inhalt abgerufen werden soll; jeder erfolgreiche Abruf kostet zusätzlich zum Nachrichtenaufruf mit 1 Credit 1 Credit
include_sites	Nein	[]	Einzuschließende Websites
exclude_sites	Nein	[]	Auszuschließende Websites
time_range	Nein	-	day, week, month, year

crawl

Extrahiere Inhalte aus einer URL.

Parameter	Erforderlich	Beschreibung
url	Ja	Abzurufende URL

sitemap

Rufe alle zugehörigen Links einer URL ab.

Parameter	Erforderlich	Beschreibung
url	Ja	URL, deren Sitemap abgerufen werden soll

trending

Rufe Trendthemen von beliebten Plattformen ab.

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

ask

Agentische Suche: Beschreibe den Bedarf in natürlicher Sprache. Search1API wählt bis zu fünf Suchmaschinen und einen Zeitraum aus, entfernt themenfremde Ergebnisse und gibt höchstens 10 zitierfähige, nach Relevanz sortierte Ergebnisse zurück. Das Ergebnis enthält außerdem intent (verwendete Schlüsselwörter, Suchmaschinen und Zeitraum) und errors (Suchmaschinen, bei denen Fehler auftraten, während andere erfolgreich abgeschlossen wurden). Kostet 5 Credits pro abgeschlossener Anfrage; verwende search, wenn du die Suchmaschine bereits kennst.

Parameter	Erforderlich	Beschreibung
query	Ja	Die Anfrage in natürlicher Sprache, bis zu 500 Zeichen

maps

Finde lokale Unternehmen und Orte auf Google Maps. Gibt eine Seite mit bis zu 20 Orten als zitierfähige Ergebnisse zurück: title ist der Name des Ortes, url der Google-Maps-Link und metadata enthält, sofern verfügbar, Adresse, Telefonnummer, Website, Kategorie, Bewertung, Anzahl der Rezensionen, Koordinaten, Öffnungszeiten, Öffnungsstatus und Preisspanne. Kostet 3 Credits pro Seite, unabhängig von der Anzahl der enthaltenen Orte.

Parameter	Erforderlich	Standard	Beschreibung
query	Ja	-	Wonach gesucht werden soll, z. B. „Cafés“ oder „Zahnärzte in Austin“
country	Nein	us	Zweistelliger Ländercode
language	Nein	en	Ergebnissprache, z. B. en, de oder zh-CN
location	Nein	-	{ latitude, longitude, zoom? }, um in der Nähe eines Punkts zu suchen; für Seite 2 und spätere Seiten erforderlich
page	Nein	1	Google-Maps-Seite, 1–6; jede Seite ist ein separater Aufruf
max_results	Nein	20	Anzahl der Orte, die von der Seite zurückgegeben werden sollen (1–20); weniger Orte senken den Preis nicht

deepcrawl

Lies viele Seiten einer Website in einem einzigen Auftrag, etwa einen Dokumentationsbereich. Ermittelt die URLs der Website über ihre Sitemap, behält diejenigen bei, die den Pfadregeln entsprechen, und gibt bis zu max_pages Seiten als zitierfähige Ergebnisse zurück: title, url und den Markdown-Inhalt der Seite in text. Das Ergebnis enthält außerdem stats (entdeckt, passend, übersprungen, abgerufen, fehlgeschlagen), failed (URLs, die nicht gelesen werden konnten, samt Grund), die API message und result_url, eine JSON-Datei mit allen Seiten in voller Länge. Kostet 20 Credits pro gestartetem Auftrag, unabhängig von der Anzahl der gelesenen Seiten.

Das Tool wartet bis zu etwa 45 Sekunden. Wenn der Crawl dann noch läuft, gibt es status: "running" mit einem task_id zurück. Rufe deepcrawl mit diesem task_id erneut auf, um die Seiten abzurufen; dies ist kostenlos und startet keinen neuen Crawl. Der Seitentext ist auf 8.000 Zeichen pro Seite und insgesamt 80.000 Zeichen begrenzt; gekürzte Seiten haben metadata.truncated: true, und result_url enthält den vollständigen Text.

Parameter	Erforderlich	Standard	Beschreibung
url	Ja, sofern task_id nicht angegeben ist	-	Zu crawlende Website oder Website-Sektion, z. B. https://example.com/docs/
max_pages	Nein	10	Höchstzahl der zu lesenden Seiten (1–50), in der Entdeckungsreihenfolge nach Anwendung der Pfadregeln; der Preis ist unabhängig von der Anzahl gleich
include_paths	Nein	-	Bis zu 20 URL-Pfadregeln, die beibehalten werden sollen. Ohne * ist eine Regel ein Pfadpräfix an Segmentgrenzen (/docs entspricht /docs/api, aber nicht /docsearch); mit * muss sie dem gesamten Pfad entsprechen, und * entspricht auch /
exclude_paths	Nein	-	Bis zu 20 auszuschließende Pfadregeln, gleiche Syntax; Ausschlüsse haben Vorrang
type	Nein	sitemap	sitemap verwendet die Sitemap der Website oder, falls keine vorhanden ist, die Links auf der Startseite; all verwendet alle Links, die von der Start-URL aus entdeckt werden
task_id	Nein	-	task_id eines noch laufenden Crawls; prüft nur dessen Status, die übrigen Parameter werden ignoriert

send_feedback

Melde dem Search1API-Team falsche, leere oder unvollständige Ergebnisse, einen Fehler, den du nicht beheben konntest, Dokumentation, die nicht dem tatsächlichen Verhalten entspricht, oder eine fehlende Funktion. Kostenlos; es werden keine Credits verbraucht. Wenn der Server über eine Search1API-Anmeldeinformation verfügt, wird der Bericht mit diesem Konto verknüpft, damit das Team nachfassen kann. Gib keine Zugangsdaten oder privaten Daten an.

Parameter	Erforderlich	Beschreibung
message	Ja	Was schiefgelaufen ist oder gefehlt hat, bis zu 4000 Zeichen
intent	Nein	Was Sie erreichen wollten
category	Nein	bug, feature_request, docs, other
request_id	Nein	Request-ID des Aufrufs, bei dem das Problem aufgetreten ist
model	Nein	Name Ihres Modells

Versionsverlauf

• v0.11.0: Neues Tool deepcrawl zum Lesen von bis zu 50 Seiten einer Website in einer einzigen Aufgabe (20 Credits pro Aufgabe; das Prüfen einer laufenden Aufgabe ist kostenlos)

• v0.10.0: Neues Tool maps für die Suche nach Orten in Google Maps (3 Credits pro Seite mit bis zu 20 Orten)

• v0.7.0: Neues Tool ask für agentische Suche. search ergänzt die Engines bingcn, yandex und grokipedia sowie einen Parameter page; search und news akzeptieren time_range: "week" und geben die Felder von published_date, GitHub und Hacker News im Ergebnis metadata weiter

• v0.6.1: Fehlerbehebung — Die MCP-Erkennung (initialize, tools/list, resources/*, prompts/list, server/discover) erfordert wieder eine Anmeldeinformation. Die anonyme Bereitstellung führte dazu, dass Clients, die „aufgelistete Tools“ mit „angemeldet“ gleichsetzen, einen verbundenen Status anzeigten, ohne eine Möglichkeit zum Auslösen des OAuth-Ablaufs; die 401-Challenge beantwortet nun jede nicht authentifizierte Anfrage und stellt die OAuth-Anmeldung beim Verbindungsaufbau wieder her. Die Sichtbarkeit im Verzeichnis bleibt über die statische Serverkarte und Registry-Metadaten unverändert

• v0.6.0: Die 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 Ablehnung erfolgt erst beim Aufruf. Fehlerhafte Anfragen werden als JSON-RPC statt als HTML-Fehlerseite beantwortet

• v0.5.4: OAuth-Issuer auf clerk.s1.dev verschoben und über OAUTH_AUTHORIZATION_SERVER konfigurierbar; MCP-Serverkarte unter /.well-known/mcp/server-card.json veröffentlicht; OAuth-Erkennungsdokumente senden nun Cache-Header

• v0.5.3: OAuth-Ressourcen- und Tool-Metadaten erfordern keine OIDC-Sitzungsbereiche mehr; Badges für die Registries Smithery und Glama hinzugefügt

• v0.5.2: Die MCP-Validierung von Origin erfolgt nun vor dem Parsen und der Authentifizierung von Anfragen; selbst gehostete HTTP-Bereitstellungen können vertrauenswürdige Browser-Ursprünge mit MCP_ALLOWED_ORIGINS konfigurieren

• v0.5.1: Dokumentation, LobeHub-Manifest und MCP-Registry-Metadaten synchronisiert; robots.txt wird auf dem Transport-Host bereitgestellt

• v0.5.0: Unterstützung für MCP 2026-07-28 mit automatischer Protokollverhandlung; zustandslose Kompatibilität für HTTP-Clients aus der Ära 2025; Authentifizierung auf Anfrageebene

• v0.4.0: Strukturierte Ausgabeschemas, OAuth-Sicherheitsschemata, Sicherheitsannotationen und Metadaten für die offizielle MCP Registry

• v0.3.1: OAuth-2.1-Unterstützung für Remote MCP; veraltetes Reasoning-Tool entfernt

• v0.3.0: Remote-MCP-Unterstützung über Streamable HTTP; API-Schlüssel-Authentifizierung pro Sitzung

• v0.2.0: Fallback-Unterstützung für .env zur LibreChat-Integration

• v0.1.8: Suchdienste für X (Twitter) und Reddit

• v0.1.7: Trend-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

UI- und Drittanbieter-Credits

Die MCP-Apps-Ansicht von render_results zeigt vorhandene Quellen als Karten mit Titeln und Domains. Jeder Client erhält außerdem den vollständigen Text und die strukturierte Ergebnisliste. Die Komponente basiert auf Rare UI von Swami Malode. Die MIT- + Commons-Clause- + Attribution-Bedingungen sind in THIRD_PARTY_NOTICES.md wiedergegeben.

UI-Einrichtung, Sandbox-Ursprung und Release-Prüfungen: MCP Apps UI.