G-Search MCP

MIT License
569
40
  • Apple

Integrations

  • Enables parallel searching with multiple keywords simultaneously on Google, returning structured search results with configurable parameters for result limits, timeout settings, and locale preferences.

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:

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
  1. Instalar dependencias:
npm install
  1. Instalar el navegador Playwright:
npm run install-browser
  1. 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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

Un potente servidor MCP que permite realizar búsquedas paralelas en Google con múltiples palabras clave simultáneamente, proporcionando resultados estructurados mientras maneja CAPTCHAs y simula patrones de navegación del usuario.

  1. Advantages
    1. Quick Start
      1. Debug Mode
    2. Configure MCP
      1. Features
        1. Usage Tips
          1. Handling Special Website Scenarios
          2. Debugging and Troubleshooting
        2. Installation
          1. Prerequisites
          2. Install from Source
        3. Development
          1. Auto Rebuild (Development Mode)
          2. Using MCP Inspector for Debugging
        4. Related Projects
          1. License
            ID: 07rhdtzqgv