G-Search MCP

Un potente servidor MCP para la búsqueda de Google que permite realizar búsquedas paralelas con múltiples palabras clave simultáneamente.

Este proyecto es una modificación de la búsqueda de Google .

Ventajas

• Búsqueda paralela : admite la búsqueda con múltiples palabras clave en Google simultáneamente, lo que mejora la eficiencia de la búsqueda.

• Optimización del navegador : abre varias pestañas en una sola instancia del navegador para una búsqueda paralela eficiente

• Manejo automático de verificación : detecta de forma inteligente CAPTCHA y habilita el modo de navegador visible para la verificación del usuario cuando sea necesario

• Simulación del comportamiento del usuario : simula patrones de navegación de usuarios reales para reducir la posibilidad de detección por parte de los motores de búsqueda.

• Datos estructurados : devuelve resultados de búsqueda estructurados en formato JSON para facilitar su procesamiento y análisis.

• Parámetros configurables : admite varias configuraciones de parámetros, como límites de resultados de búsqueda, configuraciones de tiempo de espera, configuraciones regionales, etc.

Related MCP server: Enhanced Google Search MCP

Inicio rápido

Ejecutar directamente con npx:

npx -y g-search-mcp

Primera configuración: instale el navegador requerido ejecutando el siguiente comando en su terminal:

npx playwright install chromium

Modo de depuración

Utilice la opción --debug para ejecutar en modo de depuración (mostrando la ventana del navegador):

npx -y g-search-mcp --debug

Configurar MCP

Configure este servidor MCP en Claude Desktop:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "g-search": {
      "command": "npx",
      "args": ["-y", "g-search-mcp"]
    }
  }
}

Características

• search - Ejecutar búsquedas de Google con múltiples palabras clave y devolver resultados

  • Utiliza el navegador Playwright para realizar búsquedas

  • Admite los siguientes parámetros:

    • queries : Matriz de consultas de búsqueda a ejecutar (parámetro obligatorio)

    • limit : Número máximo de resultados a devolver por consulta, el valor predeterminado es 10

    • timeout : Tiempo de espera de carga de la página en milisegundos, el valor predeterminado es 60000 (60 segundos)

    • noSaveState : si se debe evitar guardar el estado del navegador, el valor predeterminado es falso

    • locale : configuración regional para los resultados de búsqueda, el valor predeterminado es en-US

    • debug : si se habilita el modo de depuración (mostrando la ventana del navegador), anula el indicador --debug en la línea de comando

Ejemplo de uso :

Use the search tool to search for "machine learning" and "artificial intelligence" on Google

Ejemplo de respuesta :

{
  "searches": [
    {
      "query": "machine learning",
      "results": [
        {
          "title": "What is Machine Learning? | IBM",
          "link": "https://www.ibm.com/topics/machine-learning",
          "snippet": "Machine learning is a branch of artificial intelligence (AI) and computer science which focuses on the use of data and algorithms to imitate the way that humans learn, gradually improving its accuracy."
        },
        ...
      ]
    },
    {
      "query": "artificial intelligence",
      "results": [
        {
          "title": "What is Artificial Intelligence (AI)? | IBM",
          "link": "https://www.ibm.com/topics/artificial-intelligence",
          "snippet": "Artificial intelligence leverages computers and machines to mimic the problem-solving and decision-making capabilities of the human mind."
        },
        ...
      ]
    }
  ]
}

Consejos de uso

Manejo de escenarios especiales de sitios web

Ajuste de los parámetros de búsqueda

• Cantidad de resultados de búsqueda : Para obtener más resultados de búsqueda:

  Please return the top 20 search results for each keyword

  Esto establecerá el limit: 20 parámetros.

• Aumentar la duración del tiempo de espera : para situaciones de carga lenta:

  Please set the page loading timeout to 120 seconds

  Esto ajustará el parámetro de timeout a 120000 milisegundos.

Ajuste de la configuración regional

• Cambiar región de búsqueda : especifique una configuración regional diferente:

  Please use Chinese locale (zh-CN) for searching

  Esto establecerá el parámetro locale: "zh-CN" .

Depuración y solución de problemas

Habilitar el modo de depuración

• Activación de depuración dinámica : para mostrar la ventana del navegador durante una operación de búsqueda específica:

  Please enable debug mode for this search operation

  Esto establece debug: true incluso si el servidor se inició sin el indicador --debug .

Instalación

Prerrequisitos

• Node.js 18 o superior

• NPM o Hilo

Instalar desde la fuente

1. Clonar el repositorio:

git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp

2. Instalar dependencias:

npm install

3. Instalar el navegador Playwright:

npm run install-browser

4. Construir el servidor:

npm run build

Desarrollo

Reconstrucción automática (modo de desarrollo)

npm run watch

Uso de MCP Inspector para la depuración

npm run inspector

Proyectos relacionados

• fetcher-mcp : Un potente servidor MCP para obtener contenido de páginas web mediante el navegador sin interfaz gráfica Playwright. Ofrece extracción inteligente de contenido, procesamiento paralelo, optimización de recursos y más, lo que lo convierte en una herramienta ideal para el scraping de contenido web.

Licencia

Con licencia MIT