SerpKite

Búsqueda de Google, noticias, mapas, académico, compras y páginas web públicas para agentes de IA, con resultados compactos en JSON o Markdown.

Ver en serpkite.comPrueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://api.serpkite.com/v1/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

SerpKite ejecuta un servidor remoto de Model Context Protocol. Cualquier cliente MCP que hable HTTP transmisible puede conectarse a él y llamar a la búsqueda de Google, Noticias, Mapas, Académico, un buscador de páginas y más como herramientas. No hay nada que instalar ni alojar.


URL	`https://api.serpkite.com/v1/mcp`
Transporte	HTTP transmisible (sin estado)
Autenticación	`Authorization: Bearer skt_live_…`
Versiones de protocolo	`2025-06-18`, `2025-03-26`, `2024-11-05`
Facturación	Mismos créditos que los endpoints REST

[!-accent] -accent OAuth está planificado

Hoy el servidor se autentica con tu clave de API en una cabecera. El inicio de sesión con OAuth para clientes que no pueden enviar cabeceras personalizadas está planificado. Hasta entonces, usa un cliente que te permita configurar cabeceras, o el puente mcp-remote que se muestra a continuación.

Obtener una clave

Crea una clave en el panel bajo API keys (consulta API keys). Para uso con MCP, una clave dedicada con un límite de crédito mensual es una buena idea: un agente en un bucle puede hacer muchas llamadas, y el límite limita lo que esa clave puede gastar. Los ejemplos a continuación leen la clave de la variable de entorno SERPKITE_API_KEY.

Claude Code

Un comando añade el servidor a Claude Code:

claude mcp add --transport http serpkite https://api.serpkite.com/v1/mcp \
  --header "Authorization: Bearer $SERPKITE_API_KEY"

Ejecuta claude mcp list para comprobar la conexión, luego pregunta a Claude algo que necesite resultados recientes ("¿qué cambió en la última versión de Go?"). Añade --scope project para escribir la configuración en .mcp.json para que todo tu equipo la reciba, pero mantén la clave fuera del control de versiones.

Claude Desktop

Claude Desktop lanza servidores locales (stdio) desde claude_desktop_config.json. Para llegar a un servidor remoto con una cabecera personalizada, usa el puente mcp-remote, que se ejecuta a través de npx:

{
  "mcpServers": {
    "serpkite": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.serpkite.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${SERPKITE_API_KEY}"
      ],
      "env": {
        "SERPKITE_API_KEY": "skt_live_..."
      }
    }
  }
}

El archivo se encuentra en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS y en %APPDATA%\Claude\claude_desktop_config.json en Windows. Reinicia Claude Desktop después de editarlo. Necesitas tener Node.js instalado para npx.

Donde tu plan ofrezca Settings → Connectors → Add custom connector, puedes añadir la URL allí en su lugar. Los conectores personalizados que necesiten una cabecera funcionarán sin el puente una vez que OAuth esté disponible.

Cursor

Añade el servidor a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto):

{
  "mcpServers": {
    "serpkite": {
      "url": "https://api.serpkite.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SERPKITE_API_KEY}"
      }
    }
  }
}

Abre Cursor Settings → MCP para comprobar que el servidor está en verde y que sus herramientas están listadas. Si tu versión de Cursor no expande ${env:…}, pega la clave directamente y mantén el archivo fuera de git.

VS Code

VS Code (modo agente de Copilot) lee .vscode/mcp.json. El bloque inputs solicita la clave una vez y la almacena de forma segura, por lo que nunca termina en el archivo:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "serpkite-key",
      "description": "SerpKite API key",
      "password": true
    }
  ],
  "servers": {
    "serpkite": {
      "type": "http",
      "url": "https://api.serpkite.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:serpkite-key}"
      }
    }
  }
}

Inicia el servidor desde el comando MCP: List Servers, luego elige las herramientas de SerpKite en el selector de herramientas del agente.

ChatGPT

ChatGPT puede conectar servidores MCP remotos como conectores cuando el modo desarrollador está habilitado para tu espacio de trabajo. Ten en cuenta que la configuración de conectores de ChatGPT se autentica con OAuth o sin autenticación, y puede que no te permita añadir una cabecera Authorization personalizada. Hasta que el soporte de OAuth de SerpKite esté disponible, ChatGPT es el único cliente en esta página que puede que no pueda conectarse directamente. Para modelos de OpenAI en tu propio código, usa la guía de llamadas a herramientas en su lugar, o el SDK de OpenAI Agents, que acepta cabeceras de servidor MCP.

Otros clientes

Cualquier cliente que soporte HTTP transmisible con cabeceras personalizadas funciona con los mismos dos valores: la URL y la cabecera Authorization. Los clientes que solo soportan stdio pueden usar npx -y mcp-remote https://api.serpkite.com/v1/mcp --header "Authorization: Bearer …" como comando, como en el ejemplo de Claude Desktop.

Herramientas

Todas las herramientas devuelven texto formateado para un modelo. Las herramientas de búsqueda y de páginas web usan Markdown; map y extract formatean sus resultados como texto; crawl devuelve un ID de tarea y crawl_result devuelve su estado o páginas. La facturación coincide con la operación REST correspondiente, y el sondeo de crawl es gratuito.

Herramienta	Qué hace	Entradas	Créditos
`search`	Búsqueda web de Google: resultados orgánicos, caja de respuestas, grafo de conocimiento, People Also Ask, búsquedas relacionadas	`q`, `country`, `language`, `location`, `page`, `time`, `engine`, `num` (10, 20, 30, 50, 100), `include_content` (0–5), `highlights`, `include_domains`, `exclude_domains`, `boost_domains`, `start_date`, `end_date`	1 por página, hasta 7 para `num: 100`, +1 por página obtenida
`news`	Artículos de Google News	`q`, `country`, `language`, `location`, `page`, `time`, `engine`, `include_domains`, `exclude_domains`, `boost_domains`, `start_date`, `end_date`	1
`maps`	Lugares con dirección, valoración, teléfono, sitio web, coordenadas	`q`, `country`, `language`, `location`, `page`	1
`scholar`	Artículos académicos con citas y enlaces PDF	`q`, `country`, `language`, `page`	1
`patents`	Búsqueda de patentes	`q`, `country`, `language`, `page`	1
`shopping`	Productos con precios y comerciantes	`q`, `country`, `language`, `location`, `page`	1
`images`	Búsqueda de imágenes	`q`, `country`, `language`, `location`, `page`, `engine`, `include_domains`, `exclude_domains`, `start_date`, `end_date`	1
`videos`	Búsqueda de vídeos	`q`, `country`, `language`, `location`, `page`, `engine`, `include_domains`, `exclude_domains`, `start_date`, `end_date`	1
`autocomplete`	Sugerencias de consulta	`q`, `country`, `language`	0.5
`webpage`	Obtener una URL pública (HTML o PDF) y devolver su contenido principal como Markdown con metadatos	`url`, `country`	1
`extract`	Leer hasta 20 URLs (HTML o PDF) como Markdown, o solo los pasajes relevantes para una consulta	`urls`, `query`, `highlights`, `max_tokens`, `country`, `timeout`	1 por URL leída (las URLs fallidas son gratuitas)
`crawl`	Iniciar un crawl asíncrono de un sitio (o una sección del mismo); devuelve un ID	`url`, `limit`, `max_depth`, `query`, `include_paths`, `exclude_paths`, `max_tokens`	1 por página leída (`limit` reservado, el resto reembolsado)
`crawl_result`	El estado o las páginas de un crawl iniciado con `crawl`	`id`	Gratis
`map`	Listar las URLs de un sitio desde sus sitemaps y página de inicio, opcionalmente ordenadas por una frase de búsqueda	`url`, `search`, `limit`, `include_paths`, `exclude_paths`	1 (gratis cuando no se encuentra nada)

Las herramientas de consulta requieren q; webpage, map y crawl requieren url; extract requiere urls; crawl_result requiere id. El highlights de búsqueda es un booleano usado con include_content; el highlights de extract es un número entero de recuento de pasajes (0–10). time es uno de hour, day, week, month, year. Al igual que con la API REST, las llamadas fallidas y vacías no se facturan.

Los esquemas MCP exponen un subconjunto de opciones REST. Usa tools/list para inspeccionar las entradas disponibles, o llama a REST/SDKs para opciones como extraer enlaces/imágenes, cancelación de crawl y gestión de monitores. La guía de ingesta de sitios y la guía de monitoreo cubren esos flujos de trabajo.

Probarlo con curl

El servidor no tiene estado: cada POST lleva un mensaje JSON-RPC 2.0 (o un lote de hasta 20) y recibe una respuesta JSON. No se necesita configuración de sesión, lo que facilita probarlo manualmente.

Inicializar:

curl https://api.serpkite.com/v1/mcp \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Listar las herramientas:

curl https://api.serpkite.com/v1/mcp \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Llamar a search:

curl https://api.serpkite.com/v1/mcp \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search","arguments":{"q":"best espresso machine 2026","country":"us"}}}'

El array content del resultado contiene un elemento text con el Markdown. Las notificaciones (mensajes sin id) reciben un 202 Accepted vacío. Una clave faltante o inválida devuelve 401 con el cuerpo de error habitual.

Costos y seguridad

Las llamadas de búsqueda y lectura de contenido se facturan como sus equivalentes REST; el sondeo de crawl_result es gratuito. Los resultados fallidos y vacíos no se facturan.
Dale a la clave MCP un credit_limit mensual para que un bucle de agente descontrolado se detenga a un costo conocido. Cuando se alcanza el límite, las llamadas fallan con key_limit_reached y no se cobra nada más. Consulta Controles de gasto.
El servidor solo obtiene páginas públicas y sin sesión iniciada. La herramienta webpage rechaza direcciones de redes privadas.

Relacionado

[Descripción general de la integración MCP

Tutoriales de configuración y casos de uso para Claude, Cursor y ChatGPT.

](https://serpkite.com/integrations/mcp)[Llamada a herramientas sin MCP

Define una herramienta de búsqueda directamente para modelos de OpenAI y Anthropic.

](https://serpkite.com/docs/guides/agents-tool-calling)[Formatos de salida

Cómo se ve el Markdown que devuelven las herramientas.

](https://serpkite.com/docs/output-formats)[API keys

Crea una clave dedicada con un límite mensual.

](https://serpkite.com/docs/api-keys)