MCP Web Research Server

Servidor MCP Web Research Server

Un servidor de Model Context Protocol (MCP) para investigación web.

Lleva información en tiempo real a Claude e investiga cualquier tema fácilmente.

Características

• Integración con Google Search --- ESTE FORK LO CORRIGE --- YA NO RECIBE BLOQUEOS DE CAPTCHA
• Extracción de contenido de páginas web
• Seguimiento de sesiones de investigación (lista de páginas visitadas, consultas de búsqueda, etc.)
• Captura de pantallas

Requisitos previos

• Node.js >= 18 (incluye npm y npx)
• Aplicación Claude Desktop

Instalación

Primero, asegúrate de haber descargado e instalado la aplicación Claude Desktop y de tener npm instalado.

A continuación, añade esta entrada a tu claude_desktop_config.json (en Mac, se encuentra en ~/Library/Application\ Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "webresearch": {
      "command": "npx",
      "args": ["-y", "@mzxrai/mcp-webresearch@latest"]
    }
  }
}

Esta configuración permite que Claude Desktop inicie automáticamente el servidor MCP de investigación web cuando sea necesario.

Uso

Simplemente inicia un chat con Claude y envía un mensaje que se beneficie de la investigación web. Si deseas un mensaje predefinido personalizado para una investigación web más profunda, puedes usar el mensaje agentic-research que proporcionamos a través de este paquete. Accede a ese mensaje en Claude Desktop haciendo clic en el icono del Clip en la entrada de chat y luego seleccionando Choose an integration → webresearch → agentic-research.

Herramientas

1. search_google

   • Realiza búsquedas en Google y extrae resultados
   • Argumentos: { query: string }

2. visit_page

   • Visita una página web y extrae su contenido
   • Argumentos: { url: string, takeScreenshot?: boolean }

3. take_screenshot

   • Toma una captura de pantalla de la página actual
   • No requiere argumentos

Mensajes

agentic-research

Un mensaje de investigación guiada que ayuda a Claude a realizar una investigación web exhaustiva. El mensaje instruye a Claude a:

• Comenzar con búsquedas amplias para comprender el panorama del tema
• Priorizar fuentes de alta calidad y autoridad
• Refinar iterativamente la dirección de la investigación según los hallazgos
• Mantenerte informado y permitirte guiar la investigación de forma interactiva
• Citar siempre las fuentes con URLs

Recursos

Exponemos dos cosas como recursos MCP: (1) capturas de pantalla de páginas web capturadas y (2) la sesión de investigación.

Capturas de pantalla

Cuando tomas una captura de pantalla, se guarda como un recurso MCP. Puedes acceder a las capturas de pantalla capturadas en Claude Desktop a través del icono del Clip.

Sesión de investigación

El servidor mantiene una sesión de investigación que incluye:

• Consultas de búsqueda
• Páginas visitadas
• Contenido extraído
• Capturas de pantalla
• Marcas de tiempo

Sugerencias

Para obtener los mejores resultados, si decides no usar el mensaje agentic-research al realizar tu investigación, puede ser útil sugerir fuentes de alta calidad para que Claude las use al investigar temas generales. Por ejemplo, podrías indicar news today from reuters or AP en lugar de news today.

Problemas

Este es código muy preliminar. Y también es AIGC, así que espera errores.

Si encuentras problemas, puede ser útil revisar los registros MCP de Claude Desktop:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Desarrollo

# Install dependencies
pnpm install

# Build the project
pnpm build

# Watch for changes
pnpm watch

# Run in development mode
pnpm dev

Requisitos

• Node.js >= 18
• Playwright (instalado automáticamente como dependencia)

Plataformas verificadas

• macOS
• Linux
• Windows

Licencia

MIT

Autor

mzxrai