Web Researcher MCP

web-researcher-mcp

Tu asistente de investigación con IA que cita fuentes reales y se mantiene honesto.

Busca en toda la web o limítalo solo a los sitios en los que confías;
revistas médicas, bases de datos judiciales, medios de noticias, artículos académicos.
Analiza la fuente completa, no solo fragmentos. Enlaces que funcionan, citas en las que puedes confiar,
sin resultados pre-sintetizados inventados de jardines cerrados.

⭐ Si estás cansado de que la IA invente cosas, y web-researcher-mcp te ayuda, danos una estrella ⭐ — ayuda a que más equipos descubran el proyecto.

Comienza en 30 segundos

Usuarios de Python — uvx (sin compilar, cualquier sistema operativo):

# 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 obtiene el binario precompilado correcto para tu plataforma y lo ejecuta — sin Go, sin compilar, sin PATH manual. Apunta cualquier cliente MCP a uvx web-researcher-mcp. También funciona con uv tool install web-researcher-mcp o pip install web-researcher-mcp.

SDK de 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 "?")

Documentación completa: docs/PYTHON_CLIENT.md

Wrapper síncrono (para scripts y notebooks que no usan 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 (sin gestor de paquetes):

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"

No se necesitan herramientas de desarrollo — cada método incluye el mismo binario firmado (los wheels de PyPI lo incluyen; los demás lo descargan y verifican su checksum) y lo coloca en tu PATH. Los instaladores de curl/PowerShell también lo registran automáticamente con Claude Code cuando el CLI de claude está presente; Homebrew instala el binario, así que ejecuta la línea de claude mcp add de arriba para conectarlo.

Instalación con un clic:

Los botones de Cursor / VS Code / LM Studio instalan la configuración de uvx sin configuración (tu editor te pedirá confirmación antes de agregarla; necesita uv — ver arriba). Ejecuta búsqueda web de DuckDuckGo sin clave de API — ideal para probar al instante; image_search/news_search y proveedores más completos necesitan una clave (2 min, ver Configuración). Claude Desktop: descarga el paquete de .mcpb para tu plataforma y haz doble clic (Configuración → Extensiones), o usa la línea de uvx de arriba.

¿Usas un cliente MCP diferente o quieres pasar claves de API? Consulta Conecta a tu asistente de IA para la configuración por aplicación, y Configuración para elegir un proveedor de búsqueda.

Tu IA ahora puede buscar en la web, leer artículos completos, encontrar artículos académicos, consultar patentes y realizar investigaciones de varios pasos — solo de las fuentes que elijas.

¿Por qué existe esto?

Perplexity se equivoca en sus citas más de un tercio de las veces. Enlaza a artículos que no existen, inventa DOIs y presenta spam de SEO con la misma confianza que la investigación revisada por pares. La búsqueda web de ChatGPT no es mucho mejor — no puede distinguir una publicación de blog de un documento judicial.

Si tu trabajo se cita, se publica, se presenta ante un tribunal o se muestra a un cliente — no puedes permitirte fuentes "probablemente reales".

Esta herramienta corrige la causa raíz: en lugar de buscar en toda la web y esperar, le dices a tu IA exactamente qué fuentes buscar. A esto lo llamamos "lentes de búsqueda" — listas curadas de sitios confiables para cada campo.

Funciona con Claude, Claude Desktop, Cursor y cualquier asistente de IA que admita uso de herramientas.

Quién usa esto

• Investigadores académicos — "Necesito una revisión de literatura con DOIs reales, no citas inventadas"
• Analistas de negocios — "Mi entregable necesita fuentes que un cliente pueda hacer clic y verificar"
• Abogados — "Si cito un caso que no existe, me multan con $50,000"
• Periodistas — "Necesito verificar registros gubernamentales y presentaciones judiciales, no resúmenes de Perplexity"
• Investigadores médicos — "Decisiones clínicas basadas en un blog de salud podrían dañar a alguien"
• Estudiantes de posgrado — "Pasé 3 horas rastreando una cita que mi IA inventó"
• Equipos empresariales — "Nuestra investigación competitiva no puede pasar por los servidores de un tercero"

Cómo se compara

Cuándo usar qué

• Perplexity — Consultas rápidas e informales donde no necesitas citar tus fuentes
• Scite.ai / Elicit — Navegar una base de datos específica de artículos académicos
• web-researcher-mcp — Cualquier cosa donde tu reputación esté ligada a la investigación: trabajo de clientes, presentaciones judiciales, publicaciones, propuestas de subvenciones, decisiones médicas, periodismo
• Búsqueda integrada de Claude — Consultas rápidas y puntuales a mitad de conversación

Lo que tu IA puede hacer con esto

La mayoría de las herramientas anteriores están siempre disponibles. Algunas se activan solo cuando está presente el proveedor o la configuración correcta: citation_graph y research_panel requieren al menos un proveedor de respaldo configurado; filing_search requiere EDGAR_CONTACT_EMAIL; local_search requiere BRAVE_API_KEY. Los operadores también pueden habilitar herramientas opcionales con consentimiento (análisis por usuario, memoria a largo plazo, espacios de trabajo compartidos, monitoreo de consultas guardadas) que aparecen solo cuando su función está activada — consulta docs/TOOLS.md para la lista de herramientas autoritativa verificada por CI y los esquemas completos.

Plantillas de investigación listas para usar

El servidor también incluye plantillas de prompt guiadas que tu asistente de IA puede cargar con un clic — lo guían a través de un proceso probado de varios pasos para que no tengas que escribir cada instrucción:

En la mayoría de las aplicaciones de IA, estos aparecen donde eliges un prompt o el comando "/". El servidor expone recursos de estado en vivo (stats://tools, stats://sessions, stats://rate-limits, stats://providers), un catálogo de lentes (lenses://catalog), diagnósticos (diagnostics://errors/recent, diagnostics://health) y un almacén de artefactos de gran tamaño (research://artifact/{id}) para que tú — o tu IA — puedan verificar el uso, los límites y qué proveedores están activos. Consulta docs/DEPLOYMENT.md para la lista completa.

Inicio rápido

Opción 1: Homebrew (macOS / Linux — recomendado)

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

Homebrew gestiona la confianza, las actualizaciones y el PATH por ti — sin advertencias de firma.

Opción 2: Instalación con un comando (cualquier sistema operativo — sin necesidad de herramientas de desarrollo)

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"

Descarga el binario, verifica su suma de verificación SHA-256 contra la versión firmada, lo coloca en tu PATH y lo registra con Claude Code si está instalado. Personaliza la ubicación de instalación:

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

Conéctate a tu asistente de IA

El script de instalación se registra automáticamente con Claude Code. Para otras aplicaciones, añade a tu archivo de configuración de 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"
      }
    }
  }
}

Cualquier proveedor funciona — elige uno y establece su clave. Por ejemplo, Brave (sin necesidad de claves de Google):

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

Cambia a cualquier proveedor de la tabla de Configuración estableciendo SEARCH_PROVIDER y la clave de ese proveedor. Listo — tu asistente de IA ahora tiene acceso a todas las herramientas de investigación.

Configuración

No se requiere clave API. DuckDuckGo es el respaldo integrado de configuración cero — instala y listo. Para aumentar la calidad de los resultados y desbloquear la búsqueda de imágenes/noticias, añade cualquiera de los proveedores a continuación. Todos son opcionales e intercambiables — elige el que ya uses o prefieras; el servidor los trata por igual.

Proveedores de búsqueda

Establece SEARCH_PROVIDER=<name> y proporciona la clave de ese proveedor. Cada proveedor funciona con lentes de búsqueda, y cualquiera de ellos se puede combinar para conmutación por error automática (consulta Proveedores de búsqueda).

Cada proveedor tiene su propio nivel gratuito, flujo de registro y combinación de capacidades (imágenes, noticias, actualidad). Consulta docs/PROVIDERS.md para una comparación completa (clasificación de índices, matriz de capacidades, guía de selección rápida) y docs/API_SETUP.md para la configuración de claves paso a paso. Configura más de uno y el servidor conmuta por error automáticamente — consulta Proveedores de búsqueda.

Cuando SEARCH_PROVIDER no está establecido, el servidor usa Google si sus claves están presentes y, de lo contrario, recurre al proveedor DuckDuckGo de configuración cero — por lo que siempre funciona desde el primer momento, con o sin claves.

Búsqueda académica (Opcional — sin necesidad de registro)

Los proveedores de búsqueda académica (OpenAlex, CrossRef) aceptan un correo electrónico de contacto para desbloquear acceso más rápido a través del grupo de cortesía — sin registro, solo un correo. Consulta docs/API_SETUP.md para la configuración y docs/DEPLOYMENT.md para la referencia completa de variables.

Con estos establecidos, academic_search devuelve artículos reales con DOIs, autores, recuentos de citas y enlaces PDF de acceso abierto. Sin ellos, sigue funcionando pero usa la búsqueda web como respaldo.

Búsqueda de patentes (Opcional)

Los proveedores de patentes (EPO, USPTO, The Lens) requieren claves API para datos estructurados de patentes. Consulta docs/API_SETUP.md para la configuración paso a paso y docs/DEPLOYMENT.md para la referencia completa de variables.

Con estas, patent_search devuelve datos estructurados de patentes con códigos de clasificación, fechas e inventores. Sin ellas, recurre a la búsqueda web.

Bajo el Capó

Proveedores de Búsqueda

Tú eliges qué motor de búsqueda impulsa tu investigación. Todos funcionan con lentes.

Múltiples Proveedores (recomendado)

Configura múltiples motores de búsqueda para que si uno tiene problemas, tu investigación no se detenga:

export SEARCH_ROUTING=brave,google,serper

Si Brave está caído, automáticamente prueba Google. Si Google está limitado por tasa, pasa a Serper. Tu investigación simplemente funciona.

Consulta docs/PROVIDERS.md para una comparación completa de proveedores (clasificación de índices, capacidades, niveles gratuitos) y docs/DEPLOYMENT.md para opciones de enrutamiento avanzadas (enrutamiento por tema, proveedores específicos de patentes, etc.).

Proveedor Único

Si solo tienes una clave API de búsqueda, eso también funciona — solo configúrala y listo.

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 Búsqueda

Las lentes de búsqueda te permiten controlar qué sitios web tu IA puede buscar. En lugar de buscar en toda la web (y obtener blogs, spam y basura generada por IA), una lente restringe los resultados solo a las fuentes en las que confías para ese tema.

Lentes Integradas

También puedes crear tus propias lentes para cualquier campo — solo lista los dominios en los que confías.

Cómo funciona

Cuando tú (o tu IA) usas una lente, los resultados provienen solo de los sitios en esa lente. Por ejemplo, usar la lente medical significa que tu IA busca en PubMed, WHO, NIH y otras fuentes clínicas — nunca blogs de salud o anuncios de suplementos.

Tu IA usa lentes automáticamente cuando se lo pides. Por ejemplo: "Busca hallazgos recientes sobre inhibidores de SGLT2 usando la 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

Privacidad y Seguridad

Tus consultas de investigación van directamente desde tu máquina al proveedor de búsqueda que elegiste. Nunca pasan por nuestros servidores (no tenemos servidores). La herramienta se ejecuta completamente en tu computadora.

Configuración para Cada Aplicación de IA

Claude Code

Agrega a tu configuración MCP (~/.claude.json). Establece SEARCH_PROVIDER y la clave correspondiente para el proveedor que uses (consulta la tabla de Configuración) — este ejemplo usa 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

Agrega a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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

Agrega a .cursor/mcp.json en la raíz de tu proyecto:

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

Modo HTTP (Equipos / Servidor Compartido)

Para equipos que quieren una instancia compartida a la que todos se conecten:

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

Luego conecta cualquier aplicación 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: El comportamiento de la herramienta es idéntico en todos los modos de conexión (STDIO y HTTP). Las únicas diferencias son la autenticación (HTTP requiere OAuth) y los límites de tasa (HTTP aplica límites por inquilino; STDIO solo tiene cuotas de API ascendentes). Consulta docs/DEPLOYMENT.md para detalles.

Rendimiento

Las búsquedas regresan en menos de un segundo. Los resultados previamente vistos se almacenan en caché para que las repeticiones sean instantáneas. La extracción completa de artículos funciona en el 95%+ de la web — incluidos sitios que intentan bloquear bots. Los sitios con mucho JavaScript obtienen un navegador real detrás de escena (automático, sin configuración necesaria).

Desarrollo

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)

Las herramientas lint, gosec y govulncheck están fijadas como directivas de herramienta go.mod, por lo que make verify las ejecuta en las versiones exactas que usa CI (sin instalaciones globales necesarias). La protección de ramas requiere que las verificaciones Lint, Test, Security y E2E pasen.

Consulta CONTRIBUTING.md para el flujo de trabajo completo de desarrollo, guía de estilo de código y proceso de PR.

Solución 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

Contribuciones

Las contribuciones son bienvenidas. Consulta CONTRIBUTING.md para conocer las pautas de estilo de código, el flujo de trabajo de desarrollo y cómo enviar solicitudes de extracción.

Documentación

Licencia

MIT

Construido por Zohar Babin, con Go y el Model Context Protocol