G-Search MCP

Un servidor de búsqueda de Google que utiliza Playwright para búsquedas paralelas de palabras clave.

Documentación

G-Search MCP

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

Este proyecto está modificado a partir de google-search.

🌟 Recomendado: OllaMan - Potente administrador de modelos de IA Ollama.

Ventajas

Búsqueda en paralelo: Admite búsquedas con múltiples palabras clave en Google simultáneamente, mejorando la eficiencia de búsqueda
Optimización del navegador: Abre múltiples pestañas en una sola instancia del navegador para una búsqueda paralela eficiente
Manejo automático de verificación: Detecta CAPTCHA de forma inteligente y habilita el modo de navegador visible para la verificación del usuario cuando sea necesario
Simulación de comportamiento del usuario: Simula patrones de navegación 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 el procesamiento y análisis
Parámetros configurables: Admite varias configuraciones de parámetros como límites de resultados de búsqueda, tiempos de espera, configuraciones de idioma, etc.

Inicio rápido

Ejecute directamente con npx:

npx -y g-search-mcp

Configuración inicial: instale el navegador requerido ejecutando el siguiente comando en su terminal:

npx playwright install chromium

Modo de depuración

Use 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 - Ejecuta búsquedas en Google con múltiples palabras clave y devuelve 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 página en milisegundos, el valor predeterminado es 60000 (60 segundos)
  - noSaveState: Si evitar guardar el estado del navegador, el valor predeterminado es falso
  - locale: Configuración de idioma para los resultados de búsqueda, el valor predeterminado es en-US
  - debug: Si habilitar el modo de depuración (mostrando la ventana del navegador), anula el indicador --debug en la línea de comandos

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 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 parámetro limit: 20.
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 timeout a 120000 milisegundos.

Ajuste de la configuración de idioma

Cambiar la región de búsqueda: Especifique una configuración de idioma diferente:
```
Please use Chinese locale (zh-CN) for searching
```
Esto establecerá el parámetro locale: "zh-CN".

Depuración y resolución de problemas

Habilitar el modo de depuración

Activación dinámica de depuración: 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

Requisitos previos

Node.js 18 o superior
NPM o Yarn

Instalar desde el código fuente

Clone el repositorio:

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

Instale las dependencias:

npm install

Instale el navegador Playwright:

npm run install-browser

Compile el servidor:

npm run build

Desarrollo

Recompilación automática (modo de desarrollo)

npm run watch

Uso de MCP Inspector para depuración

npm run inspector

Proyectos relacionados

fetcher-mcp: Un potente servidor MCP para obtener contenido de páginas web utilizando el navegador headless de Playwright. Cuenta con extracción inteligente de contenido, procesamiento paralelo, optimización de recursos y más, lo que lo convierte en una herramienta ideal para el raspado de contenido web.

Licencia

Licenciado bajo la Licencia MIT