Search1API

Servidor MCP de Search1API

Documentación en chino

El servidor MCP oficial para Search1API — búsqueda web, noticias, recuperación de páginas, descubrimiento de sitemaps y temas tendencia en una sola API.

Autenticación

• Los clientes con soporte OAuth pueden conectarse directamente a la URL MCP remota y luego iniciar sesión y aprobar el acceso en el navegador.
• Las integraciones existentes pueden seguir usando una clave API del panel de Search1API.

Inicio Rápido (MCP Remoto)

No se requiere instalación. Configura tu cliente MCP con la URL remota. Usa OAuth cuando el cliente lo admita, o proporciona una clave API.

Autenticación

Se admiten tres métodos: usa el que admita tu cliente.

Método	Formato
OAuth 2.1	Conéctate a https://mcp.search1api.com/mcp sin clave y sigue el flujo de inicio de sesión del cliente
Encabezado de autorización	Authorization: Bearer YOUR_SEARCH1API_KEY
Parámetro de consulta URL (legado)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Prefiere OAuth o el encabezado de autorización. Las credenciales de parámetros de consulta pueden quedar expuestas en URLs, registros y el historial del shell.

Claude Desktop

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

Claude.ai (Web)

Configuración > Conectores > Añadir conector personalizado:

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

Cursor

Instala como plugin de Cursor (recomendado): este repositorio incluye Agent Plugins plugin.json + mcp.json (portátiles) y .cursor-plugin/plugin.json (metadatos / logo del Cursor Marketplace) para MCP remoto con OAuth. Envía o instala desde cursor.directory / el Cursor Marketplace, y luego inicia sesión cuando se te solicite.

Para pruebas locales, copia los archivos del plugin en ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). No crees enlaces simbólicos desde fuera de ese directorio: Cursor rechaza destinos de enlaces simbólicos externos.

O configura manualmente:

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

Habilidad del Agente

La Habilidad del Agente se ha movido a search1api-cli. Instálala con:

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

Modo Local (stdio)

Si prefieres ejecutar el servidor localmente, usa Node.js 20 o superior con npx — no se requiere clonar:

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

Para despliegues HTTP autoalojados detrás de un proxy, añade cualquier nombre de host interno que llegue al proceso de Node.js a la variable de entorno MCP_ALLOWED_HOSTS separada por comas. Las direcciones mcp.search1api.com y localhost están permitidas por defecto. Los clientes basados en navegador que envían un encabezado Origin también deben tener sus nombres de host de origen de confianza añadidos a la variable MCP_ALLOWED_ORIGINS separada por comas. Las solicitudes de clientes MCP del lado del servidor normalmente omiten Origin y no requieren una entrada.

Herramientas

search

Busca en la web usando Search1API. Los resultados incluyen una estructura citable id/title/url. Pasa una URL de resultado a crawl cuando necesites la página completa.

Parámetro	Obligatorio	Predeterminado	Descripción
query	Sí	-	Consulta de búsqueda
max_results	No	10	Número de resultados
search_service	No	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	No	0	Número de resultados principales a rastrear para obtener contenido completo; cada rastreo exitoso añade 1 crédito a la solicitud de búsqueda base de 1 crédito
include_sites	No	[]	Sitios a incluir
exclude_sites	No	[]	Sitios a excluir
time_range	No	-	day, month, year

news

Busca artículos de noticias.

Parámetro	Obligatorio	Predeterminado	Descripción
query	Sí	-	Consulta de búsqueda
max_results	No	10	Número de resultados
search_service	No	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	No	0	Número de resultados principales a rastrear para obtener contenido completo; cada rastreo exitoso añade 1 crédito a la solicitud de noticias base de 1 crédito
include_sites	No	[]	Sitios a incluir
exclude_sites	No	[]	Sitios a excluir
time_range	No	-	day, month, year

crawl

Extrae contenido de una URL.

Parámetro	Obligatorio	Descripción
url	Sí	URL a rastrear

sitemap

Obtén todos los enlaces relacionados de una URL.

Parámetro	Obligatorio	Descripción
url	Sí	URL para obtener el sitemap

trending

Obtén temas tendencia de plataformas populares.

Parámetro	Obligatorio	Predeterminado	Descripción
search_service	Sí	-	github, hackernews
max_results	No	10	Número de elementos

Historial de Versiones

• v0.5.3: Los metadatos de recursos y herramientas OAuth ya no requieren alcances de sesión OIDC; se añadieron insignias de registro de Smithery y Glama
• v0.5.2: La validación de MCP Origin ahora se ejecuta antes del análisis de solicitudes y la autenticación; los despliegues HTTP autoalojados pueden configurar orígenes de navegador de confianza con MCP_ALLOWED_ORIGINS
• v0.5.1: Documentación, manifiesto de LobeHub y metadatos del Registro MCP sincronizados; robots.txt servido en el host de transporte
• v0.5.0: Soporte de MCP 2026-07-28 con negociación automática de protocolo; compatibilidad sin estado para clientes HTTP de la era 2025; autenticación a nivel de solicitud
• v0.4.0: Esquemas de salida estructurados, esquemas de seguridad OAuth, anotaciones de seguridad y metadatos del Registro MCP oficial
• v0.3.1: Soporte OAuth 2.1 para MCP remoto; se eliminó la herramienta de razonamiento retirada
• v0.3.0: Soporte MCP remoto mediante HTTP transmisible; autenticación con clave API por sesión
• v0.2.0: Soporte de respaldo .env para la integración con LibreChat
• v0.1.8: Servicios de búsqueda de X (Twitter) y Reddit
• v0.1.7: Herramienta de tendencias para GitHub y Hacker News
• v0.1.6: Servicio de búsqueda de Wikipedia
• v0.1.5: Nuevos parámetros y servicios de búsqueda (arxiv, wechat, bilibili, imdb)
• v0.1.3: Búsqueda de noticias
• v0.1.2: Sitemap
• v0.1.1: Rastreo web
• v0.1.0: Lanzamiento inicial

Licencia

MIT