agent-web-search
Servidor MCP y CLI para búsqueda web nativa de agentes de IA. Agrega capacidades de grounding de modelos y APIs de búsqueda orientadas a agentes (Exa, Parallel) junto con un backend convencional (DDGS). Soporta Claude Code, Codex CLI y Python sin telemetría.
Ficha actualizada 25 sept 2026, 4:48 · upstream 25 sept 2026, 4:47 · release v0.7.5
Qué es agent-web-search
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Agent Web Search es una herramienta open source diseñada para proporcionar capacidades de búsqueda web nativas a agentes de IA, diferenciándose de los metabuscadores tradicionales que solo agrupan resultados de Google o Bing. En lugar de devolver páginas de resultados estándar (SERP), ofrece dos interfaces: un servidor MCP para integración directa con agentes y una CLI con habilidades (Skills) para entornos de shell. El núcleo es neutral respecto al proveedor, permitiendo cambiar entre motores sin reconfigurar la lógica del agente.
- Integración en agentes de IA que requieren grounding web mediante modelos como ARK o Gemini para respuestas sintetizadas con citas.
- Búsqueda semántica y estructurada para RAG (Retrieval-Augmented Generation) utilizando APIs como Exa o Parallel sin necesidad de claves API iniciales.
- Uso con herramientas de desarrollo como Codex CLI, Claude Code o OpenCode para investigación contextual en tiempo real.
- Despliegue remoto seguro mediante transporte HTTP con autenticación por token para clientes MCP externos.
- Fallo tolerante: si un proveedor falla (ej. API pagada), los backends keyless como DDGS mantienen la funcionalidad básica.
- Soporte nativo para el protocolo MCP 2.x con transporte stdio y HTTP streamable.
- Tres proveedores por defecto sin claves API (DDGS, Exa, Parallel) garantizan funcionalidad inmediata.
- Arquitectura multi-proveedor independiente: el fallo de un proveedor no invalida los resultados de otros.
- Sin telemetría ni servicios compartidos de claves API; las credenciales se manejan en variables de entorno.
- Interfaz unificada para todos los backends mediante herramientas MCP y funciones Python normalizadas.
- Compatible con entornos aislados vía pipx o gestores de paquetes como uv.
- Los proveedores de grounding avanzado (ARK, Gemini, Grok) requieren claves API externas que no se gestionan internamente.
- DDGS es el único backend convencional; no devuelve resultados estructurados propios de Google/Bing para scraping estándar.
- Algunas integraciones como Codex Alpha están marcadas como experimentales y pueden requerir gateways específicos.
- Requiere Python 3.10 o superior para la instalación del paquete y el servidor MCP.
- No incluye orquestación de contenedores Docker por defecto (aunque tiene Dockerfile, no hay compose).
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar vía pipx o uvx para aislamiento. Configurar AGENT_WEB_SEARCH_AUTH_TOKEN (32+ caracteres) para despliegues HTTP remotos. Variables de entorno específicas por proveedor deben establecerse antes de iniciar el servidor MCP. Para uso local, usar transporte stdio sin argumentos adicionales. Desplegar en Vercel/Railway requiere exportar la variable de autenticación en el entorno del servicio.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.