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 de tendencia en una sola API.

Autenticación

• Los clientes compatibles con OAuth pueden conectarse directamente a la URL MCP remota, luego iniciar sesión y aprobar el acceso en el navegador.
• Las integraciones existentes pueden seguir usando una clave de API desde el panel de Search1API.
• Cada solicitud MCP, incluido el descubrimiento de herramientas (initialize, tools/list), requiere una credencial. Las solicitudes no autenticadas reciben el desafío OAuth, que es como los clientes activan el inicio de sesión; la inspección previa a la conexión se sirve mediante la tarjeta de servidor estática en su lugar.

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 de 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 en URL (heredado)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

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

Claude Desktop

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

Claude.ai (Web)

Configuración > Conectores > Agregar conector personalizado:

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

Cursor

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

Para pruebas locales, copia los archivos del complemento en ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). No uses 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 de agente

La habilidad de 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 implementaciones HTTP autohospedadas detrás de un proxy, agrega cualquier nombre de host interno que llegue al proceso de Node.js a la variable de entorno MCP_ALLOWED_HOSTS separada por comas. mcp.search1api.com y las direcciones localhost están permitidas por defecto. Los clientes basados en navegador que envíen un encabezado Origin también deben tener sus nombres de host de origen de confianza agregados 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 de 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 contenido completo; cada rastreo exitoso agrega 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	-	día, mes, año

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 contenido completo; cada rastreo exitoso agrega 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	-	día, mes, año

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 de 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.6.1: Corrección de errores: el descubrimiento de MCP (initialize, tools/list, resources/*, prompts/list, server/discover) vuelve a requerir una credencial. Servirlo de forma anónima hacía que los clientes que equiparan "herramientas listadas" con "sesión iniciada" mostraran un estado conectado sin forma de activar el flujo de OAuth; el desafío 401 ahora responde a cada solicitud no autenticada, restaurando el inicio de sesión OAuth al momento de la conexión. La visibilidad del directorio no cambia mediante la tarjeta de servidor estática y los metadatos del registro
• v0.6.0: El descubrimiento de MCP (initialize, tools/list, resources/*, prompts/list, server/discover) se sirve sin credencial para que los clientes y directorios puedan enumerar herramientas antes de iniciar sesión; las llamadas a herramientas aún requieren OAuth o una clave de API. El modo stdio se inicia sin SEARCH1API_KEY y sirve metadatos de herramientas, rechazando solo al momento de la llamada. Las solicitudes malformadas responden como JSON-RPC en lugar de una página de error HTML
• v0.5.4: El emisor de OAuth se movió a clerk.s1.dev y es configurable con OAUTH_AUTHORIZATION_SERVER; la tarjeta de servidor MCP se publicó en /.well-known/mcp/server-card.json; los documentos de descubrimiento de OAuth ahora envían encabezados de caché
• v0.5.3: Los metadatos de recursos y herramientas de OAuth ya no requieren ámbitos de sesión OIDC; se agregaron insignias de registro de Smithery y Glama
• v0.5.2: La validación de Origin de MCP ahora se ejecuta antes del análisis de solicitudes y la autenticación; las implementaciones HTTP autohospedadas 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 de OAuth 2.1 para MCP remoto; se eliminó la herramienta de razonamiento retirada
• v0.3.0: Soporte de MCP remoto mediante Streamable HTTP; autenticación con clave de API por sesión
• v0.2.0: Soporte de respaldo .env para 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