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: SerpApi MCP Server

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

Clonar el repositorio:

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

Instalar dependencias:

npm install

Instalar el navegador Playwright:

npm run install-browser

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.