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.
Inicio rápido
Ejecutar directamente con npx:
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 10timeout : 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 falsolocale : configuración regional para los resultados de búsqueda, el valor predeterminado es en-USdebug : 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
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
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
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
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:
- Instalar el navegador Playwright:
- Construir el servidor:
Desarrollo
Reconstrucción automática (modo de desarrollo)
Uso de MCP Inspector para la depuración
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