Serper Search and Scrape

Serper Search and Scrape MCP Server

Um servidor MCP baseado em TypeScript que fornece recursos de pesquisa na web e extração de conteúdo de páginas usando a API Serper. Este servidor se integra ao Claude Desktop para habilitar poderosas funcionalidades de pesquisa na web e extração de conteúdo.

Recursos

Ferramentas

• google_search - Realize pesquisas na web via API Serper

  • Resultados de pesquisa ricos, incluindo resultados orgânicos, grafo de conhecimento, "as pessoas também perguntam" e pesquisas relacionadas
  • Suporta segmentação por região e idioma
  • Parâmetros opcionais para localização, paginação, filtros de tempo e autocorreção
  • Suporta operadores de pesquisa avançados:
    • site: Limitar resultados a um domínio específico
    • filetype: Limitar a tipos de arquivo específicos (ex.: 'pdf', 'doc')
    • inurl: Pesquisar páginas com a palavra na URL
    • intitle: Pesquisar páginas com a palavra no título
    • related: Encontrar sites semelhantes
    • cache: Visualizar a versão em cache do Google de uma URL específica
    • before: Data anterior no formato YYYY-MM-DD
    • after: Data posterior no formato YYYY-MM-DD
    • exact: Correspondência exata de frase
    • exclude: Termos a excluir dos resultados de pesquisa
    • or: Termos alternativos (operador OR)

• scrape - Extrair conteúdo de páginas da web

  • Obter texto simples e conteúdo markdown opcional
  • Inclui JSON-LD e metadados do head
  • Preserva a estrutura do documento

Requisitos

• Node.js >= 18
• Chave da API Serper (definida como variável de ambiente SERPER_API_KEY)

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Execute os testes:

npm test                  # Run all tests
npm run test:watch       # Run tests in watch mode
npm run test:coverage    # Run tests with coverage
npm run test:integration # Run integration tests

Variáveis de Ambiente

Crie um arquivo .env no diretório raiz:

SERPER_API_KEY=your_api_key_here

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script de pacote:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.

Instalação

Instalação via Smithery

Para instalar o Serper Search and Scrape para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @marcopesani/mcp-server-serper --client claude

Claude Desktop

Adicione a configuração do servidor em:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "serper-search": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cline

1. Abra as configurações da extensão Cline
2. Abra a aba "MCP Servers"
3. Clique em "Configure MCP Servers"
4. Adicione a configuração do servidor:

{
  "mcpServers": {
    "github.com/marcopesani/mcp-server-serper": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": {
        "SERPER_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": ["google_search", "scrape"]
    }
  }
}

Opções adicionais de configuração do Cline:

• disabled: Defina como false para habilitar o servidor
• autoApprove: Lista de ferramentas que não exigem aprovação explícita para cada uso

Cursor

1. Abra as configurações do Cursor
2. Abra as configurações de "Features"
3. Na seção "MCP Servers", clique em "Add new MCP Server"
4. Escolha um nome e selecione "command" como "Type"
5. No campo "Command", insira o seguinte:

env SERPER_API_KEY=your_api_key_here npx -y serper-search-scrape-mcp-server

Docker

Você também pode executar o servidor usando Docker. Primeiro, construa a imagem:

docker build -t mcp-server-serper .

Em seguida, execute o contêiner com sua chave da API Serper:

docker run -e SERPER_API_KEY=your_api_key_here mcp-server-serper

Alternativamente, se você tiver suas variáveis de ambiente em um arquivo .env:

docker run --env-file .env mcp-server-serper

Para desenvolvimento, você pode querer montar seu código-fonte como um volume:

docker run -v $(pwd):/app --env-file .env mcp-server-serper

Nota: Certifique-se de substituir your_api_key_here pela sua chave real da API Serper.