Web Researcher MCP

web-researcher-mcp

Seu assistente de pesquisa com IA que cita fontes reais e permanece honesto.

Pesquise em toda a web ou restrinja apenas aos sites em que você confia;
periódicos médicos, bancos de dados judiciais, veículos de notícias, artigos acadêmicos.
Analise a fonte completa, não apenas trechos. Links que funcionam, citações em que você pode confiar,
sem resultados pré-sintetizados de jardim fechado inventados.

⭐ Se você está cansado de IA inventando coisas, e web-researcher-mcp ajuda você, dê uma estrela para nós ⭐ — isso ajuda mais equipes a descobrirem o projeto.

Comece em 30 segundos

Usuários de Python — uvx (sem compilação, qualquer sistema operacional):

# One-time: install uv (skip if you already have it)
curl -LsSf https://astral.sh/uv/install.sh | sh        # macOS/Linux  (Windows: winget install astral-sh.uv)

claude mcp add --scope user web-researcher -- uvx web-researcher-mcp

uv busca o binário pré-compilado correto para sua plataforma e o executa — sem Go, sem compilação, sem PATH manual. Aponte qualquer cliente MCP para uvx web-researcher-mcp. Também funciona com uv tool install web-researcher-mcp ou pip install web-researcher-mcp.

SDK Python

from web_researcher_mcp import WebResearcherClient

async with WebResearcherClient() as client:
    response = await client.web_search("CRISPR off-target effects 2024", num_results=5)
    for r in response.results:
        verified = await client.verify_citation(r.url)
        print(r.title, "—", "✓" if verified.exists else "?")

Documentação completa: docs/PYTHON_CLIENT.md

Wrapper síncrono (para scripts e notebooks que não usam async):

with WebResearcherClient.sync() as client:
    response = client.web_search("climate change 2024")
    print(response.results[0].title)

macOS (Homebrew):

brew install zoharbabin/tap/web-researcher-mcp
claude mcp add --scope user web-researcher -- web-researcher-mcp

macOS / Linux (sem gerenciador de pacotes):

curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex"

Nenhuma ferramenta de desenvolvimento necessária — cada método envia o mesmo binário assinado (as wheels do PyPI o incluem; os outros o baixam e verificam sua soma de verificação) e o coloca no seu PATH. Os instaladores curl/PowerShell também o registram automaticamente com o Claude Code quando a CLI claude está presente; o Homebrew instala o binário, então execute a linha claude mcp add acima para conectá-lo.

Instalação com um clique:

Os botões do Cursor / VS Code / LM Studio instalam a configuração uvx de zero configuração (seu editor solicita confirmação antes de adicioná-la; precisa de uv — veja acima). Ele executa pesquisa web DuckDuckGo sem chave de API — ótimo para testar instantaneamente; image_search/news_search e provedores mais ricos precisam de uma chave (2 min, veja Configuração). Claude Desktop: baixe o pacote .mcpb para sua plataforma e clique duas vezes nele (Configurações → Extensões), ou use a linha uvx acima.

Usando um cliente MCP diferente ou quer passar chaves de API? Veja Conecte ao Seu Assistente de IA para a configuração por aplicativo, e Configuração para escolher um provedor de busca.

Sua IA agora pode pesquisar na web, ler artigos completos, encontrar artigos acadêmicos, consultar patentes e executar pesquisas em várias etapas — apenas de fontes que você escolher.

Por que isso existe?

O Perplexity erra em suas citações mais de um terço das vezes. Ele vincula artigos que não existem, inventa DOIs e apresenta spam de SEO com a mesma confiança de pesquisas revisadas por pares. A busca web do ChatGPT não é muito melhor — não consegue distinguir um post de blog de um documento judicial.

Se o seu trabalho é citado, publicado, submetido a um tribunal ou mostrado a um cliente — você não pode se dar ao luxo de fontes "provavelmente reais".

Esta ferramenta corrige a causa raiz: em vez de pesquisar toda a web e torcer, você diz à sua IA exatamente quais fontes pesquisar. Chamamos isso de "lentes de busca" — listas curadas de sites confiáveis para cada área.

Funciona com Claude, Claude Desktop, Cursor e qualquer assistente de IA que suporte uso de ferramentas.

Quem usa isso

• Pesquisadores acadêmicos — "Preciso de uma revisão de literatura com DOIs reais, não citações inventadas"
• Analistas de negócios — "Meu entregável precisa de fontes que um cliente possa realmente clicar e verificar"
• Advogados — "Se eu citar um caso que não existe, sou multado em US$ 50.000"
• Jornalistas — "Preciso verificar registros governamentais e documentos judiciais, não resumos do Perplexity"
• Pesquisadores médicos — "Decisões clínicas baseadas em um blog de saúde podem prejudicar alguém"
• Estudantes de pós-graduação — "Passei 3 horas rastreando uma citação que minha IA inventou"
• Equipes empresariais — "Nossa pesquisa competitiva não pode passar pelos servidores de terceiros"

Como se Compara

Quando usar o quê

• Perplexity — Consultas rápidas e casuais onde você não precisa citar suas fontes
• Scite.ai / Elicit — Navegar em um banco de dados específico de artigos acadêmicos
• web-researcher-mcp — Qualquer coisa em que sua reputação esteja ligada à pesquisa: trabalho de cliente, documentos judiciais, publicações, propostas de bolsa, decisões médicas, jornalismo
• Busca integrada do Claude — Consultas rápidas e pontuais no meio da conversa

O que sua IA pode fazer com isso

A maioria das ferramentas acima está sempre disponível. Algumas são ativadas apenas quando o provedor ou a configuração correta está presente: citation_graph e research_panel exigem pelo menos um provedor de suporte configurado; filing_search exige EDGAR_CONTACT_EMAIL; local_search exige BRAVE_API_KEY. Operadores também podem ativar ferramentas opcionais com consentimento (análises por usuário, memória de longo prazo, espaços de trabalho compartilhados, monitoramento de consultas salvas) que aparecem apenas quando o recurso está ativado — veja docs/TOOLS.md para a lista de ferramentas autoritativa e verificada por CI e os esquemas completos.

Modelos de pesquisa prontos

O servidor também inclui modelos de prompt guiados que seu assistente de IA pode usar com um clique — eles o conduzem por um processo comprovado em várias etapas para que você não precise explicitar cada instrução:

Na maioria dos aplicativos de IA, eles aparecem onde você escolhe um prompt ou comando "/". O servidor expõe recursos de status ao vivo (stats://tools, stats://sessions, stats://rate-limits, stats://providers), um catálogo de lentes (lenses://catalog), diagnósticos (diagnostics://errors/recent, diagnostics://health) e um armazenamento de artefatos de grande carga útil (research://artifact/{id}) para que você — ou sua IA — possa verificar uso, limites e quais provedores estão ativos. Veja docs/DEPLOYMENT.md para a lista completa.

Início Rápido

Opção 1: Homebrew (macOS / Linux — recomendado)

brew install zoharbabin/tap/web-researcher-mcp
claude mcp add --scope user web-researcher -- web-researcher-mcp

O Homebrew cuida de confiança, atualizações e PATH para você — sem avisos de assinatura.

Opção 2: Instalação com um comando (qualquer SO — sem necessidade de ferramentas de desenvolvimento)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex"

Baixa o binário, verifica sua soma de verificação SHA-256 contra o release assinado, coloca-o no seu PATH e o registra com o Claude Code se instalado. Personalize o local de instalação:

INSTALL_DIR=/opt/tools curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

# Using any AUR helper (yay, paru, etc.)
yay -S web-researcher-mcp

# Run without installing
nix run github:zoharbabin/web-researcher-mcp

# Add to your flake inputs
nix profile install github:zoharbabin/web-researcher-mcp

{
  "mcpServers": {
    "web-researcher": {
      "command": "uvx",
      "args": ["web-researcher-mcp"]
    }
  }
}

winget install zoharbabin.web-researcher-mcp

scoop bucket add zoharbabin https://github.com/zoharbabin/scoop-bucket
scoop install web-researcher-mcp

choco install web-researcher-mcp

brew install --cask zoharbabin/tap/web-researcher-mcp

go install github.com/zoharbabin/web-researcher-mcp/cmd/web-researcher-mcp@latest
claude mcp add --scope user web-researcher -- web-researcher-mcp

# STDIO mode needs -i so the container's stdin stays attached for MCP JSON-RPC
docker run -i --rm \
           -e GOOGLE_CUSTOM_SEARCH_API_KEY=YOUR_KEY \
           -e GOOGLE_CUSTOM_SEARCH_ID=YOUR_CX \
           docker.io/zoharbabin/web-researcher-mcp:latest

git clone https://github.com/zoharbabin/web-researcher-mcp.git
cd web-researcher-mcp
go build -o web-researcher-mcp ./cmd/web-researcher-mcp

Conecte ao Seu Assistente de IA

O script de instalação registra com o Claude Code automaticamente. Para outros aplicativos, adicione ao arquivo de configuração da sua IA:

{
  "mcpServers": {
    "web-researcher": {
      "command": "web-researcher-mcp",
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "YOUR_GOOGLE_API_KEY",
        "GOOGLE_CUSTOM_SEARCH_ID": "YOUR_SEARCH_ENGINE_ID"
      }
    }
  }
}

Qualquer provedor funciona — escolha um e defina sua chave. Por exemplo, Brave (sem necessidade de chaves do Google):

{
  "mcpServers": {
    "web-researcher": {
      "command": "web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "brave",
        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY"
      }
    }
  }
}

Troque por qualquer provedor da tabela Configuração definindo SEARCH_PROVIDER e a chave desse provedor. Pronto — seu assistente de IA agora tem acesso a todas as ferramentas de pesquisa.

Configuração

Nenhuma chave de API necessária. DuckDuckGo é o fallback integrado de configuração zero — instale e use. Para aumentar a qualidade dos resultados e desbloquear a pesquisa de imagens/notícias, adicione qualquer um dos provedores abaixo. Todos são opcionais e intercambiáveis — escolha o que você já usa ou prefere; o servidor os trata igualmente.

Provedores de pesquisa

Defina SEARCH_PROVIDER=<name> e forneça a chave desse provedor. Todo provedor funciona com lentes de pesquisa, e qualquer um deles pode ser combinado para failover automático (veja Provedores de Pesquisa).

Cada provedor tem seu próprio nível gratuito, fluxo de inscrição e combinação de recursos (imagens, notícias, atualidade). Veja docs/PROVIDERS.md para uma comparação completa (classificação de índice, matriz de recursos, guia de escolha rápida) e docs/API_SETUP.md para configuração passo a passo das chaves. Configure mais de um e o servidor fará failover automaticamente — veja Provedores de Pesquisa.

Quando SEARCH_PROVIDER não está definido, o servidor usa o Google se suas chaves estiverem presentes e, caso contrário, recorre ao provedor DuckDuckGo de configuração zero — então sempre funciona de fábrica, com ou sem chaves.

Pesquisa Acadêmica (Opcional — sem necessidade de inscrição)

Provedores de pesquisa acadêmica (OpenAlex, CrossRef) aceitam um e-mail de contato para desbloquear acesso mais rápido via pool educado — sem registro, apenas um e-mail. Veja docs/API_SETUP.md para configuração e docs/DEPLOYMENT.md para a referência completa de variáveis.

Com estes definidos, academic_search retorna artigos reais com DOIs, autores, contagens de citações e links de PDF de acesso aberto. Sem eles, ainda funciona, mas usa pesquisa web como fallback.

Pesquisa de Patentes (Opcional)

Patent providers (EPO, USPTO, The Lens) exigem chaves de API para dados estruturados de patentes. Consulte docs/API_SETUP.md para configuração passo a passo e docs/DEPLOYMENT.md para a referência completa de variáveis.

Com elas, patent_search retorna dados estruturados de patentes com códigos de classificação, datas e inventores. Sem elas, ele recorre à pesquisa na web.

Por Dentro do Funcionamento

Provedores de Pesquisa

Você escolhe qual mecanismo de busca alimenta sua pesquisa. Todos funcionam com lentes.

Múltiplos Provedores (recomendado)

Configure vários mecanismos de busca para que, se um tiver problemas, sua pesquisa não pare:

export SEARCH_ROUTING=brave,google,serper

Se o Brave estiver fora do ar, ele tenta automaticamente o Google. Se o Google estiver com limite de taxa, ele recorre ao Serper. Sua pesquisa simplesmente funciona.

Consulte docs/PROVIDERS.md para uma comparação completa de provedores (classificação de índice, capacidades, camadas gratuitas) e docs/DEPLOYMENT.md para opções avançadas de roteamento (roteamento por tópico, provedores específicos de patentes, etc.).

Provedor Único

Se você tiver apenas uma chave de API de busca, isso também funciona — basta configurá-la e pronto.

export SEARCH_ROUTING=brave,google,serper
export BRAVE_API_KEY=BSAxxxxxxxxxx
export GOOGLE_CUSTOM_SEARCH_API_KEY=AIza...
export GOOGLE_CUSTOM_SEARCH_ID=017...
export SERPER_API_KEY=...

export SEARCH_PROVIDER=brave
export BRAVE_API_KEY=BSAxxxxxxxxxx

export SEARCH_PROVIDER=searxng
export SEARXNG_URL=http://localhost:8080

export SEARCH_PROVIDER=exa
export EXA_API_KEY=...

export SEARCH_PROVIDER=google
export GOOGLE_CUSTOM_SEARCH_API_KEY=AIza...
export GOOGLE_CUSTOM_SEARCH_ID=017...

Lentes de Busca

As lentes de busca permitem que você controle quais sites sua IA pode pesquisar. Em vez de buscar em toda a web (e obter blogs, spam e conteúdo gerado por IA), uma lente restringe os resultados apenas às fontes em que você confia para aquele tópico.

Lentes Integradas

Você também pode criar suas próprias lentes para qualquer área — basta listar os domínios em que confia.

Como funciona

Quando você (ou sua IA) usa uma lente, os resultados vêm apenas dos sites dessa lente. Por exemplo, usar a lente medical significa que sua IA pesquisa PubMed, WHO, NIH e outras fontes clínicas — nunca blogs de saúde ou anúncios de suplementos.

Sua IA usa lentes automaticamente quando você pede. Por exemplo: "Pesquise descobertas recentes sobre inibidores de SGLT2 usando a lente clínica."

{
  "name": "my-industry",
  "description": "Only searches sources I trust for my field",
  "domains": [
    "trusted-source.com",
    "industry-journal.org",
    "official-database.gov"
  ],
  "cx": "",
  "routing": ""
}

export CUSTOM_LENSES_PATH=/path/to/my-lenses

Privacidade e Segurança

Suas consultas de pesquisa vão diretamente da sua máquina para o provedor de busca escolhido. Elas nunca passam pelos nossos servidores (não temos servidores). A ferramenta roda inteiramente no seu computador.

Configuração para Cada Aplicativo de IA

Claude Code

Adicione à sua configuração MCP (~/.claude.json). Defina SEARCH_PROVIDER e a chave correspondente para o provedor que você usar (veja a tabela Configuração) — este exemplo usa o Google:

{
  "mcpServers": {
    "web-researcher": {
      "command": "/path/to/web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "google",
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "AIza...",
        "GOOGLE_CUSTOM_SEARCH_ID": "017..."
      }
    }
  }
}

Claude Desktop

Adicione a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "web-researcher": {
      "command": "/path/to/web-researcher-mcp",
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "AIza...",
        "GOOGLE_CUSTOM_SEARCH_ID": "017..."
      }
    }
  }
}

Cursor

Adicione a .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "web-researcher": {
      "command": "/path/to/web-researcher-mcp",
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "AIza...",
        "GOOGLE_CUSTOM_SEARCH_ID": "017..."
      }
    }
  }
}

Modo HTTP (Equipes / Servidor Compartilhado)

Para equipes que querem uma instância compartilhada à qual todos se conectam:

PORT=3000 \
OAUTH_ISSUER_URL=https://auth.example.com \
OAUTH_AUDIENCE=https://api.example.com \
./web-researcher-mcp

Depois, conecte qualquer aplicativo de IA a http://localhost:3000/mcp/.

services:
  web-researcher:
    image: zoharbabin/web-researcher-mcp
    ports:
      - "3000:3000"
    environment:
      PORT: "3000"
      SEARCH_PROVIDER: brave
      BRAVE_API_KEY: ${BRAVE_API_KEY}

Nota: O comportamento da ferramenta é idêntico em todos os modos de conexão (STDIO e HTTP). As únicas diferenças são autenticação (HTTP requer OAuth) e limite de taxa (HTTP impõe limites por locatário; STDIO tem apenas cotas de API upstream). Consulte docs/DEPLOYMENT.md para detalhes.

Desempenho

As buscas retornam em menos de um segundo. Resultados já vistos são armazenados em cache, então repetições são instantâneas. A extração completa de artigos funciona em 95%+ da web — incluindo sites que tentam bloquear bots. Sites com muito JavaScript recebem um navegador real nos bastidores (automático, sem necessidade de configuração).

Desenvolvimento

go build -o web-researcher-mcp ./cmd/web-researcher-mcp   # Build
go test -race ./...                                        # Test (with race detector)
make verify                                                # Full CI gate (see Makefile for steps)

As ferramentas lint, gosec e govulncheck são fixadas como diretivas de ferramenta go.mod, então make verify as executa nas versões exatas que o CI usa (sem necessidade de instalações globais). A proteção de branch exige que as verificações Lint, Test, Security e E2E passem.

Consulte CONTRIBUTING.md para o fluxo de trabalho completo de desenvolvimento, guia de estilo de código e processo de PR.

Solução de Problemas

rm -f /path/to/web-researcher-mcp
cp /path/to/new-build /path/to/web-researcher-mcp
codesign --force -s - /path/to/web-researcher-mcp   # ad-hoc re-sign

Contribuindo

Contribuições são bem-vindas. Consulte CONTRIBUTING.md para diretrizes de estilo de código, fluxo de trabalho de desenvolvimento e como enviar pull requests.

Documentação

Licença

MIT

Construído por Zohar Babin, com Go e o Model Context Protocol