HasData Google Search MCP Server

Servidor MCP de Búsqueda de Google (SERP)

Un servidor de Protocolo de Contexto de Modelo (MCP) alojado que brinda a Claude, Cursor, Windsurf y cualquier otro cliente MCP ocho herramientas de búsqueda de Google de solo lectura. Obtén el SERP en vivo con su Resumen de IA y la sección de Otras preguntas de los usuarios, ejecuta una consulta en el Modo IA de Google y lee resultados de noticias, compras, detalles de productos y videos cortos, todo como JSON estructurado, sin proyecto de Google Cloud ni configuración de motor de búsqueda.

https://mcp.hasdata.com/api/mcp?apis=google_serp

"SERP" y "Búsqueda de Google" son el mismo producto aquí. Este servidor devuelve páginas de resultados del motor de búsqueda de Google, analizadas.

Contenido

• Lo que necesitas
• Inicio rápido
• Ejemplos de indicaciones
• Herramientas
• Errores y rutas de fallo
• Precios, nivel gratuito y límites
• Selección de herramientas
• Cómo se compara
• Preguntas frecuentes
• Enlaces de HasData
• Desarrollo
• Contribuciones
• Licencia

Lo que necesitas

Un cliente MCP que admita HTTP transmisible con encabezados personalizados. Una clave de API de HasData desde el panel de control, gratuita de crear sin tarjeta, y la prueba cubre aproximadamente de 100 a 200 llamadas según la herramienta. Nada más. Este es un servidor remoto, por lo que la ruta más simple es una URL y un encabezado, sin proyecto de Google Cloud ni Motor de Búsqueda Programable que configurar. Un cliente solo-stdio puede usar el lanzador @hasdata/google-search-mcp (npm) o hasdata-google-search-mcp (PyPI) en su lugar.

Inicio rápido

La URL del servidor es la misma para cada cliente. Lo ejecutamos de forma práctica en Claude Code y Claude Desktop. Los otros bloques siguen el formato documentado de cada cliente para un servidor remoto.

Los clientes con soporte OAuth pueden agregar la misma URL como conector e iniciar sesión sin poner una clave en un archivo de configuración.

claude mcp add --transport http google-search "https://mcp.hasdata.com/api/mcp?apis=google_serp" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-search-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-search": {
      "command": "uvx",
      "args": ["hasdata-google-search-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-search": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-search": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-search": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "type": "streamableHttp",
      "headers": { "x-api-key": "HASDATA_API_KEY" },
      "disabled": false
    }
  }
}

{
  "servers": {
    "google-search": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-search": {
      "httpUrl": "https://mcp.hasdata.com/api/mcp?apis=google_serp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Ejemplos de indicaciones

Busca en Google best running shoes y dame los diez primeros resultados orgánicos más el Resumen de IA.

Una llamada, 10 créditos. La respuesta SERP incluye el Resumen de IA en línea junto con los resultados orgánicos.

Para la misma consulta, toma cada pregunta de Otras preguntas de los usuarios y extrae su respuesta del Resumen de IA con fuentes.

Una llamada por pregunta, 5 créditos cada una. Cada entrada de relatedQuestions contiene un aiOverview.pageToken, y la herramienta de Resumen de IA convierte ese token en los bloques de respuesta y sus referencias.

Pregunta al Modo IA de Google what is the Model Context Protocol y dame la respuesta con sus citas.

Una llamada, 10 créditos. El Modo IA devuelve la respuesta generada como bloques de texto con una lista de referencias.

Busca en Google Shopping nike air max, luego extrae la tarjeta completa del producto para el primer resultado: cada tienda que lo vende, el rango de precios y el desglose de reseñas.

Dos llamadas. Shopping cuesta 10 créditos y devuelve un token por producto, y la herramienta de producto inmersivo gasta 5 para expandir ese token en tiendas, variantes y reseñas.

Obtén las últimas noticias de Google para artificial intelligence, y por separado los resultados de videos cortos para cooking pasta.

Dos llamadas, 10 créditos cada una.

El flujo de trabajo se apoya en dos cadenas. Una respuesta SERP devuelve un aiOverview en línea y un pageToken en cada pregunta de Otras preguntas de los usuarios, por lo que extraer las respuestas generativas de Google es gratuito con la búsqueda o un seguimiento de 5 créditos por pregunta. Un resultado de shopping también devuelve un token por producto, por lo que el salto de un listado a su tarjeta completa de múltiples tiendas es una sola llamada.

Herramientas

Ocho herramientas, todas de solo lectura. Las muestras a continuación están recortadas de llamadas reales, y los resultados en ellas cambian a medida que Google cambia, así que léelas como formas. Cada nombre de herramienta enlaza a su referencia de endpoint.

Las muestras son el payload, no la respuesta completa. Un resultado de tools/call lleva un bloque de texto, y ese texto es en sí mismo JSON que contiene url, status, text y json, con los datos extraídos bajo json. Desde una respuesta JSON-RPC cruda, la ruta es result.content[0].text, analizada, luego .json. Un cliente de chat desenvuelve eso por ti, y el código que habla directamente con el endpoint no lo hace.

SERP de Google

hasdata_google_serp_serp_getSearchResults

La página completa de resultados para una consulta.

Devuelve searchInformation, organicResults, aiOverview, relatedQuestions, relatedSearches, perspectives, immersiveProducts y pagination, con los bloques que Google muestre para la consulta. Las entradas orgánicas llevan position, title, link, displayedLink, source, snippet, snippetHighlitedWords, date y images.

El Resumen de IA llega de dos maneras. Usualmente aiOverview está en línea, con textBlocks y references que puedes leer de inmediato. A veces Google lo protege detrás de un token, y entonces aiOverview lleva un pageToken y un hasdataLink en lugar de los bloques. Cada entrada de relatedQuestions también es ese segundo caso. Contiene un question y un aiOverview con el mismo pageToken y hasdataLink, que la herramienta de Resumen de IA a continuación expande. Así que las respuestas de Otras preguntas de los usuarios son Resúmenes de IA que obtienes un token a la vez. El aiOverview de nivel superior está en línea en la mayoría de las consultas y es un token en unas pocas, así que léelo de ambas maneras.

{
  "organicResults": [
    {
      "position": 1,
      "title": "The 15 Best Running Shoes of 2026",
      "link": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
      "source": "Runner's World",
      "snippet": "The Brooks Ghost is our No. 1 shoe when we recommend new trainers…"
    }
  ],
  "aiOverview": {
    "textBlocks": [ { "type": "paragraph", "snippet": "The best running shoes depend on your goal…" } ],
    "references": [ { "index": 0, "title": "7 Best Running Shoes in 2026 - RunRepeat", "link": "https://runrepeat.com/guides/best-running-shoes" } ]
  },
  "relatedQuestions": [
    { "question": "What are the top 5 best running shoes?", "aiOverview": { "pageToken": "eyJpZCI6…", "hasdataLink": "https://api.hasdata.com/scrape/google/ai-overview?pageToken=eyJpZCI6…" } }
  ],
  "pagination": { "next": "…" }
}

Resumen de IA de Google

hasdata_google_serp_ai_overview_getAiOverviewResponse

Expande un token de Resumen de IA en su respuesta.

Devuelve aiOverview con textBlocks y references. Así es como lees el Resumen de IA cuando el SERP te entregó un token en lugar de los bloques, y cómo conviertes cada pregunta de Otras preguntas de los usuarios en una respuesta citada.

Los tokens son válidos por aproximadamente 4 minutos. Uno caducado no regresa vacío, falla como un error de herramienta, isError: true con el texto HasData API error: 400 Bad Request. Manéjalo como manejarías una clave incorrecta, y vuelve a ejecutar el SERP para obtener un token nuevo.

{
  "aiOverview": {
    "textBlocks": [ { "type": "paragraph", "snippet": "The top five running shoes feature versatile options for daily training and racing…" } ],
    "references": [ { "index": 0, "title": "…", "link": "https://…" } ]
  }
}

Modo IA de Google

hasdata_google_serp_ai_mode_getAiModeResponse

La respuesta del Modo IA de Google para una consulta, el resultado de búsqueda conversacional.

Devuelve textBlocks y references, la respuesta generada y las fuentes que cita.

SERP Ligero de Google

hasdata_google_serp_serp_light_getSearchResults

Una búsqueda más económica que devuelve el núcleo de la página.

Devuelve organicResults, aiOverview, relatedSearches, filters, appliedLocation, searchInformation y pagination. Cuesta la mitad de los créditos del SERP completo, para cuando quieras resultados orgánicos y el Resumen de IA sin los bloques adicionales.

Noticias de Google

hasdata_google_serp_news_getGoogleNews

Los resultados de Noticias de Google para una consulta o una sección de noticias.

Devuelve newsResults, menuLinks, relatedTopics y relatedPublications. Cada entrada de noticias lleva position, title, link, source con un name y icon, thumbnail y date.

Shopping de Google

hasdata_google_serp_shopping_getSearchResults

Resultados de compras para una consulta.

Devuelve shoppingResults, filters, refineSearchFilters, searchInformation y pagination. Cada resultado lleva position, title, productId, price, extractedPrice, rating, reviews, source, category, thumbnail y un immersiveProductPageToken.

immersiveProductPageToken es la entrada para la herramienta de producto inmersivo a continuación. Es un token temporal, así que expándelo mientras esté fresco si quieres los datos del producto, y vuelve a ejecutar la llamada de compras para obtener uno nuevo si un token antiguo falla.

{
  "shoppingResults": [
    {
      "position": 1,
      "title": "Men's Nike Alphafly 3",
      "productId": "13366226642799457284",
      "price": "$285.00",
      "extractedPrice": 285,
      "rating": 4.5,
      "reviews": 120,
      "source": "Nike",
      "immersiveProductPageToken": "eyJyZHMiOiJQQ18…"
    }
  ]
}

Producto inmersivo

hasdata_google_serp_immersive_product_getImmersive_e29f691177

La tarjeta de producto completa detrás de un resultado de compras.

Devuelve un objeto productResults con title, brand, rating, reviews, priceRange, un array stores de cada vendedor con su precio y enlace, además de variants, reviewsImages, userReviews, topInsights, aboutTheProduct y discussionsAndForums. Esta es la única llamada que convierte un listado individual en la imagen completa entre tiendas.

{
  "productResults": {
    "title": "Men's Nike Alphafly 3",
    "brand": "Nike",
    "rating": 4.4,
    "reviews": 1077,
    "priceRange": "$221-$295",
    "stores": [ { "name": "eBay", "link": "https://www.ebay.com/itm/…", "price": "$221" } ],
    "storesNextPageToken": "Mw=="
  }
}

Introduce storesNextPageToken de nuevo como el parámetro nextPageToken para paginar a través de las tiendas.

Videos cortos de Google

hasdata_google_serp_short_videos_getShortVideosSearchResults

Los resultados de videos cortos que Google muestra para una consulta.

Devuelve shortVideos, cada uno con position, title, link, source, sourceLogo, profileName, duration, clip y thumbnail.

Errores y rutas de fallo

Tu cliente casi nunca ve un código de error HTTP de una llamada a herramienta. La capa MCP responde con 200 y coloca el fallo dentro del resultado, con isError establecido en true y el motivo como texto. El agente lee un mensaje donde podrías esperar una línea de estado.

Una clave incorrecta aparece como salida de herramienta, no como una conexión fallida. Las herramientas de listado aceptan cualquier clave no vacía, y el cliente completa su protocolo de enlace y muestra verde. La primera llamada a herramienta luego regresa con isError: true y el texto HasData API error: 401 Unauthorized. Presta atención a esa cadena, porque nada antes en el flujo informa del problema.

El único error HTTP real es una clave faltante. La autorización se ejecuta antes de cualquier herramienta, y la conexión en sí falla con 401.

Un argumento que rompe el esquema se rechaza antes de convertirse en una búsqueda. Una búsqueda sin q regresa con isError: true y el texto MCP error -32602: Input validation error, nombrando el campo. No se obtiene nada y no se cobra nada.

Un token de AI Overview obsoleto falla como error. Un token de respuesta SERP es válido durante unos 4 minutos. Expandir uno que guardaste antes regresa con isError: true y el texto HasData API error: 400 Bad Request, con la misma forma que una clave incorrecta. Captúralo y vuelve a ejecutar el SERP para obtener un token fresco.

Un bloque que Google no mostró está ausente, no vacío. Una consulta sin AI Overview, sin panel de compras o sin People Also Ask devuelve una respuesta sin esas claves en lugar de con claves vacías. Verifica la clave antes de leerla.

Los resultados que llevan datos también llevan un requestMetadata.id que vale la pena citar en soporte, además de enlaces html y json al artefacto almacenado de esa llamada exacta.

Precios, nivel gratuito y límites

Los créditos son por herramienta. El SERP completo, AI Mode, News, Shopping y videos cortos cuestan 10 créditos por llamada. SERP Light, producto inmersivo y la herramienta de AI Overview son 5. El AI Overview que viene integrado con una respuesta SERP es gratuito, parte de esa llamada de 10 créditos, pero expandir un token con la herramienta de AI Overview, incluido cada token de People Also Ask, es una llamada separada de 5 créditos. El tamaño de la respuesta no cambia el precio.

La prueba gratuita es de 1,000 créditos durante 30 días sin tarjeta, lo que equivale a 100 llamadas SERP completas o 200 de las llamadas de 5 créditos. Después de eso, una cuenta activa sigue recibiendo 100 créditos recargados cada día cuando su saldo baja de 100, por lo que un agente de bajo volumen funciona en el nivel gratuito indefinidamente.

Los planes de pago comienzan en $49 al mes por 200,000 créditos. El precio por crédito baja con el volumen, y los números actuales están en la página de precios.

Tu plan también establece la concurrencia. La prueba gratuita permite 1 solicitud a la vez, Startup 15, Business 30, Growth 50, y los planes de alto volumen van de 200 a 1,500. La concurrencia es el único límite. No hay un tope separado de solicitudes por minuto. Maneja el caso de desbordamiento de forma defensiva en cualquier cosa desatendida, porque un agente que se expande entre consultas alcanzará el techo antes que tú.

Selección de herramientas

?apis=google_serp expone estas ocho herramientas. El parámetro toma una lista, y ?apis=google_serp,google_maps añade las herramientas de Google Maps junto con la búsqueda. Omite el parámetro y obtienes todo lo que HasData expone, que actualmente son 57 herramientas.

Una lista reducida suele ser el mejor valor predeterminado. Un modelo que elige entre ocho herramientas acierta más a menudo que uno que elige entre cincuenta y siete, y las descripciones de las herramientas cuestan contexto en cada turno.

Cómo se compara

Google ya no ofrece una API de búsqueda general. La ruta oficial es la Custom Search JSON API, y responde a una pregunta diferente de esta.

La Custom Search JSON API busca en un Programmable Search Engine que configuras, sobre los sitios que listas o el índice web completo si lo activas. Está limitada a 100 consultas gratuitas al día y luego cobra por millar hasta un tope diario, y devuelve un conjunto de resultados reducido. No devuelve el AI Overview, People Also Ask, el paquete local, compras, noticias o videos cortos, porque esas son características de la página de resultados en vivo más que de la API. Es la herramienta adecuada cuando quieres buscar en tu propio sitio o en un conjunto fijo de sitios y mantenerte dentro de los términos oficiales de Google para eso.

Este servidor devuelve la página de resultados de Google en vivo tal como la ve un visitante, analizada. No hay nada que configurar, la consulta se ejecuta contra todo Google en lugar de un motor curado, y el AI Overview, People Also Ask, compras y el resto regresan como bloques estructurados.

Dos filas lo deciden. Si solo necesitas buscar tus propios sitios y quieres la API oficial de Google para eso, la Custom Search JSON API es la adecuada. Si necesitas el SERP real, su AI Overview, o cualquiera de los paneles que Google muestra a un buscador, la API oficial no los devuelve y esto sí.

Lo que este servidor no hace. Sin rastreo de las páginas detrás de los resultados, sin historial de clasificación, y nada que escriba. Devuelve la página de resultados analizada.

Preguntas frecuentes

¿Qué es un servidor MCP de Google Search?

Un servidor que expone los resultados de búsqueda de Google como herramientas que un cliente de IA puede llamar. El cliente envía una llamada de herramienta a través del Model Context Protocol, el servidor obtiene la página de resultados y devuelve JSON estructurado, y el modelo trabaja con el resultado y nunca ve una página de HTML. Este expone ocho herramientas de solo lectura y se ejecuta de forma remota, por lo que el cliente se conecta a una URL y no inicia ningún proceso local.

¿SERP es lo mismo que Google Search aquí?

Sí. Un SERP es una página de resultados del motor de búsqueda. Estas herramientas devuelven las páginas de resultados de Google, por lo que "API SERP" y "API de Google Search" significan lo mismo en este repositorio.

¿Hay un servidor MCP oficial de Google Search?

Google no publica un servidor MCP ni una API de búsqueda general. El producto oficial más cercano es la Custom Search JSON API, que busca en un Programmable Search Engine que configuras. Varios servidores MCP de la comunidad, incluido este, devuelven la página de resultados en vivo en su lugar.

¿Cómo obtengo el AI Overview?

Ejecuta una llamada SERP. El aiOverview suele estar integrado con su textBlocks y references. Cuando regresa como un pageToken en su lugar, y en cada pregunta de People Also Ask, pasa ese token a la herramienta de AI Overview para obtener la respuesta. Los tokens caducan rápidamente, así que expándelos desde una llamada reciente.

¿Necesito un proyecto de Google Cloud o un Programmable Search Engine?

No. La única credencial es tu clave de HasData. Nada que crear en Google Cloud, y sin cuota por API que gestionar.

¿La clave API caduca?

No. La clave no caduca. Rótala en el panel de control cuando lo necesites.

¿Los datos son en vivo o en caché?

En vivo. Cada llamada obtiene la página de resultados en el momento de la solicitud y lleva su propio requestMetadata.id. Dos llamadas idénticas son dos obtenciones separadas y no una reproducción de una copia almacenada.

¿Esto está afiliado con Google?

No. HasData es un servicio independiente y no está afiliado, respaldado ni patrocinado por Google. Google es una marca comercial de su respectivo propietario. Las herramientas trabajan solo con datos disponibles públicamente, y eres responsable de usar los resultados de acuerdo con los términos de Google y la ley que te aplica.

Enlaces de HasData

Desarrollo

Este repositorio es configuración y documentación para un servidor remoto. No hay paso de compilación ni nada que contenerizar.

Sí incluye una prueba de contrato. El README documenta ocho herramientas con parámetros específicos, y la lista de herramientas ascendente puede cambiar sin un commit aquí, lo que dejaría este archivo mintiéndote silenciosamente. La prueba afirma que las herramientas documentadas existen con los parámetros declarados, y se ejecuta semanalmente en CI además de en cada push.

HASDATA_API_KEY=your_key_here npm test

En PowerShell:

$env:HASDATA_API_KEY = "your_key_here"; npm test

La última verificación hace una búsqueda real y cuesta 10 créditos, que es el precio de un canario que puede fallar por la razón correcta. Listar herramientas tiene éxito con cualquier clave no vacía, por lo que una prueba que solo lista herramientas permanece verde con una revocada.

Contribuciones

Las correcciones a las tablas de herramientas y las muestras de respuesta son la contribución más útil, porque esas son las partes que se desvían. Incluye la llamada que hiciste y la respuesta que obtuviste. Las solicitudes de extracción de forks ejecutan el conjunto sin clave, y las verificaciones en vivo se omiten en lugar de ponerse rojas.

Licencia

MIT. Ver LICENCIA.