Search1API

Serveur MCP Search1API

中文文档 | Deutsch

Le serveur MCP officiel de Search1API — recherche sur le Web, actualités, récupération de pages, découverte de sitemaps et sujets tendance dans une seule API.

Authentification

• Les clients compatibles avec OAuth peuvent se connecter directement à l’URL Remote MCP, puis se connecter et autoriser 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 des outils (initialize, tools/list) — nécessite un identifiant. Les requêtes non authentifiées reçoivent le défi OAuth, qui permet aux clients de déclencher la connexion ; l’inspection avant connexion est assurée par la fiche serveur statique.

Démarrage rapide (Remote MCP)

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

Authentification

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

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

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

Interface utilisateur facultative pour la recherche et les actualités

Remote MCP expose render_results au point de terminaison standard ci-dessus. Les outils de données tels que search, news et ask renvoient des résultats sans afficher automatiquement de cartes. Lorsqu’une liste de sources est utile, le modèle peut sélectionner ou combiner des résultats existants et les transmettre à render_results. Cet outil renvoie des cartes de sources dans les clients MCP Apps et une liste textuelle complète et lisible ailleurs. Le rendu ne relance pas de recherche et ne consomme pas de crédits de recherche ; aucun paramètre d’URL d’interface n’est requis.

HTTP et stdio annoncent tous deux le logo carré Search1API via les métadonnées standard serverInfo.icons. Le PNG de 512×512 est accessible publiquement à l’adresse https://mcp.search1api.com/assets/icon-square.png, sans authentification ni redirection. La fiche serveur et le manifeste du registre utilisent la même icône. Les clients choisissent de l’afficher ou non ; elle ne remplace pas une icône stockée séparément par un répertoire de plugins.

Consultez le contrat de rendu pour connaître les arguments, les limites et le comportement de repli. Le package npm inclut ce moteur de rendu à partir de la version 0.8.0. Mettez à jour les installations existantes et redémarrez la connexion MCP ; npx -y search1api-mcp@latest lance la dernière version publiée du package.

Après avoir modifié l’URL, reconnectez-vous ou actualisez les définitions d’outils du connecteur ; les clients peuvent les mettre en cache. Ce paramètre d’URL s’applique uniquement à Remote MCP ; le comportement local de stdio reste inchangé. Consultez Interface utilisateur MCP Apps pour plus de détails et connaître l’état de la version.

Claude Desktop

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

Claude.ai (Web)

Installez Search1API depuis le répertoire Claude, cliquez sur Connect, puis connectez-vous avec votre compte Search1API.

Évitez d’ajouter https://mcp.search1api.com/mcp via Add custom connector : cela crée un connecteur personnalisé distinct, que Claude nomme d’après l’hôte de l’URL (mcp.search1api.com), sauf si vous saisissez un nom.

Cursor

Installez-le comme plugin Cursor (recommandé) : ce dépôt inclut Agent Plugins plugin.json + mcp.json (portable) et .cursor-plugin/plugin.json (métadonnées / logo du Cursor Marketplace) pour Remote MCP avec OAuth. Soumettez-le ou installez-le 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-le manuellement :

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

Antigravity

Installez-le comme plugin Antigravity : antigravity-plugin/ contient le manifeste, mcp_config.json (Remote MCP avec OAuth), la compétence Search1API et un README Marketplace. Installez-le directement depuis GitHub, puis connectez-vous lorsque le navigateur s’ouvre :

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

Pour les tests locaux, exécutez agy plugin validate --strict ./antigravity-plugin et agy plugin install ./antigravity-plugin depuis une copie locale du dépôt.

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 Agent

La compétence 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 une version ultérieure 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 à la variable d’environnement MCP_ALLOWED_HOSTS, séparée par des virgules, tous les noms d’hôte internes qui accèdent au processus Node.js. mcp.search1api.com et les adresses localhost sont autorisés par défaut. Les clients utilisant un navigateur qui envoient un en-tête Origin doivent également ajouter leurs noms d’hôte d’origine de confiance à 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 aucune entrée.

Outils

search

Effectue une recherche sur le Web avec Search1API. Les résultats incluent une structure id/title/url pouvant être citée. Transmettez l’URL d’un résultat à crawl lorsque vous avez besoin de la page complète.

Paramètre	Obligatoire	Valeur par défaut	Description
query	Oui	-	Requête de recherche
max_results	Non	10	Nombre de résultats
search_service	Non	google	google, bing, bingcn, duckduckgo, yahoo, yandex, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia, grokipedia
page	Non	1	Page de résultats (1-100) ; seule la pagination de bing, bingcn, baidu et grokipedia est prise en charge
crawl_results	Non	0	Nombre de premiers résultats à explorer pour obtenir leur contenu complet ; chaque exploration réussie ajoute 1 crédit à la requête de recherche de base, qui coûte 1 crédit
include_sites	Non	[]	Sites à inclure
exclude_sites	Non	[]	Sites à exclure
time_range	Non	-	day, week, month, year

Les résultats contiennent published_date dans metadata lorsque le moteur en fournit un ; les résultats github ajoutent kind, stars, language et num_comments.

news

Recherche des articles d’actualité. Les résultats hackernews renvoient vers le fil de discussion et ajoutent story_url, points et num_comments à metadata.

Paramètre	Obligatoire	Valeur par 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 premiers résultats à explorer pour obtenir leur contenu complet ; chaque exploration réussie ajoute 1 crédit à la requête d’actualités de base, qui coûte 1 crédit
include_sites	Non	[]	Sites à inclure
exclude_sites	Non	[]	Sites à exclure
time_range	Non	-	day, week, month, year

crawl

Extrait le contenu d’une URL.

Paramètre	Obligatoire	Description
url	Oui	URL à explorer

sitemap

Récupère tous les liens associés à une URL.

Paramètre	Obligatoire	Description
url	Oui	URL dont récupérer le sitemap

trending

Récupère les sujets tendance des plateformes populaires.

Paramètre	Obligatoire	Valeur par défaut	Description
search_service	Oui	-	github, hackernews
max_results	Non	10	Nombre d’éléments

ask

Recherche agentique : décrivez votre besoin en langage naturel et Search1API sélectionne jusqu’à cinq moteurs et une période, écarte les résultats hors sujet et renvoie au maximum 10 résultats pertinents pouvant être cités. Le résultat contient également intent (mots-clés, moteurs et période utilisés) et errors (moteurs ayant échoué alors que les autres ont terminé). Coûte 5 crédits par requête terminée ; utilisez search si vous connaissez déjà le moteur.

Paramètre	Obligatoire	Description
query	Oui	Requête en langage naturel, jusqu’à 500 caractères

maps

Recherche des entreprises et des lieux à proximité sur Google Maps. Renvoie une page contenant jusqu’à 20 lieux sous forme de résultats pouvant être cités : title correspond au nom du lieu, url à son lien Google Maps et metadata contient l’adresse, le téléphone, le site Web, la catégorie, la note, le nombre d’avis, les coordonnées, les horaires d’ouverture, l’état d’ouverture et la fourchette de prix, lorsque ces informations sont disponibles. Coûte 3 crédits par page, quel que soit le nombre de lieux qu’elle contient.

Paramètre	Obligatoire	Valeur par défaut	Description
query	Oui	-	Ce que vous recherchez, par exemple « cafés » ou « dentistes à Austin »
country	Non	us	Code pays à deux lettres
language	Non	en	Langue des résultats, par exemple en, de ou zh-CN
location	Non	-	{ latitude, longitude, zoom? } pour effectuer une recherche autour d’un point ; obligatoire à partir de la page 2
page	Non	1	Page Google Maps, de 1 à 6 ; chaque page correspond à un appel distinct
max_results	Non	20	Nombre de lieux à renvoyer depuis la page (1-20) ; en renvoyer moins ne réduit pas le prix

deepcrawl

Lit de nombreuses pages d’un même site en une seule tâche, par exemple une section de documentation. Trouve les URL du site via son sitemap, conserve celles qui correspondent aux règles de chemin et renvoie jusqu’à max_pages pages sous forme de résultats pouvant être cités : title, url et le Markdown de la page dans text. Le résultat contient également stats (découvertes, correspondantes, ignorées, explorées, en échec), failed (URL impossibles à lire, avec la raison), l’API message et result_url, un fichier JSON contenant toutes les pages dans leur intégralité. Coûte 20 crédits par tâche démarrée, quel que soit le nombre de pages lues.

L’outil attend jusqu’à environ 45 secondes. Si l’exploration est toujours en cours, il renvoie status: "running" avec un task_id ; rappelez deepcrawl avec ce task_id pour récupérer les pages. Cette opération est gratuite et ne lance aucune nouvelle exploration. Le texte des pages est limité à 8 000 caractères par page et à 80 000 au total ; les pages raccourcies comportent metadata.truncated: true, et result_url contient le texte intégral.

Paramètre	Obligatoire	Valeur par défaut	Description
url	Oui, sauf si task_id est fourni	-	Site ou section à explorer, par exemple https://example.com/docs/
max_pages	Non	10	Nombre maximal de pages à lire (1-50), dans l’ordre de découverte après application des règles de chemin ; le prix est identique quel que soit le nombre
include_paths	Non	-	Jusqu’à 20 règles de chemin d’URL à conserver. Sans *, une règle correspond à un préfixe de chemin délimité par des segments (/docs correspond à /docs/api, mais pas à /docsearch) ; avec *, elle doit correspondre au chemin entier et * correspond également à /
exclude_paths	Non	-	Jusqu’à 20 règles de chemin à ignorer, avec la même syntaxe ; l’exclusion est prioritaire
type	Non	sitemap	sitemap utilise le sitemap du site, ou les liens de la page de départ si le site n’en a pas ; all utilise tous les liens découverts à partir de l’URL de départ
task_id	Non	-	task_id d’une exploration toujours en cours ; vérifie uniquement son état, les autres paramètres sont ignorés

send_feedback

Signalez à l’équipe Search1API un résultat erroné, vide ou incomplet, une erreur que vous n’avez pas pu résoudre, une documentation qui ne correspond pas au comportement observé ou une fonctionnalité manquante. Gratuit ; aucun crédit n’est dépensé. Lorsque le serveur dispose d’un identifiant Search1API, le signalement est associé à ce compte afin que l’équipe puisse assurer le suivi. N’incluez aucun identifiant ni aucune donnée privée.

Paramètre	Obligatoire	Description
message	Oui	Ce qui n’a pas fonctionné ou ce qui manquait, jusqu’à 4000 caractères
intent	Non	Ce que vous essayiez d’accomplir
category	Non	bug, feature_request, docs, other
request_id	Non	ID de requête de l’appel qui a rencontré le problème
model	Non	Nom de votre modèle

Historique des versions

• v0.11.0 : nouvel outil deepcrawl pour lire jusqu’à 50 pages d’un même site en une seule tâche (20 crédits par tâche ; la vérification d’une tâche en cours est gratuite)

• v0.10.0 : nouvel outil maps pour rechercher des lieux sur Google Maps (3 crédits par page de 20 lieux maximum)

• v0.7.0 : nouvel outil ask pour la recherche agentique. search ajoute les moteurs bingcn, yandex et grokipedia, ainsi qu’un paramètre page ; search et news acceptent time_range: "week" et transmettent les champs published_date, GitHub et Hacker News dans le résultat metadata

• v0.6.1 : correction de bogue — la découverte MCP (initialize, tools/list, resources/*, prompts/list, server/discover) nécessite à nouveau une authentification. La mise à disposition sans authentification amenait les clients qui assimilent « outils répertoriés » à « connecté » à afficher un état connecté sans possibilité de déclencher le flux OAuth ; le défi 401 répond désormais à chaque requête non authentifiée, rétablissant la connexion OAuth au moment de la connexion. La visibilité dans les annuaires reste inchangée grâce à la fiche statique du serveur et aux métadonnées du registre

• v0.6.0 : la découverte MCP (initialize, tools/list, resources/*, prompts/list, server/discover) est disponible sans authentification afin que les clients et les annuaires puissent répertorier les outils avant la connexion ; les appels d’outils nécessitent toujours OAuth ou une clé API. Le mode Stdio démarre sans SEARCH1API_KEY et fournit les métadonnées des outils, en ne refusant les requêtes qu’au moment de l’appel. Les requêtes mal formées reçoivent une réponse JSON-RPC plutôt qu’une page d’erreur HTML

• v0.5.4 : l’émetteur OAuth a été déplacé vers clerk.s1.dev et peut être configuré avec OAUTH_AUTHORIZATION_SERVER ; la fiche du 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 OAuth et des outils ne nécessitent plus de portées de session OIDC ; ajout des badges des registres 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 : synchronisation de la documentation, du manifeste LobeHub et des métadonnées du registre MCP ; robots.txt est fourni 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 des requêtes

• v0.4.0 : schémas de sortie structurée, mécanismes 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 Remote MCP ; suppression de l’outil de raisonnement retiré

• v0.3.0 : prise en charge de Remote MCP via Streamable HTTP ; authentification par clé API par session

• v0.2.0 : prise en charge de secours de .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 Wikipédia

• 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 du Web

• v0.1.0 : version initiale

Licence

MIT

Crédits de l’interface et des tiers

La vue MCP Apps de render_results affiche les sources existantes sous forme de cartes avec leurs titres et leurs domaines. Chaque client reçoit également le texte intégral et la liste structurée des résultats. Le composant est adapté de Rare UI, par Swami Malode. Ses conditions MIT + Commons Clause + Attribution sont reproduites dans THIRD_PARTY_NOTICES.md.

Configuration de l’interface, origine du bac à sable et vérifications de publication : MCP Apps UI.