Search1API

Servidor MCP de Search1API

中文文档 | Deutsch

El servidor MCP oficial de Search1API: búsqueda web, noticias, recuperación de páginas, descubrimiento de mapas del sitio y temas de actualidad en una sola API.

Autenticación

• Los clientes compatibles con OAuth pueden conectarse directamente a la URL de Remote MCP y, después, iniciar sesión y aprobar el acceso en el navegador.
• Las integraciones existentes pueden seguir usando una clave de API del panel de Search1API.
• Todas las solicitudes MCP, incluido el descubrimiento de herramientas (initialize, tools/list), requieren credenciales. Las solicitudes no autenticadas reciben el desafío OAuth, que es la forma en que los clientes inician el proceso de inicio de sesión; la inspección previa a la conexión se ofrece mediante la ficha estática del servidor.

Inicio rápido (Remote MCP)

No se requiere instalación. Configura tu cliente MCP con la URL remota. Usa OAuth si el cliente lo admite 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 una 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 de URL (heredado)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Se recomienda usar OAuth o el encabezado de autorización. Las credenciales en parámetros de consulta pueden quedar expuestas en URL, registros e historial del shell.

Interfaz de usuario opcional para búsqueda y noticias

Remote MCP expone render_results en el endpoint estándar indicado arriba. Las herramientas de datos, como search, news y ask, devuelven resultados sin mostrar tarjetas automáticamente. Cuando resulta útil mostrar una lista de fuentes, el modelo puede seleccionar o combinar resultados existentes y pasarlos a render_results. Esta herramienta devuelve tarjetas de fuentes en clientes MCP Apps y una lista de texto completa y legible en los demás casos. La representación no repite una búsqueda ni consume créditos de búsqueda; no se requiere ningún parámetro de URL para la interfaz de usuario.

Tanto HTTP como stdio anuncian el logotipo cuadrado de Search1API mediante los metadatos estándar de serverInfo.icons. El PNG de 512×512 se ofrece públicamente en https://mcp.search1api.com/assets/icon-square.png, sin autenticación ni redirecciones. La ficha del servidor y el manifiesto del registro usan el mismo icono. Los clientes deciden si lo muestran; este no sustituye a un icono almacenado por separado en un directorio de plugins.

Consulta el contrato de representación para ver los argumentos, los límites y el comportamiento alternativo. El paquete npm incluye este renderizador desde la versión 0.8.0. Actualiza las instalaciones existentes y reinicia la conexión MCP; npx -y search1api-mcp@latest inicia la versión más reciente publicada del paquete.

Después de cambiar la URL, vuelve a conectar o actualiza las definiciones de herramientas del conector; es posible que los clientes las almacenen en caché. Este ajuste de URL solo se aplica a Remote MCP; el comportamiento de stdio local no cambia. Consulta Interfaz de usuario de MCP Apps para obtener más información y conocer el estado de la versión.

Claude Desktop

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

Claude.ai (Web)

Instala Search1API desde el directorio de Claude, haz clic en Connect e inicia sesión con tu cuenta de Search1API.

Evita añadir https://mcp.search1api.com/mcp mediante Add custom connector: eso crea un conector personalizado independiente, al que Claude asigna el nombre del host de la URL (mcp.search1api.com), a menos que escribas un nombre.

Cursor

Instálalo como plugin de Cursor (recomendado): este repositorio incluye Agent Plugins plugin.json + mcp.json (portátil) y .cursor-plugin/plugin.json (metadatos/logotipo de Cursor Marketplace) para Remote MCP con OAuth. Envíalo o instálalo desde cursor.directory / Cursor Marketplace y, cuando se te solicite, inicia sesión.

Para realizar 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 los destinos de enlaces simbólicos externos.

O configúralo manualmente:

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

Antigravity

Instálalo como plugin de Antigravity: antigravity-plugin/ contiene el manifiesto, mcp_config.json (Remote MCP con OAuth), la skill de Search1API y un README de Marketplace. Instálalo directamente desde GitHub e inicia sesión cuando se abra el navegador:

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

Para realizar pruebas locales, ejecuta agy plugin validate --strict ./antigravity-plugin y agy plugin install ./antigravity-plugin desde una copia del repositorio.

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

Agent Skill se ha trasladado a search1api-cli. Instálalo 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 posterior con npx; no es necesario clonar el repositorio:

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

Para implementaciones HTTP autohospedadas detrás de un proxy, añade a la variable de entorno MCP_ALLOWED_HOSTS, separada por comas, cualquier nombre de host interno que llegue al proceso de Node.js. De forma predeterminada, se permiten mcp.search1api.com y las direcciones localhost. Los clientes basados en navegador que envíen 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 ninguna entrada.

Herramientas

search

Busca en la web con Search1API. Los resultados incluyen una estructura citable id/title/url. Pasa la URL de un 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, bingcn, duckduckgo, yahoo, yandex, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia, grokipedia
page	No	1	Página de resultados (1-100); solo bing, bingcn, baidu y grokipedia admiten paginación
crawl_results	No	0	Número de resultados principales cuyo contenido completo se rastreará; cada rastreo correcto añade 1 crédito a la solicitud de búsqueda base de 1 crédito
include_sites	No	[]	Sitios que se incluirán
exclude_sites	No	[]	Sitios que se excluirán
time_range	No	-	day, week, month, year

Los resultados incluyen published_date en metadata cuando el motor proporciona uno; los resultados de github añaden kind, stars, language y num_comments.

news

Busca artículos de noticias. Los resultados de hackernews enlazan al hilo de debate y añaden story_url, points y num_comments a metadata.

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 cuyo contenido completo se rastreará; cada rastreo correcto añade 1 crédito a la solicitud de noticias base de 1 crédito
include_sites	No	[]	Sitios que se incluirán
exclude_sites	No	[]	Sitios que se excluirán
time_range	No	-	day, week, month, year

crawl

Extrae contenido de una URL.

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

sitemap

Obtiene todos los enlaces relacionados con una URL.

Parámetro	Obligatorio	Descripción
url	Sí	URL cuyo mapa del sitio se obtendrá

trending

Obtiene temas de actualidad de plataformas populares.

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

ask

Búsqueda agéntica: describe la necesidad en lenguaje natural y Search1API selecciona hasta cinco motores y un intervalo de tiempo, descarta los resultados irrelevantes y devuelve como máximo 10 resultados citables ordenados por relevancia. El resultado también incluye intent (palabras clave, motores e intervalo utilizados) y errors (motores que fallaron mientras los demás completaron la búsqueda). Cuesta 5 créditos por solicitud completada; usa search si ya conoces el motor.

Parámetro	Obligatorio	Descripción
query	Sí	La solicitud en lenguaje natural, de hasta 500 caracteres

maps

Busca negocios y lugares locales en Google Maps. Devuelve una página con hasta 20 lugares como resultados citables: title es el nombre del lugar, url es su enlace de Google Maps y metadata contiene la dirección, el teléfono, el sitio web, la categoría, la valoración, el número de reseñas, las coordenadas, el horario de apertura, el estado de apertura y el rango de precios, cuando estén disponibles. Cuesta 3 créditos por página, independientemente del número de lugares que contenga.

Parámetro	Obligatorio	Predeterminado	Descripción
query	Sí	-	Qué buscar, por ejemplo, "cafeterías" o "dentistas en Austin"
country	No	us	Código de país de dos letras
language	No	en	Idioma de los resultados, por ejemplo, en, de o zh-CN
location	No	-	{ latitude, longitude, zoom? } para buscar alrededor de un punto; obligatorio a partir de la página 2
page	No	1	Página de Google Maps, 1-6; cada página es una llamada independiente
max_results	No	20	Lugares que se devolverán de la página (1-20); devolver menos lugares no reduce el precio

deepcrawl

Lee muchas páginas de un mismo sitio en una sola tarea, por ejemplo, una sección de documentación. Encuentra las URL del sitio mediante su mapa del sitio, conserva las que coinciden con las reglas de ruta y devuelve hasta max_pages páginas como resultados citables: title, url y el Markdown de la página en text. El resultado también incluye stats (descubiertas, coincidentes, omitidas, rastreadas, fallidas), failed (URL que no se pudieron leer, con el motivo), la API message y result_url, un archivo JSON con todas las páginas completas. Cuesta 20 créditos por tarea iniciada, independientemente del número de páginas que lea.

La herramienta espera hasta unos 45 segundos. Si el rastreo sigue en curso, devuelve status: "running" con un task_id; vuelve a llamar a deepcrawl con ese task_id para recopilar las páginas. Esta operación es gratuita y no inicia un nuevo rastreo. El texto de cada página está limitado a 8.000 caracteres y el total a 80.000; las páginas abreviadas tienen metadata.truncated: true y result_url contiene el texto completo.

Parámetro	Obligatorio	Predeterminado	Descripción
url	Sí, salvo que se proporcione task_id	-	Sitio o sección que se rastreará, por ejemplo, https://example.com/docs/
max_pages	No	10	Número máximo de páginas que se leerán (1-50), en el orden de descubrimiento tras aplicar las reglas de ruta; el precio es el mismo independientemente del número
include_paths	No	-	Hasta 20 reglas de ruta de URL que se conservarán. Sin *, una regla es un prefijo de ruta en los límites de segmento (/docs coincide con /docs/api, pero no con /docsearch); con *, debe coincidir con la ruta completa y * también coincide con /
exclude_paths	No	-	Hasta 20 reglas de ruta que se omitirán, con la misma sintaxis; las exclusiones tienen prioridad
type	No	sitemap	sitemap usa el mapa del sitio del sitio o, si no tiene uno, los enlaces de la página inicial; all usa todos los enlaces descubiertos desde la URL inicial
task_id	No	-	task_id de un rastreo que seguía en curso; solo comprueba su estado y se ignoran los demás parámetros

send_feedback

Informa al equipo de Search1API sobre un resultado incorrecto, vacío o incompleto, un error que no pudiste resolver, documentación que no coincide con el comportamiento o una función que falta. Es gratis y no consume créditos. Si el servidor tiene credenciales de Search1API, el informe se vincula a esa cuenta para que el equipo pueda hacer un seguimiento. No incluyas credenciales ni datos privados.

Parámetro	Obligatorio	Descripción
message	Sí	Qué salió mal o qué faltaba, hasta 4000 caracteres
intent	No	Qué intentabas conseguir
category	No	bug, feature_request, docs, other
request_id	No	ID de solicitud de la llamada que tuvo el problema
model	No	Nombre de tu modelo

Historial de versiones

• v0.11.0: Nueva herramienta deepcrawl para leer hasta 50 páginas de un sitio en una sola tarea (20 créditos por tarea; consultar una tarea en curso es gratis)

• v0.10.0: Nueva herramienta maps para buscar lugares en Google Maps (3 créditos por página de hasta 20 lugares)

• v0.7.0: Nueva herramienta ask para búsquedas agénticas. search añade los motores bingcn, yandex y grokipedia, además de un parámetro page; search y news aceptan time_range: "week" y transmiten los campos de published_date, GitHub y Hacker News en el resultado metadata

• v0.6.1: Corrección de errores: el descubrimiento de MCP (initialize, tools/list, resources/*, prompts/list, server/discover) vuelve a requerir credenciales. Ofrecerlo de forma anónima hacía que los clientes que equiparan «herramientas enumeradas» con «sesión iniciada» mostraran un estado de conexión sin forma de iniciar el flujo de OAuth; ahora el desafío 401 responde a todas las solicitudes no autenticadas y restablece el inicio de sesión con OAuth al conectarse. La visibilidad en directorios no cambia gracias a la tarjeta estática del servidor y a los metadatos del registro

• v0.6.0: El descubrimiento de MCP (initialize, tools/list, resources/*, prompts/list, server/discover) se ofrece sin credenciales para que los clientes y directorios puedan enumerar las herramientas antes de iniciar sesión; las llamadas a herramientas siguen requiriendo OAuth o una clave de API. El modo Stdio se inicia sin SEARCH1API_KEY y ofrece metadatos de herramientas, y solo las rechaza al invocarlas. Las solicitudes malformadas responden como JSON-RPC en lugar de mostrar una página de error HTML

• v0.5.4: El emisor de OAuth se trasladó a clerk.s1.dev y se puede configurar con OAUTH_AUTHORIZATION_SERVER; la tarjeta del 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 añadieron insignias de los registros 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; las implementaciones HTTP autohospedadas pueden configurar orígenes de navegador de confianza con MCP_ALLOWED_ORIGINS

• v0.5.1: Se sincronizaron la documentación, el manifiesto de LobeHub y los metadatos del registro de MCP; robots.txt se ofrece en el host de transporte

• v0.5.0: Compatibilidad con MCP 2026-07-28 y negociación automática del protocolo; compatibilidad sin estado para clientes HTTP de la era 2025; autenticación a nivel de solicitud

• v0.4.0: Esquemas de salida estructurada, esquemas de seguridad OAuth, anotaciones de seguridad y metadatos del registro oficial de MCP

• v0.3.1: Compatibilidad con OAuth 2.1 para Remote MCP; se eliminó la herramienta de razonamiento retirada

• v0.3.0: Compatibilidad con Remote MCP mediante Streamable HTTP; autenticación con clave de API por sesión

• v0.2.0: Compatibilidad alternativa con .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: Versión inicial

Licencia

MIT

Créditos de la interfaz y de terceros

La vista de MCP Apps de render_results muestra las fuentes existentes como tarjetas con títulos y dominios. Todos los clientes también reciben el texto completo y la lista estructurada de resultados. El componente está adaptado de Rare UI, de Swami Malode. Sus términos MIT + Commons Clause + Attribution se reproducen en THIRD_PARTY_NOTICES.md.

Configuración de la interfaz, origen del entorno aislado y comprobaciones de publicación: MCP Apps UI.