G-Search MCP

Um servidor de busca do Google que utiliza Playwright para pesquisas paralelas de palavras-chave.

Documentação

G-Search MCP

Um poderoso servidor MCP para pesquisa do Google que permite busca paralela com múltiplas palavras-chave simultaneamente.

Este projeto é modificado a partir de google-search.

🌟 Recomendado: OllaMan - Poderoso gerenciador de modelos de IA Ollama.

Vantagens

Pesquisa Paralela: Suporta pesquisa com múltiplas palavras-chave no Google simultaneamente, melhorando a eficiência da busca
Otimização do Navegador: Abre múltiplas abas em uma única instância do navegador para pesquisa paralela eficiente
Tratamento Automático de Verificação: Detecta CAPTCHA de forma inteligente e ativa o modo visível do navegador para verificação do usuário quando necessário
Simulação de Comportamento do Usuário: Simula padrões reais de navegação para reduzir a possibilidade de detecção pelos mecanismos de busca
Dados Estruturados: Retorna resultados de pesquisa estruturados em formato JSON para fácil processamento e análise
Parâmetros Configuráveis: Suporta várias configurações de parâmetros, como limites de resultados de pesquisa, configurações de timeout, configurações de localidade, etc.

Início Rápido

Execute diretamente com npx:

npx -y g-search-mcp

Configuração inicial - instale o navegador necessário executando o seguinte comando no seu terminal:

npx playwright install chromium

Modo de Depuração

Use a opção --debug para executar em modo de depuração (mostrando a janela do navegador):

npx -y g-search-mcp --debug

Configurar MCP

Configure este servidor MCP no 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"]
    }
  }
}

Recursos

search - Executa pesquisas no Google com múltiplas palavras-chave e retorna os resultados
- Usa o navegador Playwright para realizar as pesquisas
- Suporta os seguintes parâmetros:
  - queries: Matriz de consultas de pesquisa a serem executadas (parâmetro obrigatório)
  - limit: Número máximo de resultados a retornar por consulta, padrão é 10
  - timeout: Tempo limite de carregamento da página em milissegundos, padrão é 60000 (60 segundos)
  - noSaveState: Se deve evitar salvar o estado do navegador, padrão é falso
  - locale: Configuração de localidade para os resultados da pesquisa, padrão é en-US
  - debug: Se deve habilitar o modo de depuração (mostrando a janela do navegador), substitui a flag --debug na linha de comando

Exemplo de uso:

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

Exemplo de resposta:

{
  "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."
        },
        ...
      ]
    }
  ]
}

Dicas de Uso

Lidando com Cenários Especiais de Sites

Ajustando Parâmetros de Pesquisa

Quantidade de Resultados de Pesquisa: Para mais resultados de pesquisa:
```
Please return the top 20 search results for each keyword
```
Isso definirá o parâmetro limit: 20.
Aumentar o Tempo Limite: Para situações de carregamento lento:
```
Please set the page loading timeout to 120 seconds
```
Isso ajustará o parâmetro timeout para 120000 milissegundos.

Ajuste de Configurações de Localidade

Alterar Região de Pesquisa: Especifique uma configuração de localidade diferente:
```
Please use Chinese locale (zh-CN) for searching
```
Isso definirá o parâmetro locale: "zh-CN".

Depuração e Solução de Problemas

Habilitar Modo de Depuração

Ativação Dinâmica da Depuração: Para exibir a janela do navegador durante uma operação de pesquisa específica:
```
Please enable debug mode for this search operation
```
Isso define debug: true mesmo que o servidor tenha sido iniciado sem a flag --debug.

Instalação

Pré-requisitos

Node.js 18 ou superior
NPM ou Yarn

Instalar a partir da Fonte

Clone o repositório:

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

Instale as dependências:

npm install

Instale o navegador Playwright:

npm run install-browser

Compile o servidor:

npm run build

Desenvolvimento

Recompilação Automática (Modo de Desenvolvimento)

npm run watch

Usando o MCP Inspector para Depuração

npm run inspector

Projetos Relacionados

fetcher-mcp: Um poderoso servidor MCP para buscar conteúdo de páginas web usando o navegador headless Playwright. Apresenta extração inteligente de conteúdo, processamento paralelo, otimização de recursos e muito mais, tornando-o uma ferramenta ideal para raspagem de conteúdo web.

Licença

Licenciado sob a Licença MIT