Servidor MCP de AnySearch

Servidor MCP de búsqueda unificada en tiempo real que admite búsqueda web general, búsqueda en dominios verticales (23 dominios), búsqueda por lotes en paralelo y extracción de contenido de páginas URL completas.

Características

• Búsqueda web general — consultas en lenguaje natural de formato libre

• Búsqueda en dominios verticales — consultas estructuradas en 23 dominios (finanzas, académico, seguridad, legal, código, etc.)

• Búsqueda por lotes en paralelo — hasta 5 consultas independientes en una sola llamada

• Extracción de contenido de URL — obtiene y extrae el contenido completo de la página como Markdown

• Acceso anónimo — funciona sin una clave API (con límites de tasa más bajos)

Related MCP server: Scout

Configuración de la clave API

Una clave API es opcional pero recomendada. Sin una clave, todas las funciones siguen funcionando mediante acceso anónimo con límites de tasa más bajos.

Obtener una clave API

Visita https://anysearch.com/console/api-keys para crear una clave API gratuita.

Prioridad de la clave

Comportamiento de la clave

Transporte MCP

El servidor MCP de AnySearch admite de forma nativa el transporte HTTP Streamable (especificación MCP 2025-03-26). Los clientes SSE y stdio pueden conectarse a través de un proxy.

Instalación

HTTP Streamable (Recomendado — No requiere proxy)

Para agentes que admiten el transporte HTTP Streamable (especificación MCP 2025-03-26+):

OpenCode (~/.opencode/config.json o opencode.json del proyecto):

{
  "mcp": {
    "anysearch": {
      "type": "streamable-http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ANYSEARCH_API_KEY}"
      }
    }
  }
}

Claude Desktop (2025.6+, claude_desktop_config.json):

{
  "mcpServers": {
    "anysearch": {
      "type": "streamable-http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ANYSEARCH_API_KEY}"
      }
    }
  }
}

Sin una clave API, omita la sección headers. El servidor utilizará el acceso anónimo automáticamente.

stdio (Vía Proxy)

Para agentes que solo admiten transporte stdio. Dos opciones de proxy:

Opción A: mcp-remote (Recomendado)

mcp-remote — detecta automáticamente HTTP Streamable, configuración más simple:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "anysearch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.anysearch.com/mcp",
        "--header",
        "Authorization: Bearer ${ANYSEARCH_API_KEY}"
      ]
    }
  }
}

VS Code Copilot (.vscode/mcp.json):

{
  "servers": {
    "anysearch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.anysearch.com/mcp",
        "--header",
        "Authorization: Bearer ${ANYSEARCH_API_KEY}"
      ]
    }
  }
}

Cline (configuración de VS Code):

{
  "mcpServers": {
    "anysearch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.anysearch.com/mcp",
        "--header",
        "Authorization: Bearer ${ANYSEARCH_API_KEY}"
      ]
    }
  }
}

Sin una clave API, omita los argumentos "--header" y "Authorization: Bearer ...".

Opción B: supergateway

supergateway — más opciones de transporte, admite salida SSE:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "anysearch": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://api.anysearch.com/mcp",
        "--oauth2Bearer",
        "${ANYSEARCH_API_KEY}"
      ]
    }
  }
}

Sin una clave API, omita los argumentos "--oauth2Bearer" y la clave.

SSE (Vía Proxy)

Para agentes que solo admiten transporte SSE (Cursor, Windsurf). Requiere ejecutar un servidor proxy SSE local:

Iniciar el proxy

npx -y supergateway \
  --streamableHttp https://api.anysearch.com/mcp \
  --outputTransport sse \
  --port 8000 \
  --oauth2Bearer <your_api_key>

Sin una clave API, omita el flag --oauth2Bearer.

Luego configure su agente:

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "anysearch": {
      "type": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "anysearch": {
      "serverUrl": "http://localhost:8000/sse"
    }
  }
}

El proxy SSE debe permanecer en ejecución mientras el agente esté activo. Considere ejecutarlo como un servicio en segundo plano.

Referencia rápida para agentes

Herramientas disponibles

search

Ejecuta una consulta de búsqueda, ya sea general o en un dominio vertical.

list_domains

Consulta el directorio de dominios verticales. Debe llamarse antes de la búsqueda vertical para descubrir los sub_domains disponibles y sus formatos de consulta.

Devuelve una tabla Markdown: sub_domain | description | query_format | params_schema | zone

batch_search

Ejecuta 2–5 consultas de búsqueda independientes en paralelo. Un fallo único no bloquea a las demás.

extract

Obtiene el contenido completo de la página desde una URL y lo devuelve como Markdown. Truncado a 50,000 caracteres. Solo páginas HTML.

Flujo de decisión

User query
  |
  +-- Has structured identifiers? (Stock:/CVE:/DOI:/IATA:/patent etc.)
  |     YES -> 1) list_domains -> discover sub_domain & query_format
  |             2) search with domain + sub_domain + zone
  |
  +-- Multiple independent intents?
  |     YES -> batch_search
  |
  +-- Need deeper content than snippets?
  |     YES -> extract the URL
  |
  +-- Otherwise -> search (general)

Restricciones de búsqueda vertical

Antes de la búsqueda vertical, debe llamar a list_domains para el dominio de destino y seguir:

1. query_format — formato exacto para la cadena de consulta (ej. ticker sin procesar, no lenguaje natural)

2. params_schema — esquema JSON para parámetros extra opcionales

3. zone — si es CN, debe establecer zone: "cn" en la llamada de búsqueda

4. Selección de sub_domain — haga coincidir la intención del usuario con la mejor descripción de sub_domain

Dominios admitidos

code tech fashion travel home ecommerce gaming film music finance academic legal business ip security education health religion geo environment energy ugc

Ejemplos

Búsqueda general

{ "query": "quantum computing breakthroughs 2025", "max_results": 5, "freshness": "month" }

Búsqueda vertical (acciones)

{ "query": "AAPL", "domain": "finance", "sub_domain": "finance.us_stock", "max_results": 5 }

Búsqueda por lotes

{
  "queries": [
    { "query": "AAPL", "domain": "finance", "sub_domain": "finance.us_stock" },
    { "query": "python async http client", "domain": "code", "sub_domain": "code.general" }
  ]
}

Extraer URL

{ "url": "https://en.wikipedia.org/wiki/Quantum_computing" }

Notas de seguridad

• Las consultas de búsqueda, las URL extraídas y las claves API se envían a https://api.anysearch.com

• No utilice para consultas que contengan información sensible (contraseñas, datos personales, secretos comerciales) a menos que confíe en el proveedor

• Evite pegar claves API directamente en el chat — utilice variables de entorno o archivos .env