Search1API

Serveur MCP Search1API

Documentation en chinois

Le serveur MCP officiel pour Search1API — recherche web, actualités, récupération de pages, découverte de sitemaps et tendances en une seule API.

Authentification

• Les clients compatibles OAuth peuvent se connecter directement à l'URL MCP distante, puis se connecter et approuver l'accès dans le navigateur.
• Les intégrations existantes peuvent continuer à utiliser une clé API depuis le tableau de bord Search1API.
• Chaque requête MCP — y compris la découverte d'outils (initialize, tools/list) — nécessite une identité. Les requêtes non authentifiées déclenchent le défi OAuth, ce qui permet aux clients de déclencher la connexion ; l'inspection avant connexion est servie par la carte serveur statique à la place.

Démarrage rapide (MCP distant)

Aucune installation requise. Configurez votre client MCP avec l'URL distante. Utilisez OAuth lorsque le client le prend en charge, ou fournissez une clé API.

Authentification

Trois méthodes sont prises en charge — utilisez celle que votre client prend en charge :

Méthode	Format
OAuth 2.1	Connectez-vous à https://mcp.search1api.com/mcp sans clé et suivez le flux de connexion du client
En-tête d'autorisation	Authorization: Bearer YOUR_SEARCH1API_KEY
Paramètre de requête URL (hérité)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Privilégiez OAuth ou l'en-tête d'autorisation. Les identifiants en paramètre de requête peuvent être exposés dans les URL, les journaux et l'historique du shell.

Claude Desktop

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

Claude.ai (Web)

Paramètres > Connecteurs > Ajouter un connecteur personnalisé :

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

Cursor

Installez comme plugin Cursor (recommandé) : ce dépôt inclut les plugins d'agent plugin.json + mcp.json (portables) et .cursor-plugin/plugin.json (métadonnées / logo du Marketplace Cursor) pour MCP distant avec OAuth. Soumettez ou installez depuis cursor.directory / le Marketplace Cursor, puis connectez-vous lorsque vous y êtes invité.

Pour les tests locaux, copiez les fichiers du plugin dans ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). Ne créez pas de lien symbolique depuis l'extérieur de ce répertoire — Cursor rejette les cibles de liens symboliques externes.

Ou configurez manuellement :

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

Compétence d'agent

La compétence d'agent a été déplacée vers search1api-cli. Installez-la avec :

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

Mode local (stdio)

Si vous préférez exécuter le serveur localement, utilisez Node.js 20 ou plus récent avec npx — aucun clonage requis :

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

Pour les déploiements HTTP auto-hébergés derrière un proxy, ajoutez tous les noms d'hôtes internes qui atteignent le processus Node.js à la variable d'environnement MCP_ALLOWED_HOSTS séparée par des virgules. mcp.search1api.com et les adresses localhost sont autorisées par défaut. Les clients basés sur navigateur qui envoient un en-tête Origin doivent également avoir leurs noms d'hôtes d'origine de confiance ajoutés à la variable MCP_ALLOWED_ORIGINS séparée par des virgules. Les requêtes des clients MCP côté serveur omettent normalement Origin et ne nécessitent pas d'entrée.

Outils

search

Recherchez sur le web en utilisant Search1API. Les résultats incluent une structure id/title/url citable. Passez une URL de résultat à crawl lorsque vous avez besoin de la page complète.

Paramètre	Requis	Défaut	Description
query	Oui	-	Requête de recherche
max_results	Non	10	Nombre de résultats
search_service	Non	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	Non	0	Nombre de résultats principaux à explorer pour le contenu complet ; chaque exploration réussie ajoute 1 crédit à la requête de recherche de base de 1 crédit
include_sites	Non	[]	Sites à inclure
exclude_sites	Non	[]	Sites à exclure
time_range	Non	-	jour, mois, année

news

Recherchez des articles d'actualité.

Paramètre	Requis	Défaut	Description
query	Oui	-	Requête de recherche
max_results	Non	10	Nombre de résultats
search_service	Non	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	Non	0	Nombre de résultats principaux à explorer pour le contenu complet ; chaque exploration réussie ajoute 1 crédit à la requête d'actualités de base de 1 crédit
include_sites	Non	[]	Sites à inclure
exclude_sites	Non	[]	Sites à exclure
time_range	Non	-	jour, mois, année

crawl

Extrayez le contenu d'une URL.

Paramètre	Requis	Description
url	Oui	URL à explorer

sitemap

Obtenez tous les liens associés à partir d'une URL.

Paramètre	Requis	Description
url	Oui	URL pour obtenir le sitemap

trending

Obtenez les sujets tendance des plateformes populaires.

Paramètre	Requis	Défaut	Description
search_service	Oui	-	github, hackernews
max_results	Non	10	Nombre d'éléments

Historique des versions

• v0.6.1 : Correction de bug — la découverte MCP (initialize, tools/list, resources/*, prompts/list, server/discover) nécessite à nouveau une identité. La servir anonymement faisait que les clients qui assimilent « outils listés » à « connecté » affichaient un état connecté sans moyen de déclencher le flux OAuth ; le défi 401 répond désormais à chaque requête non authentifiée, restaurant la connexion OAuth au moment de la connexion. La visibilité du répertoire est inchangée via la carte serveur statique et les métadonnées du registre
• v0.6.0 : La découverte MCP (initialize, tools/list, resources/*, prompts/list, server/discover) est servie sans identité afin que les clients et les répertoires puissent énumérer les outils avant de se connecter ; les appels d'outils nécessitent toujours OAuth ou une clé API. Le mode stdio démarre sans SEARCH1API_KEY et sert les métadonnées des outils, refusant uniquement au moment de l'appel. Les requêtes malformées répondent en JSON-RPC au lieu d'une page d'erreur HTML
• v0.5.4 : L'émetteur OAuth a été déplacé vers clerk.s1.dev et est configurable avec OAUTH_AUTHORIZATION_SERVER ; la carte serveur MCP est publiée à /.well-known/mcp/server-card.json ; les documents de découverte OAuth envoient désormais des en-têtes de cache
• v0.5.3 : Les métadonnées des ressources et des outils OAuth ne nécessitent plus de portées de session OIDC ; les badges de registre Smithery et Glama ont été ajoutés
• v0.5.2 : La validation MCP Origin s'exécute désormais avant l'analyse des requêtes et l'authentification ; les déploiements HTTP auto-hébergés peuvent configurer les origines de navigateur de confiance avec MCP_ALLOWED_ORIGINS
• v0.5.1 : Documentation, manifeste LobeHub et métadonnées du registre MCP synchronisés ; robots.txt servi sur l'hôte de transport
• v0.5.0 : Prise en charge MCP 2026-07-28 avec négociation automatique de protocole ; compatibilité sans état pour les clients HTTP de l'ère 2025 ; authentification au niveau de la requête
• v0.4.0 : Schémas de sortie structurés, schémas de sécurité OAuth, annotations de sécurité et métadonnées du registre MCP officiel
• v0.3.1 : Prise en charge OAuth 2.1 pour MCP distant ; outil de raisonnement retiré
• v0.3.0 : Prise en charge MCP distant via HTTP Streamable ; authentification par clé API par session
• v0.2.0 : Prise en charge de repli .env pour l'intégration LibreChat
• v0.1.8 : Services de recherche X (Twitter) et Reddit
• v0.1.7 : Outil de tendances pour GitHub et Hacker News
• v0.1.6 : Service de recherche Wikipedia
• v0.1.5 : Nouveaux paramètres et services de recherche (arxiv, wechat, bilibili, imdb)
• v0.1.3 : Recherche d'actualités
• v0.1.2 : Sitemap
• v0.1.1 : Exploration web
• v0.1.0 : Version initiale

Licence

MIT