Búsqueda de Google MCP

Servidor de Protocolo de Contexto de Modelo para la búsqueda de Google. Una herramienta de Protocolo de Contexto de Modelo (MCP) basada en Playwright que elude los mecanismos anti-bots de los motores de búsqueda, realiza búsquedas en Google y extrae resultados, proporcionando funciones de búsqueda en tiempo real para asistentes de IA como Claude y Cursor.

Características

• Anti-Bot Bypass : utiliza la suplantación de huellas dactilares del navegador y la simulación del comportamiento del usuario real para evitar la detección.
• Manejo automático de CAPTCHA : cambia al modo encabezado cuando encuentra CAPTCHA, lo que permite a los usuarios completar la verificación
• Persistencia del estado : guarda el estado de la sesión del navegador para reducir la necesidad de verificación repetida
• Adaptabilidad : utiliza múltiples combinaciones de selectores para adaptarse a los cambios en las páginas de búsqueda de Google
• Integración MCP : implementa el protocolo de contexto de modelo para una fácil integración con asistentes de IA
• Compatibilidad con varios idiomas : admite resultados de búsqueda en diferentes idiomas y regiones.

Uso con cursor

Instalación - Globalmente

Ejecute el servidor MCP usando npx:

En su IDE de cursor

1. Vaya a Cursor Settings > MCP
2. Haga clic en + Add New MCP Server
3. Rellene el formulario:
   • Nombre: google-search (o cualquier nombre que prefieras)
   • Tipo: command
   • Comando: npx -y @mcp-server/google-search-mcp@latest

Instalación - Específica del proyecto

Agregue un archivo .cursor/mcp.json a su proyecto:

Desarrollo

Construir el proyecto

Uso

Ejecutándose como un servidor MCP

Uso con MCP Inspector

Para depurar el servidor, puede utilizar el Inspector MCP :

Parámetros

La herramienta de búsqueda acepta los siguientes parámetros:

• query (obligatoria): cadena de consulta de búsqueda
• limit (opcional): Número de resultados de búsqueda a devolver, el valor predeterminado es 10
• timeout (opcional): tiempo de espera de la operación de búsqueda en milisegundos, el valor predeterminado es 60000
• language (opcional): idioma para los resultados de búsqueda, p. ej., zh-CN, en-US, el valor predeterminado es zh-CN
• region (opcional): región para los resultados de búsqueda, por ejemplo, cn, com, co.jp, el valor predeterminado es cn

Cómo funciona

1. La herramienta utiliza Playwright para controlar un navegador Chromium para realizar búsquedas en Google
2. Evita la detección de bots mediante la suplantación de huellas dactilares del navegador y la simulación del comportamiento del usuario real.
3. Al encontrarse con la verificación CAPTCHA, cambia automáticamente al modo encabezado para que el usuario la complete.
4. Extrae resultados de búsqueda y los devuelve en un formato estructurado.
5. Guarda el estado del navegador para reutilizarlo en búsquedas posteriores.

Configuración avanzada

Archivo de estado del navegador

De forma predeterminada, el estado del navegador se guarda en el archivo .google-search-browser-state.json ubicado en el directorio de inicio del usuario. Puede modificar esta ruta mediante parámetros.

Configuración de idioma y región

Puede especificar el idioma y la región para los resultados de búsqueda a través de parámetros:

Notas

• En el primer uso, si encuentra una verificación CAPTCHA, el sistema cambiará automáticamente al modo encabezado para que complete la verificación.
• Después de la verificación, el sistema guardará el archivo de estado, lo que hará que las búsquedas posteriores sean más fluidas.
• Las solicitudes de búsqueda demasiado frecuentes pueden activar los mecanismos de limitación de velocidad de Google
• Esta herramienta es solo para fines de aprendizaje e investigación; cumpla con los términos de servicio de Google.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Descargo de responsabilidad

Esta herramienta es solo para fines de aprendizaje e investigación. Al usarla para acceder a Google u otros motores de búsqueda, cumpla con los términos de servicio y la normativa legal vigente. El autor no se responsabiliza de ningún problema derivado del uso de esta herramienta.