Servidor MCP de búsqueda web

Un servidor MCP que proporciona capacidades de búsqueda de Google y visualización de contenido web con prevención avanzada de detección de bots.

Características

• Búsqueda personalizada de Google con filtrado avanzado

• Visualización de contenido web con conversión de Markdown

• Limitación de velocidad y almacenamiento en caché

• Agrupación de instancias del navegador

• Prevención de la detección de bots mediante rebrowser-puppeteer

Prerrequisitos

• Tiempo de ejecución de Bun v1.0 o superior

• Credenciales de la API de Google (clave API e ID del motor de búsqueda)

Instalación

Configuración

Configuración de cookies

Para acceder al sitio de forma autenticada, deberá:

1. Instalar la extensión Get cookies.txt LOCALMENTE para Chrome

2. Visita los sitios en los que deseas autenticarte e inicia sesión

3. Utilice la extensión para exportar sus cookies en formato JSON

4. Guarde el archivo de cookies exportado en una ubicación segura

5. Establezca la variable de entorno BROWSER_COOKIES_PATH en la ruta absoluta de su archivo de cookies

Configuración del servidor MCP

Agregue la configuración del servidor a su archivo de configuración de MCP:

• Para Cline: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

• Para Claude Desktop:

  • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

Reemplace /ABSOLUTE/PATH/TO/web_search_mcp con la ruta absoluta a su directorio de servidor.

Configuración de registro

Las siguientes variables de entorno controlan el comportamiento del registro:

• LOG_LEVEL : Establece el nivel de registro (error, advertencia, información, depuración). Valor predeterminado: información.

• NO_COLOR : Desactiva la salida en color cuando se establece en "1"

• BUN_FORCE_COLOR : Controla la salida de color en el tiempo de ejecución de Bun (establezca en "0" para deshabilitarla)

• FORCE_COLOR : Controla la salida de color globalmente (establezca en "0" para deshabilitarla)

Prevención de detección de bots

Este servidor utiliza rebrowser-puppeteer para evitar la detección de bots:

1. Tiempo de ejecución.Habilitar prevención de fugas:

   • Utiliza la técnica addBinding para evitar la detección de Runtime.Enable

   • Funciona con trabajadores web e iframes

   • Mantiene el acceso al contexto mundial principal

2. Enmascaramiento de URL de origen:

   • Cambia la URL de origen de Puppeteer para que parezca un script legítimo

   • Ayuda a evitar la detección de herramientas de automatización.

3. Nombre del mundo de utilidad:

   • Utiliza un nombre de mundo de utilidad genérico

   • Previene la detección a través de patrones de nombres mundiales

4. Configuración de inicio del navegador:

   • Desactiva las banderas de automatización

   • Utiliza argumentos optimizados de Chrome

   • Configura la ventana gráfica y los ajustes de la ventana

Uso con Claude Desktop

1. Asegúrate de tener Claude Desktop instalado y actualizado a la última versión

2. Abra el archivo de configuración de Claude Desktop:

   • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

3. Agregue la configuración del servidor como se muestra en la sección Configuración anterior.

4. Reiniciar Claude Desktop

5. Busque el icono del martillo Para confirmar que las herramientas están disponibles

Herramientas disponibles

1. Herramienta de búsqueda

2. Herramienta Ver URL

Solución de problemas

Problemas de integración de Claude Desktop

1. Revisar los registros:

   # MacOS/Linux tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log

2. Problemas comunes:

   • El servidor no aparece: Verifique la sintaxis y las rutas del archivo de configuración

   • Las llamadas a herramientas fallan: Verifique los registros del servidor y reinicie Claude Desktop

   • Problemas de ruta: asegúrese de utilizar rutas absolutas

Para obtener una solución de problemas más detallada, consulte la guía de depuración de MCP .

Desarrollo

Notas importantes

1. Detección de bots:

   • Las funciones para evitar la detección de bots ayudan a prevenir los métodos de detección más comunes.

   • Sin embargo, pueden ser necesarias medidas adicionales como servidores proxy y agentes de usuario adecuados.

   • Algunos sitios web aún pueden detectar la automatización a través de otros medios.

2. Actuación:

   • Las instancias del navegador se agrupan y reutilizan

   • Los navegadores inactivos se limpian automáticamente

   • Los límites de recursos evitan la sobrecarga

Licencia

Instituto Tecnológico de Massachusetts (MIT)