Search1API

Serveur MCP Search1API

中文文档

Le serveur MCP officiel pour Search1API — recherche web, actualités, récupération de pages, découverte de sitemaps et sujets tendance 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.

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 dans les paramètres 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 Agent Plugins plugin.json + mcp.json (portable) et .cursor-plugin/plugin.json (métadonnées / logo du Cursor Marketplace) pour MCP distant avec OAuth. Soumettez ou installez depuis cursor.directory / le Cursor Marketplace, 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"
    }
  }
}

Agent Skill

L'Agent Skill a été déplacé vers search1api-cli. Installez-le 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ôte internes qui atteignent le processus Node.js à la variable d'environnement MCP_ALLOWED_HOSTS séparée par des virgules. Les adresses mcp.search1api.com et 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ôte 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 avec 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 meilleurs résultats à 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 meilleurs résultats à 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.5.3 : Les métadonnées de ressources et d'outils OAuth ne nécessitent plus de scopes de session OIDC ; ajout des badges de registre Smithery et Glama
• 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 des 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 de MCP 2026-07-28 avec négociation automatique du 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 d'OAuth 2.1 pour MCP distant ; outil de raisonnement retiré supprimé
• v0.3.0 : Prise en charge de MCP distant via Streamable HTTP ; 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